Instruction/ maintenance manual of the product CDI5UG1107 IBM
Go to page of 178
IBM Sterling Connect:Direct for i5/OS User’s Guide Version 3.7.
CDI5UG1107 Copyright This edition applies to the 3.7 Version of IBM Sterling Connect:Direct for i5/OS and to all subsequent releas es and modificatio ns until otherwise indicate d in new editions. Before using this information and the prod uct it supports, read the information in Notices on page 159.
Contents Chapter 1 About Sterling Connect:Direct for i5/OS Issuing Sterling Connect:Direct CL Commands ..... ........... .............. ................. ............ 7 Issuing CL Commands Through the Main Menu ............ ................. .........
4 IBM Sterling Connect:Direct for i5/OS User’s Guide CDRCV Command Format ............. .............. ... ... .............. ... .............. ... .............. ... ........ 47 Required Parameters ................ ... ................. ..........
5 Chapter 10 Controlling Processes CDSUBPROC Command Example ................ ........... ...... .............. ... .............. ... ............ 124 CDSUBPROC Command Format .... ................. ................. ................. .............. .
6 IBM Sterling Connect:Direct for i5/OS User’s Guide i5/OS Send and Receive Examples Using Native File System .... ............................. ..... 152 i5/OS Send and Receive Examples Using Integrated Fi le System ............. .............. ...
Chapter 1 About Sterling Connect:Direct for i5/OS IBM ® Sterling Connect:Direct ® for i5/OS ® is an enterp rise solution for secure, automat ed file delivery between business applications. Its session managem ent and extended recovery features help assure data delivery in support of 24 hours a day, 7 days a week bus iness operations.
8 IBM Sterling Connect:Direct for i5/OS User’s Guide Queue Manager (QMGR) The QMGR manages the Sterling Connect:Direct Pr ocess queue. The QMGR is always active when Sterling Connect:Direct for i5/OS is active.
About Sterling Connect:Direct for i5/OS 9 When the Sterling Connect:Direct/M anager receives a Process that requires PLEXCLASS=CLASS1 and determines that both Sterling Connect :Direct/Servers support CLASS1, it ro utes the Process to the Sterling Connect:Direct/Server with the lowest workload.
10 IBM Sterling Connect:Direct for i5/OS User’s Guide 2. Press Enter . The Sterling Connect:D irect Main Menu displays the Sterling Connect:Direct for i5/OS functions that you can pe rform from th is screen. Accessing the Administration Menu Option 20 on th e Sterling Connect:Direct Main Menu provides access to the following Administration Menu.
About Sterling Connect:Direct for i5/OS 11 The Connect:Direct Administration menu consists of two screens. A ccess the second screen by pressing the page down key. CDADMIN Connect:Direct (tm) Administration System: FRAN Select one of the following: Connect:Direct Statistics.
12 IBM Sterling Connect:Direct for i5/OS User’s Guide.
Chapter 2 Using Control Language Sterling Connect:Direct for i5/OS uses Sterling Connect :Di rect CL commands to perform Sterling Connect:Direct function s.
14 IBM Sterling Connect:Direct for i5/OS User’s Guide CDDSPSTATI Display information about where statistics are being logged. CDRCV Receive data from a remote node. CDRSTSTATM Decompress selected statistics file members to a user-designated file. CDSELSTAT Select statistics records and retrieve information about the active statistics file.
Using Control L anguage 15 Entering CL Commands You can type CL commands on an i5/OS node using any of the following met hods: Embedding CL Commands You can embed CL commands in an application (u ser-.
16 IBM Sterling Connect:Direct for i5/OS User’s Guide &MSGID is the CDE* error message. The first 8 characters of the &MSGDATA are the application error message that you can look up interact.
Using Control L anguage 17 Command Prompting for the Sterli ng Connect:Dire ct CL Commands Sterling Connect:Direct CL commands follow the format of the native i5/OS CL com mands, which provide an extensive help facility describing their purp ose, parameters, values, and any dependencies.
18 IBM Sterling Connect:Direct for i5/OS User’s Guide.
Chapter 3 Sending a File Sending a file on Sterling Connect:Direct for i5/ O S requires the Sterling Connect:Direct Send (CDSND) command. Understanding the Ster ling Connect:Direct for i5/OS fi le systems, the CDSND command parameters, block mode transfer, and the CDSND screens enables you to use this command more effectively.
20 IBM Sterling Connect:Direct for i5/OS User’s Guide /QSYS.LIB is the iSeries DB2 file system /QOpenSys is a UNIX-style file system All others are part of the root file system Specifying a Path Name The integrated file system recognizes the objects by the path specification.
Sending a File 21 CDSND Command Format The following table shows the parameters for the CDSND command. Requi red parameters are in bold. Command Parameters CDSND SNODE(remote-node-name) SNODENVIRN(rem.
22 IBM Sterling Connect:Direct for i5/OS User’s Guide Required Parameters Unless otherwise noted, these required parame ters apply to all remote node environments. SNODE(remote-node-name) specifies a 1–16 character alphanum eric name for the receiving node (remote node).
Sending a File 23 SNODENVIRN(remote- environment-name) specifies the 1–10 character alphanumeric name fo r the receiving node envir onment: OS400, O S390, MVS, MSP, OPENVMS, TANDEM, UNIX, VM, VO S, V SE, Microsoft Windows, or Microsoft Windows_NT. FDSN(‘from data -set-name’) specifies the f ile to be sent to the remote n ode.
24 IBM Sterling Connect:Direct for i5/OS User’s Guide FMSYSOP TS(‘ PRECMPR(*YES | *NO ) EXITCMD(valid i5/OS com mand) FAILCMD (val id i5/OS comm and) SNDFFD(*Y ES | *NO ) TEXTFILE(*YES | *NO ) TYP.
Sending a File 25 EXITCMD (valid i5/OS command) specifies a command to execut e on ly if the copy process is successful. FAILCMD (valid i5/OS command) specifies a command to be executed only if the copy process is not successful. SNDFFD(*YES|*NO ) specifies whether the sending node transfers file field descriptions.
26 IBM Sterling Connect:Direct for i5/OS User’s Guide DBCS indicates that the data is pure DBCS char acters and that no SO/S I characters are used. The following rules apply to the use of the XTRAN keyword: You must specify the XTRAN keyword to use ex tended translation; al l ot h er keywords are optional.
Sending a File 27 CCSID(nnnnn) specifies the coded cha racter set ID to use when creating IFS files. If no character set ID is specified, the system default is us ed. EORCHAR(xxxx) specifies the two-to four-digit hexadecima l symbol to id entify the character to use in text files as the end-of-record character, for example, EORCHAR(0A).
28 IBM Sterling Connect:Direct for i5/OS User’s Guide The following TOSYSOPTS parameters are valid for TYPE(SPLF) files: DEV(*JOB|*SYSVAL|device-name) specifies the name of th e printer devi ce descript ion. DEVTYPE(*IPDS|*SCS)|*USERASCII specifies the type of data stream created for a printer file from the data received.
Sending a File 29 COPIES(number-of-copies) specifies the number of copies to be printed. Val id valu es range from 1–255. This parameter is valid only when SPOOL(*YES). MAXRCDS(maximum-records) specifies the maximum number of records that is placed in the spooled file.
30 IBM Sterling Connect:Direct for i5/OS User’s Guide CLASS(n) determines the node-to-node se ssion on whic h an operation can execute. The CLASS is a number in the range of 1–255. If you do not specify the CLASS pa rame ter, it defaults to the number of maxi mum sessions defined in the mode description fo r the communications enviro nmen t.
Sending a File 31 ECWINSIZE specifies the extended compre ssion window size, which is specifically for the history buffer that is filled from the user’s input buffer (both compressing and decomp ressing). The window specifies the amount of st orage designated to mainta in data previ ously read.
32 IBM Sterling Connect:Direct for i5/OS User’s Guide PLEXCLASS(user-defined class) specifies a user-defined class containing up to eight characters associ ated with a Sterling Connect:Direct/Server in a Sterling C onnect:Direct/Plex environm ent. This represents a type of server on which you want to run a task, for example TAPE.
Sending a File 33 Digital Signature specifi es if a digital signature is created while a file is being tran smit ted. SELECT(member, new-name, R /NR, ‘list’) specifies selection criteria by which file members are to be copied. Us e this parameter when you specify TYPE(FILE) in the FMSYSOPTS parameter.
34 IBM Sterling Connect:Direct for i5/OS User’s Guide pswd specifies the current security password. The security system on the SNODE can use this parameter to validate the current security password (1–64 alphanum eric characters). This is optional unless you have security set to requ ire a password.
Sending a File 35 optcd specifies optional processing associat ed with this file. Th is specification only appl ies to this file and is not automatically applied to the other files involved in the RECEIVE op eration. Valid options are: W performs write validity check s on direct access storage device s.
36 IBM Sterling Connect:Direct for i5/OS User’s Guide MOD indicates that the operation modifies the memb er by adding data to the end of the member or, if none exists, allocates a new member. The file is also created if it does not exist. RPL indicates that the destination fi le or member is replaced.
Sending a File 37 When used with the FROM pa rameter, the access modes are W (primary read/write access), M (primary multiple access), R (primary read only), RR (primary and remote read only access), .
38 IBM Sterling Connect:Direct for i5/OS User’s Guide K enables the KQV logic trace. D enables the all-purpose data dump. H enables the FMH dump. V enables the XDR dump. P enables the CIPC dump. *ALL enables all product traces.
Sending a File 39 TTYPE(entry-name) specifies the entry name of the type defaults file on the remote node that contains the default fi le attributes used to allocate the destination file. TUNIT(file-address) specifies the unit address, device type, or user-assi gned gro up nam e where the file resides or will reside.
40 IBM Sterling Connect:Direct for i5/OS User’s Guide Sterling Connect:Direct for i5/OS simulates blo ck reads and writes. Using lo gical blocks instead of physical blocks, it allows you to modify the blo cksize to mat ch the other node in some cases.
Sending a File 41 Because the blocksizes match, the block mode copy occurs. CDRCV Example—Specifying Source File Blocksize In the second example, the following occurs: Sterling Connect:Direct for i5/OS calcula tes the simulated blocksize at 3200 because the destination file is new and the source file specifies a blocksize.
42 IBM Sterling Connect:Direct for i5/OS User’s Guide Using the CDSND Screens Use the Connect:Direct Send File (CDSND) screens to send a file to a remote node. Sending a File to a Remote Node Complete the f ollowing steps to send a file to a remote node.
Sending a File 43 Connect:Direct Send File Screen 2 Connect:Direct Send File Screen 3 Connect:Direct Send File (CDSND) Type choices, press Enter. Receiving System Operations .
44 IBM Sterling Connect:Direct for i5/OS User’s Guide Connect:Direct Send File Screen 4 Connect:Direct Send File Screen 5 Connect:Direct Send File (CDSND) Type choices, press Enter.
Chapter 4 Receiving a File Receiving a file on Sterling Connect:D irect for i5/OS requires the Ster ling Connect:Direct Receive (CDRCV) command. Understanding the Ster ling Connect:Direct for i5/OS fi le systems, the CDRCV command parameters, and the CDRCV screens enables you to use this command more effectively.
46 IBM Sterling Connect:Direct for i5/OS User’s Guide The Sterling Connect:Direct for i5/OS integrated file syst em provides application and data compatibil ity with other platforms. The integrated file syst em consists of five file system types: /QLANSrv is a LAN server file system /QDLS is a document library file system /QSYS.
Receiving a File 47 CDRCV Command Format Following are the parameters for the CDRCV command. Required parameters are in bold. Command Parameter CDRCV SNODE(remote-node-name) SNODENVIRN(remote-environm.
48 IBM Sterling Connect:Direct for i5/OS User’s Guide Required Para meters Unless otherwise noted, these required parame ters apply to all remote node environments. SNODE(remote-node-name) specifies a 1–16 character alphanumer ic name for the remote node.
Receiving a File 49 FDSN(‘from remote-data-set-name’) specifies the source file name. File names are ve rified based on the i5/OS standard file name conventions.
50 IBM Sterling Connect:Direct for i5/OS User’s Guide TDSN(‘to data-set-name’) specifies the local file name. File names are ve rified based on the i5/OS standard file name conventions. The length of the input fi eld displayed is 132 characters, b y default.
Receiving a File 51 TEXTFILE(*YES|*NO ) specifies that the file being sent is a text file. TYPE(FILE |MBR|OBJ|SPLF) specifies the type of da ta to be copied. You must define the type of data structure to be copied as one of the following: FILE specifies that the file being copi ed is a physical database file.
52 IBM Sterling Connect:Direct for i5/OS User’s Guide TYPE(FILE |MBR|OBJ|SPLF) specifies the type of data structure to be created. You must def ine the data structure to be created as one of the following: FILE specifies that the file being creat ed is a physical database file.
Receiving a File 53 The following TOSYSOPTS parameters are valid for TYPE(SPLF) files: DEV(*JOB|*SYSVAL|device-name) specifies the name of the printer device description. DEVTYPE(*IPDS|*SCS|*USERASCII) specifies the type of data stream created for a printer file from the data received.
54 IBM Sterling Connect:Direct for i5/OS User’s Guide MAXRCDS(maximum-records) specifies the maximum number of records that can be placed in the spooled file. Valid values range from 1–500000. FILESEP(number-of-file-separators) specifies the number of blank separator pages to be placed between each copy of the file printed.
Receiving a File 55 If you receive a file from an ASCII platform using extended translation, you must specify in the FMSYSOPTS that the data type is binary. Refer to th e IBM Sterling Connect:Di rect Processes Web site at http://www.sterlingcommerce.
56 IBM Sterling Connect:Direct for i5/OS User’s Guide COMPRESS(*NO | *YES| *EXT | Xxx | Ccc ) specifies that the data is to be compressed, which reduces the amount of data tr ansmi tted as the file is copied from one node to another. The file is automatically decom pressed at its desti natio n unless DECOMP(*NO) is specified in TOSYSOPTS.
Receiving a File 57 This data can be scanned for string matc hes. The extend ed compression window size affects how much virtual memory the extended compressi on ro utines use. Higher window size values use more memory but achieve greater compression.
58 IBM Sterling Connect:Direct for i5/OS User’s Guide den specifies the magnetic tape m ode set ting. Th e following table shows the values for the DEN parameter for 7- and 9-track tapes. When coded together, the DEN and TRTCH values are used to select a tape device for allocation by Sterling Connect:Direct for z/OS.
Receiving a File 59 trtch specifies the magnetic tape mode setting. Wh en coded together, Ster ling Connect:Direct for z/OS uses the TRTCH and DEN values to select a tape device for allocation. Valid options are: C specifies data conversion, odd parity, and no tr anslation.
60 IBM Sterling Connect:Direct for i5/OS User’s Guide labeltype is designated as: SL specifies IBM standard labels. AL specifies American National Standard labels. BLP specifies bypass label processing. LTM specifies bypass leading tape marks. NL specifies no labels.
Receiving a File 61 FUNIT(name) specifies the unit address, device type, or user-assi gned gro up nam e where the file resides or will reside. For SAM-to-SAM copies where the destinat ion file is new and the UNIT parameter is not coded, the device type from the source file is used.
62 IBM Sterling Connect:Direct for i5/OS User’s Guide PNAME(process-name) identifies the Process in any messages or statistics. The name can be from 1 to 12 character s long . The first character must be alphabetic. The default name is CDRCV. PNODEID(id, pswd, newpswd) specifies security user IDs and passwords at the local i5/OS node.
Receiving a File 63 member specifies the members to be c opied. Member selections are: * represents a global generic. A global generic in dicates that all members of the file are to be included. generic specifies a generic member name. For exampl e, if you specify CD*, all member names beginning with CD are selected for copy ing.
64 IBM Sterling Connect:Direct for i5/OS User’s Guide current specifies the status of the file before th e operation executes. Valid values for this subparameter are: NEW specifies that the operation creates the destin ation file or member. If you are creating a member, the file can already exist but the member mu st not already exist.
Receiving a File 65 F enables the file handler trace. C enables the common logic trace. X enables the XDR trace. K enables the KQV logic trace. D enables the all-purpose data dump. H enables the FMH dump. V enables the XDR dump.
66 IBM Sterling Connect:Direct for i5/OS User’s Guide As the remote node, Sterling Con nect:Direct for i5/OS determines the simulated blocksize by these conditions in order of precedence: Source.
Receiving a File 67 Because the file attributes match, the block mode transfer occurs. CDSND Examples-Setting Actual Blocksize In the fourth exam ple, the following events occur: the remote node sets the destination file bl ocksize to 3200, the actual blocksize of the destination file.
68 IBM Sterling Connect:Direct for i5/OS User’s Guide The following are samples of the screens in the Sterling Connect:Direct Receive File (CD RCV) screen flow. The sample shows the k eyword display option. Connect:Direct Receive File (CDRCV) Screen 1 The content of this screen and the screens that follow depend on the remot e node envi ronment.
Receiving a File 69 Connect:Direct Receive File (CDRCV) Screen 2 Connect:Direct Receive File (CDRCV) Screen 3 Connect:Direct Receive File (CDRCV) Type choices, press Enter. Sending System Operations . . . . .’TYPE(FILE)' ... Trace Options: Trace Instructions .
70 IBM Sterling Connect:Direct for i5/OS User’s Guide Connect:Direct Receive File (CDRCV) Screen 4 Connect:Direct Receive File (CDRCV) Screen 5 Connect:Direct Receive File (CDRCV) Type choices, press Enter.
Receiving a File 71 Connect:Direct Receive File (CDRCV) Screen 6 Connect:Direct Receive File (CDRCV) Type choices, press Enter. Sending DCB Info.: Model File Name . . . . . . . __________________________________________________ ____________________________________ Block Size in bytes .
72 IBM Sterling Connect:Direct for i5/OS User’s Guide.
Chapter 5 Sending a Spool File This chapter describes the Sterling Connect:Direct Send Spool (CDSNDSPL) command and its funct ion. It shows sample CDSNDSPL screens and describes the required and optional parameters for the CDSNDSPL command.
74 IBM Sterling Connect:Direct for i5/OS User’s Guide JOB(*|job-name user-name job -number) SPLFNUM(n|*ONLY|*LAST) TDSN(spoole d-file-name|data-set-na me) TOSYSOPTS (‘ DECMPR(*YES|*NO ) EXITCMD(va.
Sending a Spool File 75 Required Para meters Unless otherwise noted, these required param eters apply to all remote node environmen ts. SNODE(remote-node-name) specifies a 1–16 character alphanum eric name fo r the remote nod e. SNODENVIRN(remote- environment-name) specifies the remote node environment.
76 IBM Sterling Connect:Direct for i5/OS User’s Guide SPLFNUM(n|*ONLY|*LAST) specifies the spooled output file number from the jo b whose data records are to be sent. Valid values are: 1–9999 indicates to copy the specified spoo led output file number.
Sending a Spool File 77 TOSYSOPT S(‘ DECMPR(*YES|*NO ) EXITCMD(valid i5/OS command) FAILCMD(valid i5 /OS command) TYPE(FILE |MBR|SPL F) XTRAN(table- name) [XTRANLSO(so- code)| XTRANLSI(si-code)|XTRANLDATA(MIXED |DBCS)] CCSID(nnnnn) EORCHAR(xxxx) ’) specifies system operation parameters at the remote node.
78 IBM Sterling Connect:Direct for i5/OS User’s Guide without decompressing it. The op tio n DECMPR(*NO) cannot be sp ecifi ed if yo u are using Sterling Connect:Direct Secure Plus to perform a secured copy functio n. TYPE(FILE |MBR|SPLF) specifies the type of data to be sent.
Sending a Spool File 79 CTLCHAR(*NONE|*FCFC) specifies whether the data cont ains printer control characters. CHLVAL(*NORMAL| (channel#1 line#1) ... (channel#12 line#12)) specifies the list of channel numbers with their assi gned li ne num bers. Note that CTLCHAR(*FCFC) must be specified as a SYSOPTS parameter for this to be a valid parameter.
80 IBM Sterling Connect:Direct for i5/OS User’s Guide If the XTRAN keyword is present, then the following related opt ional keywords can also be used: XTRANLSO(so-code) specifies extended translation lo cal shift-out co de.
Sending a Spool File 81 Database f or iSeries SQL Refer ence, Appendix E. CODEPAGE() on Sterling Connect :Direct for i5/OS relates to CODEPAGE() developed for the z/OS system, UNIX, and Microsoft Windows. nnnnn identifies the IBM CCSID codepage number to convert from and the IBM CCSID code page number to convert to.
82 IBM Sterling Connect:Direct for i5/OS User’s Guide COMPRESS (*YES|*NO |Xxx |Ccc|EXT) specifies data compression, which re duces the amount of data transmitted as the file is copied from one node to another. The file is auto matically decomp ressed at its destin ation.
Sending a Spool File 83 This data can be scanned for string matc hes. The extend ed compression window size affects how much virtual memory the extended compressi on ro utines use. Higher window size values use more memory but achieve greater compression.
84 IBM Sterling Connect:Direct for i5/OS User’s Guide PNODEID(id, pswd, newpswd) specifies security user IDs and passwords at the local node. This parameter should only be used to validate security with a differen t ID than the one you used to sign on to Sterling Connect:Direct.
Sending a Spool File 85 id specifies the security ID sent to the remote node (1–64 alphanum eric characters). pswd specifies the current security password and is used by the security system on the SNODE to validate the current security pass word (1–64 alphanumeric characters) .
86 IBM Sterling Connect:Direct for i5/OS User’s Guide limct specifies the blocks or tracks searched to find a free block or available space. lrecl specifies the record length in bytes. optcd establishes optional processing as sociated with a specifi c file.
Sending a Spool File 87 NEW specifies that the operation cr eates the destination member for an existing file. NEW is the default. The file is created if the member does no t exist. The file cannot b e created if the member already exists. OLD specifies that the destination member alread y exists.
88 IBM Sterling Connect:Direct for i5/OS User’s Guide TLINK(vmid,pwd,accmod e,cuu) specifies the disk where the CMS file is located. This parameter allows the user to access the CMS file. This parameter is valid for VM or VSE nodes only. vmid specifies the o wner ID for the CMS mi nidisk wher e the file is located.
Sending a Spool File 89 *INITPARMS indicates the traces specified in the initialization parameters. *CURRENT selects the trace bits that the se ssion manager is currently using.
90 IBM Sterling Connect:Direct for i5/OS User’s Guide TSQL(sql-statement|DSN=data-s et-name) defines the SQL statement to be processed ag ainst the database identified by the DBPARMS parameter or the DSN containing the SQL statements(s ). The SQL parameter is used with the optional Sterling Connect:Direct SQL feature.
Sending a Spool File 91 Sending a Spooled File to a Re mote Node Use the Sterling Connect:Direct Send Spool (CDSNDSPL) screens to send a spooled file to a remote node.
92 IBM Sterling Connect:Direct for i5/OS User’s Guide.
Chapter 6 Running a Remote Task This chapter describes the Sterling Connect:Direct Run Task (CDRUNTASK) command and its funct ion. Using the CDRUNTASK Command Use the CDRUNTASK command to run a task at a remote node.
94 IBM Sterling Connect:Direct for i5/OS User’s Guide CDRUNTASK Example With New TraceOpt Parameters CDRUNTASK Command Format The following are the parameters for the CDRUNTASK command.
Running a Remote Task 95 Required Para meters The following two parameters are required when yo u use the CDRUNTASK command. SNODE(remote-node-name) specifies a 1–16 character alphanum eric name fo r the remote nod e. SNODENVIRN(remote- environment-name) specifies the remote environment to execute the task.
96 IBM Sterling Connect:Direct for i5/OS User’s Guide Optional Parameters The following parameters are opti onal. Unless otherw i s e noted, the parameters apply to all rem ote nod e environments. CLASS(n) determines the node-to-node session on whic h a Sterling Connect:Direct operation can execute.
Running a Remote Task 97 pswd specifies the current security password for the sp ecified ID. The security system at the local node can use this parameter to validate the curren t security password (1–10 al phanumeric characters). This is optional un less the user has security set to require a password .
98 IBM Sterling Connect:Direct for i5/OS User’s Guide H enables the FMH dump. V enables the XDR dump. W enables the communications dump. P enables the CIPC dump.
Running a Remote Task 99 The following figure shows a sample of the first screen in the Sterling Connect:D irect Run Task (CDRUNTASK) screen flow for a Sterling Connect:D irect for i5/O S rem ote environment. Additional screens vary according to the remote node environment.
100 IBM Sterling Connect:Direct for i5/OS User’s Guide.
Chapter 7 Submitting a Sterling Connect:Direct Process on a Remote Node This chapter describes the Sterling Connect:Direct Submit (CDSUBMIT) command and its function. This chapter also shows sample CDSUBMIT screens and describes the CL parameters used for the CDSUBMIT command.
102 IBM Sterling Connect:Direct for i5/OS User’s Guide Required Para meters The following parameters are required . Unless otherw is e noted, the parameters apply to all rem ote nod e environments. SNODE(remote-node-name) specifies a 1–16 character alphanum eric name fo r the remote nod e.
Submitting a Sterling Connect:Direct Process on a Remo te Node 103 SNODENVIRN(remote- environment-name) specifies the remote node environment. PROCFILE(file-name) specifies the name of the file or member that contains the Sterling Conn ect:Direct Process to be submitted.
104 IBM Sterling Connect:Direct for i5/OS User’s Guide PCLASS(n) specifies the Sterling Connect:Direct Process CLASS for the submitte d remote Process. This entr y overrides the class specified in the Process . PHOLD(*YES|*NO|*CALL) specifies whether the submitted remote Process is pl aced in the hold queue at submission.
Submitting a Sterling Connect:Direct Process on a Remo te Node 105 PPNODEID(i d,pswd,newpswd) specifies the primary node user ID and password for the submitted remote Process. This entry overrides the one specified in the Process. PPRTY(n) specifies the Sterling Connect:Direct priority class for the submitted rem ote Process.
106 IBM Sterling Connect:Direct for i5/OS User’s Guide SACCT(SNODE acco unting-data) specifies the accounting data for the remote node. The maximum length of the accounting data is 256 characters. If special characters ar e part of the accounting data, the st ring must be enclosed in single quotation marks.
Submitting a Sterling Connect:Direct Process on a Remo te Node 107 S enables the Process step logic trace. F enables the file handler trace. C enables the common logic trace. X enables the XDR trace. K enables the KQV logic trace. D enables the all-purpose data dump.
108 IBM Sterling Connect:Direct for i5/OS User’s Guide Sterling Connect:Direct Submit Primary Screen The following is a sample of the first screen in the Sterling Connect:Direct Submit (CDSUBMIT) screen flow. Connect:Direct Submit (CDSUBMIT) Type choices, press Enter.
Chapter 8 Submitting a Job on a Remote Node This chapter describes the Sterling Connect:Direct Run Job (CDRUNJOB) com mand and its function. Th is chapter also shows sample CDRUNJOB screens and describes the required and optional CL parameters fo r the CDRUNJOB command.
110 IBM Sterling Connect:Direct for i5/OS User’s Guide CDRUNJOB Command Format The following are the parameters for the CDRUNJOB command. Required parameters are in bold. Required Para meters The following parameters are required . Unless otherw is e noted, the parameters apply to all rem ote nod e environments.
Submitting a Job on a Remote Node 111 Optional Parameters The following parameters, list ed alph ab etically, are optional. Unless otherw ise noted, the paramet ers apply to all remote node environmen ts. BATCHID(idname) specifies the VM remote Virtual Machine ID name.
112 IBM Sterling Connect:Direct for i5/OS User’s Guide PLEXCLASS(user-defined class) specifies a user-defined class containing up to eight characters associ ated with a Sterling Connect:Direct/Server in a Sterling C onnect:Direct/Plex environm ent. This represents a type of server on which you want to submit a job.
Submitting a Job on a Remote Node 113 newpswd specifies the new security passwo rd and is used by the security system to change the current security password to the new security password (1–6 4 alphanumeric characters).
114 IBM Sterling Connect:Direct for i5/OS User’s Guide *EXT enables all product traces plus tw o other traces. (TRCICF and TRCJOB) *COMMON enables the most commonly used traces. (L, S, F, C, and H) *NONE turns off all traces. TSYSOPTS(remot e-job-command) specifies system-specific s ubmission information.
Submitting a Job on a Remote Node 115 The primary CDRUNJOB screen looks similar to the followin g. Connect:Direct Run Job (CDRUNJOB) Type choices, press Enter. Remote Node Name . . . . . . . . > hotpepper________ Remote Environment . . . . . . . > AS400_____ AS400, MVS, OS390, OS/400.
116 IBM Sterling Connect:Direct for i5/OS User’s Guide.
Chapter 9 Compressing Files This chapter describes the Sterling Connect:Direct Co mpress (CDCOMP) command and its function. This chapter also shows sample CDCOMP screens and describes the parameters used with the CDCOMP command. Using the CDCOMP Command Use the CDCOMP command to compress a file on the i5/OS node before sending it to a remote node.
118 IBM Sterling Connect:Direct for i5/OS User’s Guide CDCOMP Command Format The following table shows the fo rmat for the CDCOMP command. Required Para meters The CDCOMP command h as the following required parame ters. INFILE (library -name/file- name) specifies the name and library of the file to be comp ressed.
Compressing Files 119 EXCMBR(start-mbr end-mbr) specifies criteria by which file members are exclude d from compression. In any case where a member meets the criteria of both the SELMBR and EXCMBR parame ters, the EXCMBR specification overrides the selection of the member.
120 IBM Sterling Connect:Direct for i5/OS User’s Guide start-mbr specifies the name of the member to be compre ssed or the first name in a range of members to be compressed. Possible values are: *INFILE specifies the name of the member is the same as the name of the input file.
Compressing Files 121 The following figure is a sample Connect:Direct Compress File (CDCOMP) screen. Connect:Direct Compress File (CDCOMP) Type choices, press Enter. Input file name . . . . . . . . _______ Name Library . . . . . . . . . . . *LIBL ____ Name, *LIBL Output file name .
122 IBM Sterling Connect:Direct for i5/OS User’s Guide.
Chapter 10 Controlling Processes Sterling Connect:Di rect for i5/OS imple ments a Sterling Connect:Direct Pr ocess Management Queue. You can use two commands to schedule, contro l, and monitor any act.
124 IBM Sterling Connect:Direct for i5/OS User’s Guide The Process Management Queue handles all processes: Local Synchronous (Examples: CDSND, CDRCV, CDRUNTASK) Local Asynchronous (CDSUBPROC.
Controlling Processes 125 Required Para meter The CMD parameter is required for the CDSUBPROC command. CMD(command string ) specifies the Sterling Connect:Direct command string to execute. This value must be a valid Sterli ng Connect:Direct for i5/OS command with any required parameters and su bparameters.
126 IBM Sterling Connect:Direct for i5/OS User’s Guide frequency indicates how often the Process runs. You can determine the frequency by entering one of the following selections: *NON E, *DAY, or *WEEK. If you enter *NONE, the Process is run only once automatically.
Controlling Processes 127 *ALL enables all product traces.(L, S, F, C, X, K, D, H, V, and P) *EXT enables all product traces p lus two other traces. (TRCICF and TRCJOB) *COMMON enables the most commonly used traces. (L, S, F, C, and H) *NONE turns off all traces.
128 IBM Sterling Connect:Direct for i5/OS User’s Guide Working with Sterling Co nnect:Direct Processes Use the WRKCDPROC comm and to schedule, mon itor, an d control the Processes. The following options are available: Selecting Specific Processes Selection options allow you to specify th e Processes with which you work.
Controlling Processes 129 *ALL indicates that you select all Process names. name is the name of a specific Process you want to select. Enter the name of a Sterling Connect:Direct Process. generic identifies a generic Process name. For example, CD* selects all Processes that begin with CD.
130 IBM Sterling Connect:Direct for i5/OS User’s Guide Using the WRKCDPROC Screens Use the Work with Connect:Di rect Process (WRKCDPROC) screen to monitor and cont rol Processes in the subsystem. Monitoring and Controlling Processes Complete the f ollowing steps t o monitor or con trol a Process: 1.
Controlling Processes 131 Press F11 to display View 2, w hich provides additional informatio n about Processe s you selected. You can select an option to monitor or change Processes from this screen or the View 1 screen.
132 IBM Sterling Connect:Direct for i5/OS User’s Guide The following is an example of the Display C:D Process s creen. Releasing a Process in the HOLD Queue Release (Option 6) permits you to release a Process in th e HOLD queue and move it to the W AIT queue.
Controlling Processes 133 RLSCDPROC Screen HLDCDPROC Screen Release Held C:D Process (RLSCDPROC) Type choices, press Enter. Process Type . . . . . . . . . . A A Process Queue . . . . . . . . . HOLDQ HOLDQ Process Name . . . . . . . . . . *ALL Character value Process number .
134 IBM Sterling Connect:Direct for i5/OS User’s Guide.
Chapter 11 Using Sterling Connect:Direct Statistics Sterling Connect:Direct for i 5/OS logs statistics informat ion for all Processes. Each componen t of Sterl ing Connect:Direct for i5/OS generates statistics dat a to the statistics manager (STATMGR) job.
136 IBM Sterling Connect:Direct for i5/OS User’s Guide Required Para meters The CDSELSTAT command has no required param eters. Optional Parameters The following parameters are op tional for the CDSELSTAT command. FILE(filename|*ACTIVE ) allows you to specify the statistics database file to s earch.
Using Sterling Conne ct:Direct Statistics 137 start-date and end-date indicate the records being selected by da te criteria for stat istics s election.
138 IBM Sterling Connect:Direct for i5/OS User’s Guide Selecting and Displayi ng Summary Statistics Complete the f ollowing steps to sel ect and display summary statistics: 1.
Using Sterling Conne ct:Direct Statistics 139 about a particular statistics record. Type 5 in the option col umn for the Record type you want to review to display the detailed information an d pr ess Enter . The following screen shows the results of us ing the display optio n, Output destination (*).
140 IBM Sterling Connect:Direct for i5/OS User’s Guide Selecting and Printing Detail Statistics Complete the following steps to select and print detail statistics: 1. Access the CDSELSTAT screens by ty ping CDSELSTAT at the co mmand line and pressin g F4 or by selecting the select statistics opti on from the Connect:Direct main menu.
Using Sterling Conne ct:Direct Statistics 141 3. To display the list of spooled files in the output queue, at the comman d line, typ e WRKOUTQ cdlib /CDOUT where cdlib is the name of you r St erli ng Connect:Direct library. 4. In the Opt column, type 5 next to the CDSELSTAT spooled fi le and press Enter to go to the Display Spooled File screen.
142 IBM Sterling Connect:Direct for i5/OS User’s Guide The following screen shows the results of using th e display op tio n, Output destination, (*PRINT). Display Spooled File File . . . . . : CDSELSTAT Page/Line 1/6 Control . . . . . Columns 1 - 130 Find .
Chapter 12 Decompressing Files This chapter describes the Sterling Connect:D irect d ecompress (CDDECOMP) command and its function. This chapter also shows sample CDDECOMP screens and describes the parameters used for the CDDECOMP command.
144 IBM Sterling Connect:Direct for i5/OS User’s Guide Required Para meters The CDDECOMP command has two required parame ters. INFILE(library-name/file-name) specifies the name and library of the file to be decompressed. The default for library is *LIBL.
Decompressing Files 145 The following figure shows a sample Connect:Direct Decompress File (CDDECOMP) screen: Connect:Direct Decompress File (CDDECOMP) Type choices, press Enter. Input file name . . . . . . . . ______ Name Library . . . . . . . . . . .
146 IBM Sterling Connect:Direct for i5/OS User’s Guide.
Chapter 13 Displaying Sterling Connect:Direct Message Descriptions Sterling Connect:Direct for i5/OS generates messages that detail aspects of the St erling Connect:Direct for i5/OS operation.
148 IBM Sterling Connect:Direct for i5/OS User’s Guide DSPCDMSGD Command Example The following figures illustrate two ways of accessing a Sterling Connect:Direct message. DSPCDMSGD Command Format The following is the parameter for the DSPCDMSGD command: Required Parameter The DSPCDMSGD command has one required parameter.
Displaying Sterling Connect: Direct Me ssage Descrip tions 149 The following screen is an example of the sc reen associated with the DSPCDMSGD command. Sample Message Description The following figure shows a sample message descriptio n. Display Connect:Direct Message (DSPCDMSGD) Type choices, press Enter.
150 IBM Sterling Connect:Direct for i5/OS User’s Guide.
Appendix A CL Program Examples The tables provide examples of i5/ OS CL Programs using features of Sterling C onnect:Direct. These examples are stored in a Physical Source File that is restored to the system during installation. If PDM is installed, you can then use th e WRKMBRPDM command to browse the members.
152 IBM Sterling Connect:Direct for i5/OS User’s Guide i5/OS Run Task Example i5/OS Send Example Using Se nd File Field Description i5/OS Send and Receive Exampl es Using Native File System Member Name Description ARNJDS01 CDRUNTASK Example Member Name Description ASNDCF1A CDSND U sing SNDFFD Parameter Member Name Description ASNDCR1A ASNDCRIA.
CL Program Exam pl e s 153 i5/OS Send and Receive Examples Using Integrated File System Member Name Description ASNDIFI1A CDSND /QSYS Text ASNDIFI1B ASNDIFI1B.
154 IBM Sterling Connect:Direct for i5/OS User’s Guide i5/OS–z/OS Send and Receive Examples ARCVIFN1P CDSND Integrated File System to Native /QDLS ARCVIFS1C CDSND Integrated File System /QSYS to S.
CL Program Exam pl e s 155 i5/OS–NT Send a nd Receive Examples MSNDCRSAVF CDSND Save File to Save File MSNDCRSFI2 CDSND to VB File from Integrated File System /root MSNDCRSFS1 CDSND from Physical So.
156 IBM Sterling Connect:Direct for i5/OS User’s Guide i5/OS–Microsoft Windows Run Job and Run T ask Examples i5/OS–UNIX Send a nd Receive Examples NSNDIF01J CDSND U sing Integrated File System .
CL Program Exam pl e s 157 i5/OS–UNIX Run Task and Run Job Examples i5/OS–UTIL Test Examples USNDCF01H CDSND of Physic al Data Text File USNDCF01I CDSND of Physical Data Binary File USNDCF01S CDSN.
158 IBM Sterling Connect:Direct for i5/OS User’s Guide.
IBM Sterling Connect:Direct for i5/OS User’s Guide 159 Notices This information was developed for pr oduc ts and services offered in the U.S.A. IBM may not offer the products, services, or feat ures discussed in this document in o t he r countries.
Notices 160 IBM Sterling Connect:Direct for i5/OS User’s Guide MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some s tates do not allow disclaimer of express or implied warra nties in ce rtain transactions, therefore , this statement may not apply to you.
Notices IBM Sterling Connect:Direct for i5/OS User’s Guide 161 This information is for planning purposes only. The information herein is subject to change before the products described become availa ble. This information contains ex amples of data and reports used in daily business operations.
Notices 162 IBM Sterling Connect:Direct for i5/OS User’s Guide UNIX is a registered trademark of The Op en Group in the United States and other countries. Java and all Java-based trademarks and logos ar e trademarks or registered trademarks of Oracle and/or its affiliates.
Glossary A Adjacent Node An adjacent node is an entry in the Network Map that defines a Sterling Connect:D irect nod e with which th e local Sterling Connect:Direct node can communicate.
164 IBM Sterling Connect:Direct for i5/OS User’s Guide I Integrated File System The integrated file system provides an integrated struct ure of all stored inform ation. This file system provides stream files, directory structure accessed by path, and a user and ap plication interface that access es all information stored in the i5/OS.
165 necessarily be interpreted as the send ing node, since PNODE can be the receiver. In every Process, there is one local (PNODE) and one remote (SNOD E) specified. The submitter of a Process is always the PNODE. Process A Process is a series of statements that initiate Sterling Connect:Direct ac tivity, such as copying files, and running jobs.
166 IBM Sterling Connect:Direct for i5/OS User’s Guide S Secondary Node (SNODE) The remote or secondary no de (SNODE) is the Sterlin g Connect:Di rect no de that interacts with the primary node (PNODE) durin g Process execution. SNOD E ma y also be referred to as the participating (non-controlling) or partner node.
167 Timer Queue (TIMER) This Sterling Connect:Direct for i5/OS componen t pro vid es ti mer services to the other components. The process manager submits and controls the TIMER.
168 IBM Sterling Connect:Direct for i5/OS User’s Guide.
Index A ACTIVQ definition 129 Administra ti o n Menu accessing 10 authority required 10 screens 11 asynchronous execution CDSUBPROC screens 127 submitting Process to Process queue 127 asynchronous pro.
170 IBM Sterling Connect:Direct for i5/OS User’s Guide FSQL 60 FTYPE parameters 60 FUNIT parameters 61 FVOL 61 FVOLREF 61 FVSAMCAT 61 general description 45 NOTIFY 61 parameters 48 PNAME 62 PNODEID .
Index 171 SECOPTIONS 32, 37 , 62, 64, 88, 97, 106 ,1 1 3 ,1 2 6 SELECT 33 sending a file 42 SNDFFD 25 SNODE 22 SNODEID 33 TBUFND 34 TDBPARMS 34 TDCB 34 TDISP 35 TDSN 23 TEXTFILE 25 TIOEXIT 36 TIOPARM .
172 IBM Sterling Connect:Direct for i5/OS User’s Guide RMTWORK 105 SACCT 106 screens 107 SNODE 102 SNODEID 106 SNODENVIRN 103 submitting Process on remot e node 107 CDSUBPROC command accessing 127 a.
Index 173 CDRCV command 56 CDSND command 30 CDSNDSPL command 82 parameter 30, 56, 82 compressing a file 117, 120 controlling processes 128, 130 CRC parameter CDRCV command 56 CDRUNJOB command 111 CDRU.
174 IBM Sterling Connect:Direct for i5/OS User’s Guide FPDSDIR CDRCV command 60 FSQL parameter 60 FTYPE parameter 60 function keys 17 FUNIT parameter 61 FVOL param eter 61 FVOLREF parameter 61 FVSAM.
Index 175 PNODEI D 96, 104, 112 PNOTIFY, CDSUBMIT command 104 PNUM, WRKCDPROC command 129 PPNODEID, CDSUBMIT command 105 PPRTY, CDSUBMIT command 105 PREQUEUE, CDSUBMIT command 105 PRETAIN, CDSUBMIT co.
176 IBM Sterling Connect:Direct for i5/OS User’s Guide QSYS.LIB 20 Queue Manager (QMGR) 8 queues ACTIVQ 123 HOLDQ 123 STARTQ 123 TIMERQ 123 WAITQ 123 R RCDTYPE parameter CDSELSTAT command 137 RCDTYP.
Index 177 SPLFNUM parameter 7 6 Spool Monitor (CDSPLMON) 8 starting a receive 45 a send 19, 20 a send of a spool file 73 a task 93 STARTQ, definition 129 STARTT parameter CDSUBPROC command 125 statist.
178 IBM Sterling Connect:Direct for i5/OS User’s Guide W WAITQ definition 129 working with processes 128 selecting specific Processes 128 user authority 12 8 viewing all Processes 128 WRKCDPROC comm.
An important point after buying a device IBM CDI5UG1107 (or even before the purchase) is to read its user manual. We should do this for several simple reasons:
If you have not bought IBM CDI5UG1107 yet, this is a good time to familiarize yourself with the basic data on the product. First of all view first pages of the manual, you can find above. You should find there the most important technical data IBM CDI5UG1107 - thus you can check whether the hardware meets your expectations. When delving into next pages of the user manual, IBM CDI5UG1107 you will learn all the available features of the product, as well as information on its operation. The information that you get IBM CDI5UG1107 will certainly help you make a decision on the purchase.
If you already are a holder of IBM CDI5UG1107, but have not read the manual yet, you should do it for the reasons described above. You will learn then if you properly used the available features, and whether you have not made any mistakes, which can shorten the lifetime IBM CDI5UG1107.
However, one of the most important roles played by the user manual is to help in solving problems with IBM CDI5UG1107. Almost always you will find there Troubleshooting, which are the most frequently occurring failures and malfunctions of the device IBM CDI5UG1107 along with tips on how to solve them. Even if you fail to solve the problem, the manual will show you a further procedure – contact to the customer service center or the nearest service center
