IBM CDI5UG1107 - Manuals

About Sterling Connect:Direct for i5/OS 9 When the Sterling Connect:Direct/Manager receives a Process that requires PLEXCLASS=CLASS1 and determines that both Sterling Connect:Direct/Servers support CLASS1, it routes the Process to the Sterling Connect:Direct/Server with the lowest workload. For more...

10 IBM Sterling Connect:Direct for i5/OS User’s Guide 2. Press Enter . The Sterling Connect:Direct Main Menu displays the Sterling Connect:Direct for i5/OS functions that you can perform from this screen. Accessing the Administration Menu Option 20 on the Sterling Connect:Direct Main Menu provides a...

About Sterling Connect:Direct for i5/OS 11 The Connect:Direct Administration menu consists of two screens. Access 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...

Chapter 2 Using Control Language Sterling Connect:Direct for i5/OS uses Sterling Connect:Direct CL commands to perform Sterling Connect:Direct functions. Sterling Connect:Direct CL commands have the following general i5/OS CL command format: ™ Each command can have required and optional parameters a...

Using Control Language 15 Entering CL Commands You can type CL commands on an i5/OS node using any of the following methods: Embedding CL Commands You can embed CL commands in an application (user-written CL program), which allows you to combine functions supplied by Sterling Connect:Direct for i5/O...

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 the following command: Using CL Programming and Sterling Connect:Direct CL Commands An i5/O...

Using Control Language 17 Command Prompting for the Sterling Connect:Direct CL Commands Sterling Connect:Direct CL commands follow the format of the native i5/OS CL commands, which provide an extensive help facility describing their purpose, parameters, values, and any dependencies. In addition, you...

Chapter 3 Sending a File Sending a file on Sterling Connect:Direct for i5/OS requires the Sterling Connect:Direct Send (CDSND) command. Understanding the Sterling Connect:Direct for i5/OS file systems, the CDSND command parameters, block mode transfer, and the CDSND screens enables you to use this c...

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 must specify ...

Sending a File 21 CDSND Command Format The following table shows the parameters for the CDSND command. Required 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|*...

22 IBM Sterling Connect:Direct for i5/OS User’s Guide Required Parameters Unless otherwise noted, these required parameters apply to all remote node environments. SNODE(remote-node-name) specifies a 1–16 character alphanumeric name for the receiving node (remote node). The node name must be defined ...

26 IBM Sterling Connect:Direct for i5/OS User’s Guide DBCS indicates that the data is pure DBCS characters and that no SO/SI characters are used. The following rules apply to the use of the XTRAN keyword: ™ You must specify the XTRAN keyword to use extended translation; all other keywords are option...

Sending a File 29 COPIES(number-of-copies) specifies the number of copies to be printed. Valid values 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–500000...

30 IBM Sterling Connect:Direct for i5/OS User’s Guide CLASS(n) determines the node-to-node session on which an operation can execute. The CLASS is a number in the range of 1–255. If you do not specify the CLASS parameter, it defaults to the number of maximum sessions defined in the mode description ...

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 associated with a Sterling Connect:Direct/Server in a Sterling Connect:Direct/Plex environment. This represents a type of server on which you want to r...

Sending a File 37 When used with the FROM parameter, 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 multiple access; alternate re...

Sending a File 39 TTYPE(entry-name) specifies the entry name of the type defaults file on the remote node that contains the default file attributes used to allocate the destination file. TUNIT(file-address) specifies the unit address, device type, or user-assigned group name where the file resides o...

40 IBM Sterling Connect:Direct for i5/OS User’s Guide Sterling Connect:Direct for i5/OS simulates block reads and writes. Using logical blocks instead of physical blocks, it allows you to modify the blocksize to match the other node in some cases. Sterling Connect:Direct for i5/OS supports block mod...

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 calculates the simulated blocksize at 3200 because the destination file is new and the source ...

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 following steps to send a file to a remote node. 1. Access the CDSND screens by typing CDSND at...

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:Direct for i5/OS requires the Sterling Connect:Direct Receive (CDRCV) command. Understanding the Sterling Connect:Direct for i5/OS file systems, the CDRCV command parameters, and the CDRCV screens enables you to use this command more ef...

