IBM CDI5UG1107 manual

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. Licensed Materials - Property of IBM IBM Sterlin[...]

Contents Chapter 1 About Sterling Connect:Direct for i5/OS Issuing Sterling Connect:Direct CL Commands ..... ........... .............. ................. ............ 7 Issuing CL Commands Through the Main Menu ............ ................. ................. ............ 9 Accessing the Administration Menu ............ ................. ..........[...]

4 IBM Sterling Connect:Direct for i5/OS User’s Guide CDRCV Command Format ............. .............. ... ... .............. ... .............. ... .............. ... ........ 47 Required Parameters ................ ... ................. .............. ... .............. ... ................. ........ 48 Optional Parameters .................... [...]

5 Chapter 10 Controlling Processes CDSUBPROC Command Example ................ ........... ...... .............. ... .............. ... ............ 124 CDSUBPROC Command Format .... ................. ................. ................. .............. ............ 124 Required Parameter ............. ................. .............. ... ............[...]

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 ............. .............. ..... 153 i5/OS–z/OS Send and Receive Ex amples .......... .........................................[...]

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. It links te[...]

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.  Timer (TIMER) The TIMER component p rovid es timer services to the session mana ger, the process queue manager, and other Sterlin[...]

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. For more information on the PLEXCLASS parame ter, see t[...]

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. 21. Select Connect:Direct statistics CDSELSTAT 22. Archive Connect:Direct [...]

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. Sterling Connect:Direct CL commands have th e following g eneral i5/OS CL com mand form at:  Each command can have required and optional parame ters and subparameters th at pro vide addition[...]

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. CDRUNJ[...]

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-written CL program), whi ch allow s you to combine functions supplied by Sterling Connect: Direct for i5/O S with i5/OS CL commands within a user-writ[...]

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 interactively with th e following command: Using CL Programming and Sterlin g Connect:Direct CL Commands An i5/OS CL program includes Sterling Connect:Dir ect[...]

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. In addition, you can use the prompt/help feature to se lect a[...]

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. Using the File System[...]

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. You m ust specify the fully qualified path name to transfer[...]

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(remote-environment-name) FDSN(‘from data-set- name’) TDSN(‘to data -set-name’) FMSYSOPTS (‘ PRECMPR(*YES|*NO ) EXITCMD(valid i5/OS command) FAI[...]

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). The node name must be defined in the network map. RMTWORK(*NO |*YES) SACCT[...]

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. Th e file name c[...]

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 ) TYPE(F ILE | MBR | OBJ) XTRAN(table-name) CODEPA GE(nnnnn,nnnnn)[XT RANLSO(so-code) | XTRANLSI(si-code | XTRANLDATA(MIXED | DBCS)|XTRANPAD(pc)] CCSID(nnn[...]

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. Use the following formula to det[...]

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.  The default for local shift-out [...]

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). CODEPAGE(nn[...]

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. PAGESIZE(page-length pag[...]

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. Valid values range from 1 –500 000. This parameter is valid only when SPOOL([...]

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. CO[...]

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. This data can be scanned for string matc hes. The ex[...]

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. PNAME(process-na[...]

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. The SELECT parameter consists of three po s[...]

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. newpswd specifies the new security passwo rd [...]

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. Q performs ASCII-to-EBCDIC conversion for inp[...]

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. The fi le is created if it does not exist. SH[...]

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), WR (primary read/write access; alternate read only access), MR (primary multip le access; alternate read only access), and MW (primary multiple 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.(L, S, F, C, X, K, D, H, V, and P)  *EXT enables all product traces plus tw o other traces. (T[...]

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. For SAM-to-SAM copies where the[...]

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. Sterling Connect:Direct for i5/OS suppo rt s block mode transfer when the fol lowing conditions [...]

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.  The receivi[...]

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. 1. Access the CDSND screens by typing CDSND at the command line and pressing F4 or by choosin[...]

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 . . ‘TYPE(FILE)’______________________________________ ____________________________________________________________________________________ ________________________________[...]

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. File Members Selection List . . __________________________________________________ ___________________________________________________________________________________[...]

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. Th is chapter provides the followin[...]

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.LIB is[...]

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-environment-name) FDSN(from remote-dat a-set-name) TDSN(to data-set -name) FMSYSOPTS (‘ PRECMPR(*YES|*NO ) CODEPAGE(nnnnn,nnnnn) EXITCMD(valid i5/OS command[...]

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. The node name must be defined in the network map. SNODENVIRN(remote- environment-name) spe[...]

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. The length of the input field displaye d is 132 characters, by default. If you want to increase the length of the field to 256 characters, type an ampersand( &) followed by a blank[...]

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. If you want to increase t he length of the field to 256 characters, type an ampersand[...]

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. MBR specifies that the member being cop[...]

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. MBR specifies that the member being created is a member of a physical[...]

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. PAGESIZE(page-length page-wid th ) specifies the length and wid[...]

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. HOLD(*YES|*NO) speci[...]

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.co m/documentation/processes/processhome.htm l for platform-specific SY SOPTS par ameters.  I[...]

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. You[...]

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. The vali d va lues for this subparamet er are 8–15, inclusive. The default value is *INITPARMS. [...]

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. dsorg specifies the file orga[...]

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. E specifies no data conversion, even parity , and no translation. T specifi[...]

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. pswdread specifies that a password must be su pplied by th e operator or user be[...]

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. For VSE nodes, you must specify either this parameter or FVOL. Spec[...]

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. Use this pa[...]

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. member-name specif[...]

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. If you are[...]

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.  P enables the CIPC dump.  *ALL enables all product traces.(L, S, F, C, X, K, D, H, V, [...]

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 file blocksize specified on the request  Destination file blocksize specified on the request  Calculated value* *Largest multiple of record siz[...]

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.  Sterling Connect:Direct for i5/OS calculates the si[...]

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 . . . . . . *CURRENT Command trace options . . . . *NONE Process Name . . . . . . . [...]

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. File Members Selection List . .________ _________________________ ___________________ _______________________________________________________[...]

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 . . . . . ______ Character value Tape Mode Density Setting . . __[...]

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. Using the CDSNDSPL Command Use the CDSNDSPL command to send a spool file on th e local i5/OS node to a remote[...]

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(valid i5/OS command) FAILCMD(valid i5/OS command) TYPE(FILE |MBR|OBJ|SPLF) CODEPAGE(nnnnn,nnnnn) XTRAN(table-name)[XTRANLSO(so-cod e) |XTRANLSI(si-code)[...]

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. SPLF(name) specifies the name of the spoole[...]

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. *ONLY indicates that only one of the job’s spoo le d out put files has the specified file n[...]

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. The maximum number of characters permit[...]

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. You must define the type of data to be copied as one of the following:[...]

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. FORM[...]

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. This keyword specifies the hexadecimal code to use for the local (i5/OS side) shift-out character and overrides the default [...]

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. If the FROM code page or TO code[...]

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. If compression is specifi ed, Sterling Connect:Direct reduces the amount [...]

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. The vali d va lues for this subparamet er are 8–15, inclusive. The default value is *INITPAR[...]

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. PNODEID is not used when both the ID and password match on the local[...]

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) . This is optional unl ess the user has security set to require a pas[...]

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. This opti onal processing only applies to this file and is not automatically appl ie d to [...]

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. The operation has exclusive control of the member. [...]

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. The valid length ranges from 1?[...]

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. Command Trace Options L,S,F,C,X,K,D,H,V,P|*ALL|*EXT|*COMMON| *NONE) specifies the trace bits that define functions to be traced for this command but not for the Pro[...]

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. This parameter is valid for [...]

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. Complete the f ollowing steps to send a spooled file to a remote nod e: 1. Access the CDSNDSPL screens by typing CDSNDSPL at the command line and pressing F4 or by choosing the send [...]

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. This command allows user programs, or subtasks, to be attached and run as a subtask und er the remote Sterling C onnect:Direct during[...]

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. Required paramet ers are in bold. ===> CDRUNTASK SNODE(CDDV3600) SNODENVIRN(AS400) CMD('WRKACTJOB SBS(CDDV3600) OUTPUT(*PRINT)') TRACEOPT(*ALL *ALL) [...]

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. One of the next two parameters is requi[...]

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. The CLASS is a number from 1–255. If you do n[...]

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 . newpswd specifies the new security 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.  *NONE turns off all traces.  *ALL enables all product traces.(L, S, F, C, X, K, D, H, V, W and P)  *EXT enables all product traces plus tw o system traces (TRCI[...]

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. Connect:Direct Run Task (CDRUNTASK) Type choices, press Enter. Remote Node [...]

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. Using the CDSUBMIT Command Use the CDSUBMIT command to submit a Sterling[...]

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. PROCFILE(file-na me) CLASS(n|*MODED ) CRC(*INITPARMS |*[...]

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. This file must already exist on the node where the Sterling Connect:Direct Pro[...]

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. The default is the HOLD [...]

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. This entry overrides t[...]

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. SNODEID(id,pswd,new pswd) specifies sec[...]

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.  H enables the FMH dump.  V enables the XDR 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. Remote Node Name . . . . . . . . > MVS.LEVEL1 ________ Remote Environment . [...]

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. Using the CDRUNJOB Command Use the CDRUNJOB command to submit a job on the remo[...]

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. SNODE(node-name) specifies a 1–1[...]

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. The valid range is 1–8 characters. CLASS(n) determines the node-to-node sessio[...]

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. PNAME(name) identifies the Proc[...]

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). TRACEOPT Trace Instructions (L, S, F, C, X, K, D, H, V, W, P,|*NONE|*ALL|*EXT| *COMMON |*INITPARMS|*CURRENT) specifies the trace[...]

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. For a remote i5/OS system, t [...]

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... Remote Job command . . . . . . . _______________________[...]

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. The input file is a database or [...]

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. You can type in multiple sets of values for this parameter. start-mbr specif[...]

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. *INFILE is the default. *ALL indicates all members in 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 . . . . . . . . _______ Name Library . . . . . . . . . . . *CURLIB_ _[...]

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 active or queued Processes:  CDSUBPROC command allows you to:  Submit Sterling Connect:Direct Processes fo r asynchronous execution  Control cer[...]

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)  Remote Submitting Processes for Asynchronous Execution The CDSUBPROC command allows you to submit a Sterling C onnect:Direct Process to the Proc[...]

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. Sterling Connect:Direct checks the command[...]

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. *DAY indicates that the Process is run every day at the same time after the firs[...]

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. Using the CDSUBPROC Screens Use the Connect:Direct Submit Process (CDS[...]

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. Viewing All Processes The [...]

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. PNUM(n|*ALL) specifies the Process number for the selected P[...]

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. Access the WRKCDPROC screen by typing WRKCDP RO[...]

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. WRKCDPROC Option Descriptions The seven options you can select from the Work With C:D Process screens are described in the follow[...]

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. There it is available for execution. No additional screen displays. Terminating and Flus[...]

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 . . . . . . . . . *ALL Character value Processing User . . . . . . . . *ALL [...]

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. The long-running STATMGR job formats the statis tics information and writes it to the stat is[...]

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. filename specifies a statistics database file. *[...]

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. Both start-date and end-date accep t one of the fo llowing formats: mmddyy, mm/dd/yy , mm .dd.yy. Input dates are interpreted according to the date fo rm at of the current job (i5/OS job date format[...]

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. Access the CDSELSTAT screens by ty ping CDSELSTAT at the co mmand line and pressin g F4 or by choosing the select statistics option (13) from the Sterling Connect: Direct m[...]

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 (*). Note: You could also type 6 and press Enter for [...]

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. The first CD[...]

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. (If[...]

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 . . . . . . *...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....[...]

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. Using the CDDECOMP Command Files are received from another node and archived on the i5/OS node as co mpressed [...]

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. library-name specifies the name of the library to be used. *LIBL specifies that the library l[...]

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 . . . . . . . . . . . *LIBL ___ Name, *LIBL Output 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. Sterling Connect:D irect for i5/OS routes two ty pes of messages during operati ons:  Sterling Connect:Direct messages that are routed to the St erling Co[...]

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. CDMSGID(msgid) specifies [...]

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. Connect:Direct Message ID . . . SCPA000I Ch[...]

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. i5/OS Compress/Decompress Examples i5[...]

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.D CDSND /QSYS Binary ASNDIFI1J ASNDIFI1J.D CDSND /QOpenSys ASNDIFI1K CDSND /root ASNDIFI1KB CDSND /root and block size specified ASNDIFI1L CDSND Binary to Text File ASNDIFN1A CDSND Integrated[...]

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 SPLF ARCVIFS1J CDSND Integrated File System /QOpenSYS to SPLF ARCVIFS1K CDSND Integrated File System /root to SPLF ARCVIFS1P CDSND Integrated File Syst[...]

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 Source to z/OS Physical Sequential CLP MSNDDBCS01 CDSND DBCS File MSNDIF01K CDSND from Integrated File System /root MSNDRCVPS3 CDSND/CDRCV with *EXT Com[...]

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 /QOpenSys NSNDIF01K CDSND Using Integrated File System /root NSNDIF01L CDSND Using Integrated F ile System /QDLS NSNDIF01M CDSND Using Integrated File[...]

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 CDSND of Save File USNDIF01A CDSND of Physical Source File Using In tegrated File System /QSYS USNDIF01H CDSND of Physical Data File Usin g Integrated Fil[...]

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. Consult your local IBM representa tive for information on the products and services currently avail[...]

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. This information could include technical inacc uracies or typographical errors. Change[...]

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. To illustra te them as completely as possible, the ex[...]

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. Cell Broadband Engine is a trademark of Son y Computer Entertainment, Inc.[...]

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. The adjacent node is also referred to as a remote node. Application Program Interface (API) The Application Program Interface (A PI) is a Sterling Connect:Direct c[...]

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. L Local Nod[...]

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. Pr[...]

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. Ever y Process has one PN ODE a[...]

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. The TIMER is always present when Sterling Connect:Direct is active.[...]

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 processes definition 123 submitting 124 B BLKSIZE 29, 81 CDSND command 29 CDSNDSPL command 8 1 block mode transfer CDRCV example 40, 41, 66 CDSND and CDR[...]

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 62 receiving files 67 REPLACE parameters 62 RMTWORK 62 SACCT 62 screens 67 SELECT 62 SNDFFD 50 SNODE 48 SNODEID 63 SNODENVIRN 48 TDISP 63 TDSN 50 TEXT[...]

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 36 TLABEL 36 TLINK 36 TOSYSOPT S 26, 80 TSPACE 38 TSQL 38 TTYPE 39 TUNIT 39 TVOL 39 TVOLREF 39 TVSAMCAT 39 XTRAN 25 XTRANLDATA 25 XTRANLSI 25 XTRANLSO[...]

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 asynchronous execution 127 CMD 125 example 124 format 124 functions 123 general description 124 HOLD 125 PRIORITY 125 RETAIN 125 screens 127 STARTT 125[...]

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 CDRUNTASK command 96 CDSND command 30 CDSNDSPL command 82 CDSUBMIT command 103 CTLCHAR parameter 83 CDSNDSPL command 83 described 83 D decompressing a fil[...]

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 FVSAMCAT, CDRCV command 61 H help option command level 17 parameter level 17 HOLD parameter 125 CDSUBPROC command 125 HOLDQ definition 129 I INFILE CDCOMP [...]

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 command 105 PRIORITY, CDSUBPROC command 125 PROCFILE, CDSUBMIT command 103 PSACCT, CDSUBMIT command 104, 105 PSNODE, CDSUBMIT command 105 PSNODEID, CDSU[...]

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 RCDTYPE parameter, CDSELSTAT command 137 receiving files CDRCV screen 67 described 45 using the CDRCV com mand 46 REPLACE param eter 32, 62, 119, 144 CDDECO[...]

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 statistics logging 8 selecting and printing 14 0 selecting, displaying, and printing 138 Statistics Manager (STATMGR) 8 Status messages routing to specific u[...]

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 command 128 change 131 delete 131 display 131 end 132 example 128 format 128 functions 123 hold 131 options 131 display 132 parameters 128 PNUM 129 PUSER [...]