46 IBM Sterling Connect:Direct for i5/OS User’s Guide The Sterling Connect:Direct for i5/OS integrated file system provides application and data compatibility with other platforms. The integrated file system consists of five file system types: ™ /QLANSrv is a LAN server file system ™ /QDLS is a docu...

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-data-set-name) TDSN(to data-set-name) FMSYSOPTS (‘ PRECMPR(*YES|*NO)CODEP...

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 define the data structure to be created as one of the following: FILE specifies that the file being created is a physical database file. MBR specifies that the m...

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 ...

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 characters long. The first character must be alphabetic. The default name is CDRCV. PNODEID(id, pswd, newpswd) specifies security user IDs and ...

66 IBM Sterling Connect:Direct for i5/OS User’s Guide As the remote node, Sterling Connect: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 ™ Calculat...

Receiving a File 67 ™ Because the file attributes match, the block mode transfer occurs. CDSND Examples-Setting Actual Blocksize In the fourth example, the following events occur: ™ the remote node sets the destination file blocksize to 3200, the actual blocksize of the destination file. ™ Sterling ...

Chapter 5 Sending a Spool File This chapter describes the Sterling Connect:Direct Send Spool (CDSNDSPL) command and its function. 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 ...

82 IBM Sterling Connect:Direct for i5/OS User’s Guide COMPRESS (*YES|*NO|X\xx\|C\cc|EXT) specifies data compression, which reduces the amount of data transmitted as the file is copied from one node to another. The file is automatically decompressed at its destination. If compression is specified, St...

Sending a Spool File 83 This data can be scanned for string matches. The extended compression window size affects how much virtual memory the extended compression routines use. Higher window size values use more memory but achieve greater compression. The valid values for this subparameter are 8–15,...

Sending a Spool File 91 Sending a Spooled File to a Remote Node Use the Sterling Connect:Direct Send Spool (CDSNDSPL) screens to send a spooled file to a remote node. Complete the following steps to send a spooled file to a remote node: 1. Access the CDSNDSPL screens by typing CDSNDSPL at the comman...

Chapter 6 Running a Remote Task This chapter describes the Sterling Connect:Direct Run Task (CDRUNTASK) command and its function. 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 ...

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 parameters are in bold. ===> CDRUNTASK SNODE(CDDV3600) SNODENVIRN(AS400) CMD('WRKACTJOB SBS(CDDV3600) ...

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 tr...

Running a Remote Task 99 The following figure shows a sample of the first screen in the Sterling Connect:Direct Run Task (CDRUNTASK) screen flow for a Sterling Connect:Direct for i5/OS remote environment. Additional screens vary according to the remote node environment. Connect:Direct Run Task (CDRU...

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 Com...

Submitting a Sterling Connect:Direct Process on a Remote 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 Connect:Direct Process to be submitted. This file must already exist on...

Submitting a Sterling Connect:Direct Process on a Remote 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 d...

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 . . . . . . . ...

Chapter 8 Submitting a Job on a Remote Node This chapter describes the Sterling Connect:Direct Run Job (CDRUNJOB) command and its function. This chapter also shows sample CDRUNJOB screens and describes the required and optional CL parameters for the CDRUNJOB command. Using the CDRUNJOB Command Use t...

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 Parameters The following parameters are required. Unless otherwise noted, the parameters apply to all remote node enviro...

Submitting a Job on a Remote Node 111 Optional Parameters The following parameters, listed alphabetically, are optional. Unless otherwise noted, the parameters apply to all remote node environments. BATCHID(idname) specifies the VM remote Virtual Machine ID name. The valid range is 1–8 characters. C...

Submitting a Job on a Remote Node 113 newpswd specifies the new security password and is used by the security system to change the current security password to the new security password (1–64 alphanumeric characters). TRACEOPT Trace Instructions (L, S, F, C, X, K, D, H, V, W, P,|*NONE|*ALL|*EXT| *CO...

114 IBM Sterling Connect:Direct for i5/OS User’s Guide ™ *EXT enables all product traces plus two other traces. (TRCICF and TRCJOB) ™ *COMMON enables the most commonly used traces. (L, S, F, C, and H) ™ *NONE turns off all traces. TSYSOPTS(remote-job-command) specifies system-specific submission inf...

Chapter 9 Compressing Files This chapter describes the Sterling Connect:Direct Compress (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 th...

118 IBM Sterling Connect:Direct for i5/OS User’s Guide CDCOMP Command Format The following table shows the format for the CDCOMP command. Required Parameters The CDCOMP command has the following required parameters. INFILE (library-name/file-name) specifies the name and library of the file to be com...

120 IBM Sterling Connect:Direct for i5/OS User’s Guide start-mbr specifies the name of the member to be compressed 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...

Chapter 10 Controlling Processes Sterling Connect:Direct for i5/OS implements a Sterling Connect:Direct Process Management Queue. You can use two commands to schedule, control, and monitor any active or queued Processes: ™ CDSUBPROC command allows you to: Š Submit Sterling Connect:Direct Processes f...

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 St...

Controlling Processes 125 Required Parameter 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 Sterling Connect:Direct for i5/OS command with any required parameters and subparamete...

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: *NONE, *DAY, or *WEEK. If you enter *NONE, the Process is run only once automatically. *DAY indicates that the Process i...

Controlling Processes 127 ™ *ALL enables all product traces.(L, S, F, C, X, K, D, H, V, and P) ™ *EXT enables all product traces plus 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 U...

128 IBM Sterling Connect:Direct for i5/OS User’s Guide Working with Sterling Connect:Direct Processes Use the WRKCDPROC command to schedule, monitor, and control the Processes. The following options are available: Selecting Specific Processes Selection options allow you to specify the Processes with...

130 IBM Sterling Connect:Direct for i5/OS User’s Guide Using the WRKCDPROC Screens Use the Work with Connect:Direct Process (WRKCDPROC) screen to monitor and control Processes in the subsystem. Monitoring and Controlling Processes Complete the following steps to monitor or control a Process: 1. Acce...

Controlling Processes 131 Press F11 to display View 2, which provides additional information about Processes 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 ...

132 IBM Sterling Connect:Direct for i5/OS User’s Guide The following is an example of the Display C:D Process screen. Releasing a Process in the HOLD Queue Release (Option 6) permits you to release a Process in the HOLD queue and move it to the WAIT queue. There it is available for execution. No add...

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 Cha...

Chapter 11 Using Sterling Connect:Direct Statistics Sterling Connect:Direct for i5/OS logs statistics information for all Processes. Each component of Sterling Connect:Direct for i5/OS generates statistics data to the statistics manager (STATMGR) job. The long-running STATMGR job formats the statist...

136 IBM Sterling Connect:Direct for i5/OS User’s Guide Required Parameters The CDSELSTAT command has no required parameters. Optional Parameters The following parameters are optional for the CDSELSTAT command. FILE(filename|*ACTIVE) allows you to specify the statistics database file to search. filen...

Using Sterling Connect:Direct Statistics 137 start-date and end-date indicate the records being selected by date criteria for statistics selection. Both start-date and end-date accept one of the following formats: mmddyy, mm/dd/yy, mm.dd.yy. Input dates are interpreted according to the date format o...

138 IBM Sterling Connect:Direct for i5/OS User’s Guide Selecting and Displaying Summary Statistics Complete the following steps to select and display summary statistics: 1. Access the CDSELSTAT screens by typing CDSELSTAT at the command line and pressing F4 or by choosing the select statistics optio...

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 typing CDSELSTAT at the command line and pressing F4 or by selecting the select statistics option fro...

Using Sterling Connect:Direct Statistics 141 3. To display the list of spooled files in the output queue, at the command line, type WRKOUTQ cdlib/CDOUT where cdlib is the name of your Sterling Connect:Direct library. 4. In the Opt column, type 5 next to the CDSELSTAT spooled file and press Enter to ...

Chapter 12 Decompressing Files This chapter describes the Sterling Connect:Direct decompress (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 nod...

144 IBM Sterling Connect:Direct for i5/OS User’s Guide Required Parameters The CDDECOMP command has two required parameters. 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 ...

Chapter 13 Displaying Sterling Connect:Direct Message Descriptions Sterling Connect:Direct for i5/OS generates messages that detail aspects of the Sterling Connect:Direct for i5/OS operation. Sterling Connect:Direct for i5/OS routes two types of messages during operations: ™ Sterling Connect:Direct ...

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 o...

Displaying Sterling Connect:Direct Message Descriptions 149 The following screen is an example of the screen associated with the DSPCDMSGD command. Sample Message Description The following figure shows a sample message description. Display Connect:Direct Message (DSPCDMSGD) Type choices, press Enter...

Appendix A CL Program Examples The tables provide examples of i5/OS CL Programs using features of Sterling Connect: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 the WRKMBRPDM command to browse the...

152 IBM Sterling Connect:Direct for i5/OS User’s Guide i5/OS Run Task Example i5/OS Send Example Using Send File Field Description i5/OS Send and Receive Examples Using Native File System Member Name Description ARNJDS01 CDRUNTASK Example Member Name Description ASNDCF1A CDSND Using SNDFFD Parameter...

CL Program Examples 153 i5/OS Send and Receive Examples Using Integrated File System Member Name Description ASNDIFI1A CDSND /QSYS Text ASNDIFI1BASNDIFI1B.D CDSND /QSYS Binary ASNDIFI1JASNDIFI1J.D CDSND /QOpenSys ASNDIFI1K CDSND /root ASNDIFI1KB CDSND /root and block size specified ASNDIFI1L CDSND B...

CL Program Examples 155 i5/OS–NT Send and 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 Syste...

156 IBM Sterling Connect:Direct for i5/OS User’s Guide i5/OS–Microsoft Windows Run Job and Run Task Examples i5/OS–UNIX Send and Receive Examples NSNDIF01J CDSND Using Integrated File System /QOpenSys NSNDIF01K CDSND Using Integrated File System /root NSNDIF01L CDSND Using Integrated File System /QD...

CL Program Examples 157 i5/OS–UNIX Run Task and Run Job Examples i5/OS–UTIL Test Examples USNDCF01H CDSND of Physical Data Text File USNDCF01I CDSND of Physical Data Binary File USNDCF01S CDSND of Save File USNDIF01A CDSND of Physical Source File Using Integrated File System /QSYS USNDIF01H CDSND of...

Notices 160 IBM Sterling Connect:Direct for i5/OS User’s Guide MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you. This information could include technical i...

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 available. This information contains examples of data and reports used in daily business operations. To illu...

Glossary A Adjacent Node An adjacent node is an entry in the Network Map that defines a Sterling Connect:Direct node with which the 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 ...

166 IBM Sterling Connect:Direct for i5/OS User’s Guide S Secondary Node (SNODE) The remote or secondary node (SNODE) is the Sterling Connect:Direct node that interacts with the primary node (PNODE) during Process execution. SNODE may also be referred to as the participating (non-controlling) or part...

Index A ACTIVQ definition 129 Administration 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 81 block mode t...