IBM Sterling Connect:Direct for i5/OS User’s Guide Version 3.
Copyright This edition applies to the 3.7 Version of IBM Sterling Connect:Direct for i5/OS and to all subsequent releases and modifications until otherwise indicated in new editions. Before using this information and the product it supports, read the information in Notices on page 159. Licensed Materials - Property of IBM IBM Sterling Connect:Direct for i5/OS © Copyright IBM Corp. 1999, 2011. All Rights Reserved.
Contents Chapter 1 About Sterling Connect:Direct for i5/OS Issuing Sterling Connect:Direct CL Commands ........................................................... Issuing CL Commands Through the Main Menu .......................................................... Accessing the Administration Menu.............................................................................. Chapter 2 Using Control Language Embedding CL Commands..............................................................................
IBM Sterling Connect:Direct for i5/OS User’s Guide CDRCV Command Format............................................................................................ Required Parameters ............................................................................................... Optional Parameters................................................................................................ Simulating Blocksizes...........................................................................................
Chapter 10 Controlling Processes CDSUBPROC Command Example............................................................................... CDSUBPROC Command Format ................................................................................. Required Parameter ................................................................................................ Optional Parameters ...............................................................................................
IBM Sterling Connect:Direct for i5/OS User’s Guide i5/OS Send and Receive Examples Using Native File System...................................... i5/OS Send and Receive Examples Using Integrated File System ................................ i5/OS–z/OS Send and Receive Examples ..................................................................... i5/OS–NT Send and Receive Examples.........................................................................
Chapter 1 About Sterling Connect:Direct for i5/OS IBM® Sterling Connect:Direct® for i5/OS® is an enterprise solution for secure, automated file delivery between business applications. Its session management and extended recovery features help assure data delivery in support of 24 hours a day, 7 days a week business operations. It links technologies, moves all types of information, and manages high-performance transfers by providing easy-to-use automation, checkpoint/restart, and error recovery.
IBM Sterling Connect:Direct for i5/OS User’s Guide Queue Manager (QMGR) The QMGR manages the Sterling Connect:Direct Process queue. The QMGR is always active when Sterling Connect:Direct for i5/OS is active. Timer (TIMER) The TIMER component provides timer services to the session manager, the process queue manager, and other Sterling Connect:Direct for i5/OS components. The TIMER runs as a separate i5/OS job, submitted and controlled by the Process Manager component.
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 information on the PLEXCLASS parameter, see the CL command to execute in the IBM Sterling Connect:Direct for z/OS environment in the IBM Sterling Connect:Direct for i5/OS User’s Guide.
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. CMDCD Connect:Direct (tm) System: FRAN Select one of the following: 1. 2. 3. 4. 5. 6. 7. 8. 9. 10.
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 statistics 22. Archive Connect:Direct stat member 23. Create Connect:Direct stat member 24. Delete Connect:Direct stat member 25. Restore Connect:Direct stat member 26.
IBM Sterling Connect:Direct for i5/OS User’s Guide
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 and subparameters that provide additional information needed to run the command. Subparameters are always positional. Each parameter provides a specific type of information or instruction.
IBM Sterling Connect:Direct for i5/OS User’s Guide Command Function 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. CDRUNJOB Submit a job in batch mode on a remote node. CDRUNTASK Execute a Sterling Connect:Direct Run Task function on a remote node.
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/OS with i5/OS CL commands within a user-written application.
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: DSPCDMSGD Note: The &MSGID and &MSGDATA variables must be defined in the CL program. Specify the &MSGID character length as 7 characters and &MSGDATA as 8 characters to capture the error message.
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 can use the prompt/help feature to select and type commands and appropriate parameters. Prompt/help is offered at the command level and at the parameter level.
IBM Sterling Connect:Direct for i5/OS User’s Guide
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 command more effectively. Using the File Systems Sterling Connect:Direct for i5/OS supports two types of file systems to perform file transfers: native file and integrated file.
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 the fully qualified path name to transfer a file. Sterling Connect:Direct for i5/OS identifies a path that starts with a slash (/) or a backslash (\) as a request for the integrated file system.
Sending a File 21 CDSND Command Format The following table shows the parameters for the CDSND command. Required parameters are in bold.
IBM Sterling Connect:Direct for i5/OS User’s Guide Command Parameters RMTWORK(*NO|*YES) SACCT(accounting-data) †SECOPTIONS(* *) SELECT(member,new-name,R|NR,‘list’) SNODEID(id, pswd, newpswd) TBUFND(n) TDBPARMS(dbid, dbsubid) TDCB(modeldcb, blksize, den, dsorg, keylen, limct, lrecl, optcd, recfm, rkp, trtch) TDISP(current, normal end, abnormal end) TIOEXIT(program-name) TIOPARM(parameter-names) TLABEL(seqno,labeltype,pswdread,inout,retpd|expdt) TLINK(vmuserid,pwd,accmode,cuu) TMSVGP(data-definition nam
Sending a File 23 SNODENVIRN(remote-environment-name) specifies the 1–10 character alphanumeric name for the receiving node environment: OS400, OS390, MVS, MSP, OPENVMS, TANDEM, UNIX, VM, VOS, VSE, Microsoft Windows, or Microsoft Windows_NT. FDSN(‘from data-set-name’) specifies the file to be sent to the remote node. The file name can be up to 256 characters long. File names are verified based on the i5/OS standard file name conventions.The entire data set name must be in single quotes.
IBM Sterling Connect:Direct for i5/OS User’s Guide SNODENVIRN TDSN Format Special Considerations Integrated File System ‘/QSYS.LIB/library-name.LIB /file-name.FILE /member-name.MBR’ or ‘/directory/file-name| /QLANSrv/file-name| /QDLS/folder-name| /QOpenSys/file-name’ You cannot specify the *SNDFFD, *SELECT, and *EXCLUDE parameters with the integrated file system. Spool File Support Do not use member names longer than eight characters when sending to z/OS, VSE, and MSP.
Sending a File 25 EXITCMD(valid i5/OS command) specifies a command to execute only 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 determine whether a file is sent with the file field descriptions. If the bytes required value is greater than 12K, you cannot transfer the file field descriptions.
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 optional. The default for local shift-out is the IBM standard x0E. The default for local shift-in is the IBM standard x0F. The default local data format is MIXED with SO/SI in use.
Sending a File 27 CCSID(nnnnn) specifies the coded character set ID to use when creating IFS files. If no character set ID is specified, the system default is used. EORCHAR(xxxx) specifies the two-to four-digit hexadecimal symbol to identify the character to use in text files as the end-of-record character, for example, EORCHAR(0A). CODEPAGE(nnnnn,nnnnn) converts data from one code page to another.
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 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-width) specifies the length and width of the page used by the printer. This parameter overrides the FORMTYPE parameter. LPI(3|4|6|7.
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. This parameter is valid only when SPOOL(*YES). FILESEP(number-of-file-separators) specifies the number of blank separator pages to be placed between each copy of the file printed.
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 for the communications environment. Note: The CLASS parameter is not used by Sterling Connect:Direct for i5/OS.
Sending a File 31 ECWINSIZE specifies the extended compression window size, which is specifically for the history buffer that is filled from the user’s input buffer (both compressing and decompressing). The window specifies the amount of storage designated to maintain data previously read. This data can be scanned for string matches. The extended compression window size affects how much virtual memory the extended compression routines use.
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 run a task, for example TAPE. Note: This parameter is for use only in Sterling Connect:Direct for i5/OS environments. PNAME(process-name) identifies the Process in any messages or statistics.
Sending a File 33 Digital Signature specifies if a digital signature is created while a file is being transmitted. Note: The SECOPTIONS parameter is valid only if the Sterling Connect:Direct Secure Plus is installed. For information about these parameters, refer to the IBM Sterling Connect:Direct Secure Plus Implementation Guide. SELECT(member, new-name, R/NR, ‘list’) specifies selection criteria by which file members are to be copied.
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 alphanumeric characters). This is optional unless you have security set to require a password. 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).
Sending a File 35 optcd specifies optional processing associated with this file. This specification only applies to this file and is not automatically applied to the other files involved in the RECEIVE operation. Valid options are: W performs write validity checks on direct access storage devices. Q performs ASCII-to-EBCDIC conversion for input files and EBCDIC-to-ASCII conversion for output files. Q is the default and only used for AL-labeled tape files. Z performs reduced error recovery for tape files.
IBM Sterling Connect:Direct for i5/OS User’s Guide MOD indicates that the operation modifies the member 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 file or member is replaced. The file is created if it does not exist. SHR indicates that another operation can read the file simultaneously. The file is created if it does not exist on i5/OS.
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 read only access), and MW (primary multiple access; alternate read/write only access). When used with the TO parameter, the access modes are W, M, and MW.
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 two other traces. (TRCICF and TRCJOB) *COMMON enables the most commonly used traces. (L, S, F, C, and H) *NONE turns off all 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 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 or will reside. For SAM-to-SAM copies where the destination file is new and the UNIT parameter is not coded, the device type from the source file is used.
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.
Sending a File 41 Because the blocksizes match, the block mode copy occurs. C:D i5: request: srce file: dest file: receiving source blksize=not specified; dest blksize = 3200 lrecl=80, (on another C:D i5 3.3 node) NEW 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 file specifies a blocksize.
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 the command line and pressing F4 or by choosing the send file option from the Sterling Connect:Direct menu. 2. Type in the remote node name at the screen prompt and press Enter.
Sending a File 43 Connect:Direct Send File Screen 2 Connect:Direct Send File (CDSND) Type choices, press Enter. Receiving System Operations . .
IBM Sterling Connect:Direct for i5/OS User’s Guide Connect:Direct Send File Screen 4 Connect:Direct Send File (CDSND) Type choices, press Enter. File Members Selection List . . __________________________________________________ ____________________________________________________________________________________ ____________________________________________________________________________________ ____________________________________________________ File Members Exclusion 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 effectively.
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 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.
IBM Sterling Connect:Direct for i5/OS User’s Guide Command Parameter FLABEL(seqno,labeltype,pswdread,inout,retpd|expdt) FLINK(vmuserid,pwd,accmode,ccuu) FMSVGP(data-set-name) FPDSDIR(*YES|*NO) FSQL(sql-statement|DSN=data-set-name) FTYPE(entry-name) FUNIT(unit-name) FVOL(private, volcount, ser) FVOLREF(data-set-name) FVSAMCAT(dsn,vmid,pwd,accmode,cuu) NOTIFY(userid) PLEXCLASS(user-defined class) PNAME(process-name) PNODEID(id, pswd, newpswd) REPLACE(*YES|*NO) RMTWORK(*YES|*NO) SACCT(snode-accounting-da
Receiving a File 49 FDSN(‘from remote-data-set-name’) specifies the source file name. File names are verified based on the i5/OS standard file name conventions. The length of the input field displayed 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 in the first two positions of the field. Sterling Connect:Direct for i5/OS provides two systems for handling the files: Native File System and Integrated File System.
IBM Sterling Connect:Direct for i5/OS User’s Guide TDSN(‘to data-set-name’) specifies the local file name. File names are verified based on the i5/OS standard file name conventions. The length of the input field displayed 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 in the first two positions of the field. Sterling Connect:Direct for i5/OS supports two file systems: native and integrated.
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 data 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 copied is a physical database file. MBR specifies that the member being copied is a member of a physical database file. OBJ specifies that the data to be copied is in save file format.
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 member being created is a member of a physical database file. OBJ specifies that the file being created is in save file format. SPLF specifies that the data is copied to an i5/OS spooled output 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. PAGESIZE(page-length page-width) specifies the length and width of the page used by the printer. This parameter overrides the FORMTYPE parameter. LPI(3|4|6|7.
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) specifies whether the file is to be held on the output queue until released by the user.
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 the IBM Sterling Connect:Direct Processes Web site at http://www.sterlingcommerce.com/documentation/processes/processhome.html for platform-specific SYSOPTS parameters.
IBM Sterling Connect:Direct for i5/OS User’s Guide COMPRESS(*NO | *YES| *EXT | X\xx\ | C\cc\ ) specifies that the data is to be compressed, 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 unless DECOMP(*NO) is specified in TOSYSOPTS. Note: Compression is CPU-intensive. Its effectiveness is dependent on the data and line speed and should be used only if it benefits the installation.
Receiving a File 57 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, inclusive. The default value is *INITPARMS.
IBM Sterling Connect:Direct for i5/OS User’s Guide den specifies the magnetic tape mode setting. The 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. DEN 7-Track Tape 9-Track Tape 1 556 bpi -- 2 800 bpi 800 bpi 3 -- 1600 bpi 4 -- 6250 bpi dsorg specifies the file organization.
Receiving a File 59 trtch specifies the magnetic tape mode setting. When coded together, Sterling 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 translation. E specifies no data conversion, even parity, and no translation. T specifies no data conversion, odd parity, and BCD or EBCDIC translation. ET specifies no data conversion, even parity, and BCD or EBCDIC translation.
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 supplied by the operator or user before the file can be accessed. inout specifies that a BSAM data set opened for INOUT or a BDAM data set opened for UPDAT is to be read only.
Receiving a File 61 FUNIT(name) specifies the unit address, device type, or user-assigned group name where the file resides or will reside. For SAM-to-SAM copies where the destination 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.
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. Note: Only Sterling Connect:Direct for i5/OS and Sterling Connect:Direct for UNIX support Process names with more than 8 characters. 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 copied. Member selections are: * represents a global generic. A global generic indicates that all members of the file are to be included. generic specifies a generic member name. For example, if you specify CD*, all member names beginning with CD are selected for copying. member-name specifies an individual member name. start-range/stop-range specifies first and last names in an alphanumeric range of members.
IBM Sterling Connect:Direct for i5/OS User’s Guide current specifies the status of the file before the operation executes. Valid values for this subparameter are: NEW specifies that the operation creates the destination file or member. If you are creating a member, the file can already exist but the member must not already exist. If you are creating a file (SAVF), the file must not already exist. OLD specifies that the destination file or member already exists.
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, and P) *EXT enables all product traces plus two other traces. (TRCICF and TRCJOB) *COMMON enables the most commonly used traces.
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 Calculated value* *Largest multiple of record size less than some arbitrary value, such as 4096.
Receiving a File 67 Because the file attributes match, the block mode transfer occurs. C:D i5: sending request: source blksize=6400; srce file: lrecl=80 dest file: NEW (on z/OS) dest blksize = not specified; 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 Connect:Direct for i5/OS calculates the simulated blocksize at 3200.
IBM Sterling Connect:Direct for i5/OS User’s Guide The following are samples of the screens in the Sterling Connect:Direct Receive File (CDRCV) screen flow. The sample shows the keyword display option. Connect:Direct Receive File (CDRCV) Screen 1 Connect:Direct Receive File (CDRCV) Type choices, press Enter. Sending Node Name . . . . . . . Sending Node Environment . . . . Sending File Name . . . . . . . Receiving File Name OS/400, AS400, MSP, MVS... . . . . . . Receiving System Operations . .
Receiving a File 69 Connect:Direct Receive File (CDRCV) Screen 2 Connect:Direct Receive File (CDRCV) Type choices, press Enter. Sending System Operations .’TYPE(FILE)' . . . . ... Trace Options: Trace Instructions . . . Command trace options . Process Name . . . . . . . Receiving Node User Info.: User Id . . . . . . . . Password . . . . . . . . New Password . . . . . . User to Notify . . . . . . F3=Exit F4=Prompt F24=More keys . . . . . . . . . *CURRENT *NONE CDRCV . . . . *CURRENT . . . . . . . .
IBM Sterling Connect:Direct for i5/OS User’s Guide Connect:Direct Receive File (CDRCV) Screen 4 Connect:Direct Receive File (CDRCV) Type choices, press Enter. File Members Selection List . .____________________________________________________ ____________________________________________________________________________________ ____________________________________________________________________________________ ____________________________________________________ File Members Exclusion 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 . . __ 1, 2, 3, 4 Organization of File . . . . . _ BDAM, ISAM, PO, PS, VSAM... Key Length of file . . . . . . 000 Character value Searching Free Block/Space . .
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 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 a spool file on the local i5/OS node to a remote node. You can also send spool files to a remote printer through the Sterling Connect:Direct for i5/OS Spool Monitor.
IBM Sterling Connect:Direct for i5/OS User’s Guide Command Parameters JOB(*|job-name user-name job-number) SPLFNUM(n|*ONLY|*LAST) TDSN(spooled-file-name|data-set-name) 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-code)|XTRANLSI(si-code)|XTRANLDATA(MIXED|DBCS)XT RANPAD(pc)] CCSID(nnnnn) EORCHAR(xxxx) ’) Note: TOSYSOPTS is required if remote node is on i5/OS BLKSIZE(n|*CALC) CHLVAL(*NOR
Sending a Spool File Command 75 Parameters TIOPARM(parameter-name) TLABEL(seqno,labeltype,pswdread,inout,retpd,expdt) TLINK(vmid,pwd,accmode,cuu) TMSVGP(data-definition-name) (For z/OS nodes only) TPROTCT(*YES|*NO) TRACEOPT Trace Instructions: (L,S,F,C,X,K,D,H,V,W,P|*NONE|*ALL|*EXT| *COMMON|*INITPARMS|*CURRENT Command Trace Options: L,S,F,C,X,K,D,H,V,P|*ALL|*EXT|*COMMON| *NONE) TSPACE(avgblk,type,primary,secondary,pdsblk,rise, contig,round) (For z/OS nodes only) TSQL(sql-statement|DSN=data-set-name) (For
IBM Sterling Connect:Direct for i5/OS User’s Guide SPLFNUM(n|*ONLY|*LAST) specifies the spooled output file number from the job whose data records are to be sent. Valid values are: 1–9999 indicates to copy the specified spooled output file number. *ONLY indicates that only one of the job’s spooled output files has the specified file name. *LAST indicates to copy the highest-numbered spooled output file with the specified job name. TDSN(spooled-file-name|data-set-name) specifies the remote file name.
Sending a Spool File SNODENVIRN 77 TDSN Format Spool File Support spooled-file-name Special Considerations Do not use member names longer than eight characters when sending to z/OS, VSE, and MSP. Results are unpredictable. OS/390, VSE, MSP Standard z/OS DSN naming conventions. Single quotes allow special characters. Do not use member names longer than eight characters. The results are unpredictable. VM Fully qualified file-name Tandem \system.$volume.subvolume.
IBM Sterling Connect:Direct for i5/OS User’s Guide without decompressing it. The option DECMPR(*NO) cannot be specified if you are using Sterling Connect:Direct Secure Plus to perform a secured copy function. Note: Ensure that the destination file contains no members before you send a file with DECMPR(*NO) specified. TYPE(FILE|MBR|SPLF) specifies the type of data to be sent.
Sending a Spool File 79 CTLCHAR(*NONE|*FCFC) specifies whether the data contains printer control characters. CHLVAL(*NORMAL| (channel#1 line#1) ... (channel#12 line#12)) specifies the list of channel numbers with their assigned line numbers. Note that CTLCHAR(*FCFC) must be specified as a SYSOPTS parameter for this to be a valid parameter. FORMFEED(*DEVD|*CONT|*CUT|*AUTOCUT) specifies the form feed attachments used by the printer (4214, 5219, and 5553 printers only).
IBM Sterling Connect:Direct for i5/OS User’s Guide If the XTRAN keyword is present, then the following related optional keywords can also be used: XTRANLSO(so-code) specifies extended translation local shift-out code. This keyword specifies the hexadecimal code to use for the local (i5/OS side) shift-out character and overrides the default value of 0E. You can specify any two valid hexadecimal digits. XTRANLSI(si-code) specifies extended translation local shift-in code.
Sending a Spool File 81 Database for iSeries SQL Reference, 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 page is locale, the code page for the locale where Sterling Connect:Direct is executing is used.
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. Note: Compression is CPU-intensive. Its effectiveness is dependent on data and line speed and should be used only if it benefits the installation.
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, inclusive. The default value is *INITPARMS.
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 different 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 and remote nodes. id specifies the security ID passed to the security system on the local node (1–10 alphanumeric characters).
Sending a Spool File 85 id specifies the security ID sent to the remote node (1–64 alphanumeric characters). pswd specifies the current security password and is used by the security system on the SNODE to validate the current security password (1–64 alphanumeric characters). This is optional unless the user has security set to require a password.
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 associated with a specific file. This optional processing only applies to this file and is not automatically applied to other files involved in a RECEIVE operation. Valid options are: W performs write validity checks on direct access storage devices.
Sending a Spool File 87 NEW specifies that the operation creates the destination member for an existing file. NEW is the default. The file is created if the member does not exist. The file cannot be created if the member already exists. OLD specifies that the destination member already exists. The operation has exclusive control of the member. MOD specifies that the operation modifies the member by adding data to the end of the member or, if none exists, allocates a new member.
IBM Sterling Connect:Direct for i5/OS User’s Guide TLINK(vmid,pwd,accmode,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 owner ID for the CMS minidisk where the file is located. The valid length ranges from 1–8 characters. pwd specifies the appropriate password for the CMS minidisk where the file is located. The maximum length is 256 characters.
Sending a Spool File 89 *INITPARMS indicates the traces specified in the initialization parameters. *CURRENT selects the trace bits that the session 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 Process it runs. The following are valid options: L enables the main line logic trace for all components. S enables the Process step logic trace.
IBM Sterling Connect:Direct for i5/OS User’s Guide TSQL(sql-statement|DSN=data-set-name) defines the SQL statement to be processed against 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 z/OS nodes only. sql-statement defines the actual SQL statement to be processed.
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 command line and pressing F4 or by choosing the send spooled file option from the Sterling Connect:Direct main menu. 2. Type the remote node name and press Enter.
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 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 under the remote Sterling Connect:Direct during command execution. For additional information, refer to the appropriate RUN TASK section of the IBM Sterling Connect:Direct Processes Web site at http://www.
IBM Sterling Connect:Direct for i5/OS User’s Guide CDRUNTASK Example With New TraceOpt Parameters ===> CDRUNTASK SNODE(CDDV3600) SNODENVIRN(AS400) CMD('WRKACTJOB SBS(CDDV3600) OUTPUT(*PRINT)') TRACEOPT(*ALL *ALL) SNODEID(RMTUSER ()) The associated Statistics record: Display Spooled File File . . . . . : CDSELSTAT Page/Line 1/6 Control . . . . . Columns 1 - 130 Find . . . . . . *...+....1....+....2....+....3....+....4....+....5....+....6....+....7....
Running a Remote Task Command 95 Parameters PLEXCLASS(user-defined class) PNAME(name) PNODEID(id, pswd, newpswd) RMTWORK(*YES|*NO) SACCT(snode-accounting-data) SNODEID(id, pswd, newpswd) TRACEOPT Trace Instructions: (L,S,F,C,X,K,D,H,V,W,P|*NONE|*ALL|*EXT| *COMMON|*INITPARMS|*CURRENT Command Trace Options: L,S,F,C,X,K,D,H,V,P|*ALL|*EXT|*COMMON| *NONE) † ‡ ‡‡ For tasks on z/OS, Microsoft Windows, HP NonStop, VM, and VSE For tasks on i5/OS, Microsoft Windows, OpenVMS, UNIX, Stratus VOS For tasks on z/OS,
IBM Sterling Connect:Direct for i5/OS User’s Guide Optional Parameters The following parameters are optional. Unless otherwise noted, the parameters apply to all remote node environments. CLASS(n) determines the node-to-node session on which a Sterling Connect:Direct operation can execute. The CLASS is a number from 1–255. If you do not specify the CLASS parameter, it defaults to the maximum number of sessions defined in the mode description for the communications environment.
Running a Remote Task 97 pswd specifies the current security password for the specified ID. The security system at the local node can use this parameter to validate the current security password (1–10 alphanumeric characters). This is optional unless the user has security set to require a password. newpswd specifies the new security password. The security system can use this parameter to change the current security password to the new security password (1–10 alphanumeric characters).
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 two system traces (TRCICF and TRCJOB). *COMMON enables the communications traces. (L, S, F, C, and H) *INITPARMS indicates the traces specified in the initialization parameters.
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. Connect:Direct Run Task (CDRUNTASK) Type choices, press Enter. Remote Node Name . . . . . . . . > DALLAS____________ Remote Environment . . . . . . . > OS/400____ AS400, MVS, OS390, OS/400... Remote Task Command . . . . . .
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 Connect:Direct Process on a remote node.
IBM Sterling Connect:Direct for i5/OS User’s Guide Command Parameters PROCFILE(file-name) CLASS(n|*MODED) CRC(*INITPARMS|*NETMAP|*OFF|*ON) †NEWNAME(file-name|*NONE) NOTIFY(*CURRENT|*NONE|userid) †PCLASS(n) †PHOLD(*YES|*NO|*CALL) PLEXCLASS(user-defined class) PNAME(process-name) PNODEID(id,pswd,newpswd) †PNOTIFY(userid) †PPACCT(PNODE accounting-data) †PPNODEID(id,pswd,newpswd) †PPRTY(n) †PREQUEUE(*YES|*NO) †PRETAIN(*YES|*NO|*INITIAL) †PSACCT(SNODE accounting-data) †PSNODE(secondary-node-name) †PSNODEI
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 the node where the Sterling Connect:Direct Process is to be submitted. For information about parameters for the remote node, refer to the IBM Sterling Connect:Direct Processes Web site at http://www.
IBM Sterling Connect:Direct for i5/OS User’s Guide PCLASS(n) specifies the Sterling Connect:Direct Process CLASS for the submitted remote Process. This entry overrides the class specified in the Process. PHOLD(*YES|*NO|*CALL) specifies whether the submitted remote Process is placed in the hold queue at submission. The default is the HOLD value of the Process. *YES specifies that the Process submits to the hold queue. *NO specifies that the Process executes as soon as possible.
Submitting a Sterling Connect:Direct Process on a Remote Node 105 PPNODEID(id,pswd,newpswd) specifies the primary node user ID and password for the submitted remote Process. This entry overrides the one specified in the Process. Note: Parameter values are case sensitive. PPRTY(n) specifies the Sterling Connect:Direct priority class for the submitted remote Process. This entry overrides the one specified in the Process. The valid range is 0–15.
IBM Sterling Connect:Direct for i5/OS User’s Guide SACCT(SNODE accounting-data) specifies the accounting data for the remote node. The maximum length of the accounting data is 256 characters. If special characters are part of the accounting data, the string must be enclosed in single quotation marks. SNODEID(id,pswd,newpswd) specifies security user IDs and passwords at the remote node.
Submitting a Sterling Connect:Direct Process on a Remote Node 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. 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 two other traces.
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 . . . . . . . > OS/390___ MVS, OS390, MSP, VSE, VM... Remote process file name . . . . 'KMOOR1.AS400.
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 the CDRUNJOB command to submit a job on the remote node. The job can be: A CL command that is submitted on a remote i5/OS node.
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.
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. CLASS(n) determines the node-to-node session where a Sterling Connect:Direct operation can execute. The CLASS is a number from 1–255.
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 submit a job. Note: This parameter is for use only in Sterling Connect:Direct for z/OS environments. PNAME(name) identifies the Process in any messages or statistics related to the operation.
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). Note: Parameter values are case sensitive. Newpswd is not valid if the remote node is a Sterling Connect:Direct for i5/OS node.
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 information. For a remote i5/OS system, this parameter specifies a string ‘cmd(any valid batch CL command) [any valid parameters for the i5/OS SBMJOB command]’.
Submitting a Job on a Remote Node 115 The primary CDRUNJOB screen looks similar to the following. Connect:Direct Run Job (CDRUNJOB) Type choices, press Enter. Remote Node Name . . . . . . . . > hotpepper________ Remote Environment . . . . . . . > AS400_____ AS400, MVS, OS390, OS/400... Remote Job command . . . . . . .
IBM Sterling Connect:Direct for i5/OS User’s Guide
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 the i5/OS node before sending it to a remote node.
IBM Sterling Connect:Direct for i5/OS User’s Guide CDCOMP Command Format The following table shows the format for the CDCOMP command. Command Parameters CDCOMP INFILE(library-name/file-name) OUTFILE(library-name/file-name) CKPTINV(n) EXCMBR(start-mbr end-mbr) REPLACE(*NO|*YES) SELMBR(start-mbr end-mbr new-mbr) 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 compressed.
Compressing Files 119 EXCMBR(start-mbr end-mbr) specifies criteria by which file members are excluded from compression. In any case where a member meets the criteria of both the SELMBR and EXCMBR parameters, the EXCMBR specification overrides the selection of the member. You can type in multiple sets of values for this parameter. start-mbr specifies the name of the member to be excluded from compression or the first name in a range of members to be excluded.
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. *ALL indicates all members in the input file is selected for compression. member-name specifies the name of the file member to be compressed.
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 . . . . . . . . Library . . . . . . . . . . . Output file name . . . . . . . . Library . . . . . . . . . . . File Members Selection List: Starting member name . . . . . Ending member name . . . . . . New member name . . . . . . . + for more values Replace members . . . . . . . .
IBM Sterling Connect:Direct for i5/OS User’s Guide
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 for asynchronous execution Control certain characteristics of the execution WRKCDPROC command allows you to work with active or queued Sterling Connect:Direct Processes.
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 Connect:Direct Process to the Process queue for asynchronous execution.
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 subparameters. Sterling Connect:Direct checks the command and its parameters at submission. If the command or the parameters are not valid, the submission fails with an error message.
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 is run every day at the same time after the first scheduled time. *WEEK releases the Process weekly at the same time and day of the week as the first execution.
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 Use the Connect:Direct Submit Process (CDSUBPROC) screen to submit a Sterling Connect:Direct Process to the Process queue for asynchronous execution.
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 which you work. Viewing All Processes The Display option allows you to view detailed information for all Processes, including execution information for active Processes, both synchronous and asynchronous.
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 Process. This parameter has two options: *ALL indicates that you select all Process numbers. n is the number of a specific Process you want to select.
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. Access the WRKCDPROC screen by typing WRKCDPROC at the command line and press F4 or choose the Work with Sterling Connect:Direct Processes option from the Sterling Connect:Direct main menu. 2.
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. Work with C:D Process Type option and press Enter.
IBM Sterling Connect:Direct for i5/OS User’s Guide The following is an example of the Display C:D Process screen. Display C:D Process Process Name . Number . . . . Submitter . . Frequency . . Submit Date . Schedule Date : : : : : : CDSND 00014895 LCLUSER *NONE 03/16/04 Queue . . . . Remote Node . Priority . . . Retain . . . . Submit Time . Schedule Time : : : : : : HOLDQ CDDV3600 07 *NO 11:59:28 ------------------------- Activity Details ------------------------Function . . . From File . .
Controlling Processes 133 RLSCDPROC Screen Release Held C:D Process (RLSCDPROC) Type choices, press Enter. Process Type . . Process Queue . Process Name . . Process number . Processing User Remote Node . . F1=Help . . . . . . F3=Exit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
IBM Sterling Connect:Direct for i5/OS User’s Guide
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 statistics information and writes it to the statistics file. You can view the results of the Processes by using the CDSELSTAT command.
IBM Sterling Connect:Direct for i5/OS User’s Guide Command Parameters PNAME(process-name|generic|*ALL) PUSER(local-userid|generic|*ALL) RCDTPYE(record-type|*ALL) RMTNODE(remote-node-name|*ALL) TRACE(L,S,F,C,X,K,D,H,V,W,P|*NONE|*ALL|*EXT|*COMMON|*INITPARMS|*CURRENT) Required Parameters The CDSELSTAT command has no required parameters. Optional Parameters The following parameters are optional for the CDSELSTAT command.
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 of the current job (i5/OS job date format). *TODAY specifies the current date. The starting and ending date fields default to *TODAY. *AVAIL specifies the earliest and latest date in the file.
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 option (13) from the Sterling Connect:Direct main menu. The following screen is a sample of the first screen in the CDSELSTAT screen flow. Select C:D Statistics (CDSELSTAT) Type choices, press Enter. 2.
Using Sterling Connect:Direct Statistics 139 about a particular statistics record. Type 5 in the option column for the Record type you want to review to display the detailed information and press Enter. Note: You could also type 6 and press Enter for a print version of the detail list, which is spooled for printing to the default output queue. See the next section for information on retrieving a spooled file. Select C:D Statistics Process number . . Process name . . .
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 from the Connect:Direct main menu. The first CDSELSTAT screen is displayed. Select C:D Statistics (CDSELSTAT) Type choices, press Enter. 2. Input file name . . . . . . . . Library . . . . . . . . . . .
Using Sterling Connect:Direct Statistics 3. 141 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. Work with Output Queue Queue: CDOUT Library: CDLIB Status: RLS Type options, press Enter.
IBM Sterling Connect:Direct for i5/OS User’s Guide The following screen shows the results of using the display option, Output destination, (*PRINT). Display Spooled File File . . . . . : CDSELSTAT Control . . . . . Columns 1 - 130 Find . . . . . . Page/Line 1/6 *...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8.... +....9....+....0....+....1....+....2....+....
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 node and archived on the i5/OS node as compressed files. Use the CDDECOMP command to decompress these files. Note: Tuning parameters are not supported with the CDDECOMP command when sending a file.
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 to be used. *LIBL specifies that the library list is used to locate the input file. *CURLIB specifies that the current library for the job is used to locate the input file.
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 . . . . . . . . ______ Library . . . . . . . . . . . *LIBL___ Output file name . . . . . . . . _____ Library . . . . . . . . . . . *CURLIB__ Replace members . . . . . . . . *NO_ Rename members: _ Current member name . . . . . _________ New member name . . . . . . .
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 Sterling Connect:Direct for i5/OS operation.
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 CDMSGID(AFLH001I) DSPCDMSGD AFLH001I DSPCDMSGD Command Format The following is the parameter for the DSPCDMSGD command: Command Parameters DSPCDMSGD CDMSGID(msgid) Required Parameter The DSPCDMSGD command has one required parameter. CDMSGID(msgid) specifies an eight-character Sterling Connect:Direct message ID.
Displaying Sterling Connect:Direct Message Descriptions 149 The following screen is an example of the screen associated with the DSPCDMSGD command. Display Connect:Direct Message (DSPCDMSGD) Type choices, press Enter. Connect:Direct Message ID F3=Exit F4=Prompt F24=More keys . . . F5=Refresh SCPA000I F12=Cancel Character value Bottom F13=How to use this display Sample Message Description The following figure shows a sample message description. Display C:D Message Description System : Message ID .
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 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 members.
IBM Sterling Connect:Direct for i5/OS User’s Guide i5/OS Run Task Example Member Name Description ARNJDS01 CDRUNTASK Example i5/OS Send Example Using Send File Field Description Member Name Description ASNDCF1A CDSND Using SNDFFD Parameter i5/OS Send and Receive Examples Using Native File System Member Name Description ASNDCR1A ASNDCRIA.$ CDSND Physical Source File ASNDCR1B CDSND Physical Data File ASNDCR1D ASNDCRID.
CL Program Examples 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.
IBM Sterling Connect:Direct for i5/OS User’s Guide Member Name Description 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 System /QDLS to SPLF ARCVIF01A CDSND NATIVE File System to Integrated File System /QSYS ARCVIF01J CDSND Native File System to Integrated File System /QOpenSys ARCVIF
CL Program Examples 155 Member Name Description 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 Compression MSNDRDR CDSND JCL to z/OS READER Using SPOOL TRANSFER OPTION MSPLCRKFP4 CDSNDSPL to z/OS KSDS i5/OS–NT Send and Receive Examples Member Name Descript
IBM Sterling Connect:Direct for i5/OS User’s Guide Member Name Description NSNDIF01J CDSND Using Integrated File System /QOpenSys NSNDIF01K CDSND Using Integrated File System /root NSNDIF01L CDSND Using Integrated File System /QDLS NSNDIF01M CDSND Using Integrated File System /root and Binary File NSNDIF01N CDSND Using Integrated File System /QOpenSys and Binary File NSNDIF01P CDSND Using Integrated File System /QDLS and Binary File i5/OS–Microsoft Windows Run Job and Run Task Examples M
CL Program Examples 157 Member Name Description 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 Physical Data File Using Integrated File System /QSYS USNDIF01I CDSND of Physical Data Binary File Using Integrated File System /QSYS USNDIF01J CDSND of Text File Using Integrated File System /QOpenSys USNDIF01K CDSND of Text File Usi
IBM Sterling Connect:Direct for i5/OS User’s Guide
Notices This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used.
Notices 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 inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication.
Notices 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 illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are ficticious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental.
Notices UNIX is a registered trademark of The Open Group in the United States and other countries. Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates. Cell Broadband Engine is a trademark of Sony Computer Entertainment, Inc. in the United States, other countries, or both and is used under license therefrom. Linear Tape-Open, LTO, the LTO Logo, Ultrium and the Ultrium Logo are trademarks of HP, IBM Corp. and Quantum in the U.S.
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 Interface (API) is a Sterling Connect:Direct component that accepts commands and places them in an executable format. Asynchronous Asynchronous Process execution occurs when the system starts the job.
IBM Sterling Connect:Direct for i5/OS User’s Guide I Integrated File System The integrated file system provides an integrated structure of all stored information. This file system provides stream files, directory structure accessed by path, and a user and application interface that accesses all information stored in the i5/OS. L Local Node The local node is the Sterling Connect:Direct server on which the Process is submitted.
necessarily be interpreted as the sending node, since PNODE can be the receiver. In every Process, there is one local (PNODE) and one remote (SNODE) specified. The submitter of a Process is always the PNODE. Process A Process is a series of statements that initiate Sterling Connect:Direct activity, such as copying files, and running jobs.
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 partner node. Every Process has one PNODE and one SNODE. Session Manager (SMGR) The session manager component executes the Sterling Connect:Direct Processes.
Timer Queue (TIMER) This Sterling Connect:Direct for i5/OS component provides timer services to the other components. The process manager submits and controls the TIMER. The TIMER is always present when Sterling Connect:Direct is active.
IBM Sterling Connect:Direct for i5/OS User’s Guide
Index A ACTIVQ definition REPLACE 119 screens 120 SELMBR 119 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 transfer CDRCV example 40, 41, 66 CDSND and CDRCV example 41, CDSND example 41, 66, 67 description 39, 65 examples 40, 66 C case sensitivity 15, 19, 22 integrated file sy
IBM Sterling Connect:Direct for i5/OS User’s Guide general description 93 initiating remote node task NOTIFY 96 parameters 95 PARM 96 PGM 95 PNAME 96 PNODEID 96 RMTWORK 97 SACCT 97 screens 98 SNODEID 97 syntax 94 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 TEX
Index 171 SECOPTIONS 32, 37, , 113, 126 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 TOSYSOPTS 26, 80 TSPACE 38 TSQL 38 TTYPE 39 TUNIT 39 TVOL 39 TVOLREF 39 TVSAMCAT 39 XTRAN 25 XTRANLDATA 25 XTRANLSI 25 XTRANLSO 25 CDSNDSPL command BLKSIZE 81 CHLVAL 81 CLASS 81 COMPRESS 82 CRC parameter 82 CTLCHAR 83 example 73 FDSNLEN 83 format 73 JOB 75 NOTIFY 83 parameter 73, 75 PNAME 83 PNODEID 84 PRTY 84
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 remote 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 submitting Process to Process queue Checkpoint Interval (CKPTINV) parameter 29, 55, 81, 118 checkpointing restart interval 118 29, 55, CHLVAL CDSNDSPL com
Index 173 commands CDRUNJOB 109 DSPCDMSGD 148 WRKCDPROC 128 CDRCV command 56 CDSND command 30 CDSNDSPL command 82 parameter 30, 56, 82 compressing a file 117, controlling processes EXCLUDE parameter 120 128, EXCMBR CDCOMP command 130 CRC parameter CDRCV command 56 CDRUNJOB command 111 CDRUNTASK command 96 CDSND command 30 CDSNDSPL command 82 CDSUBMIT command 103 FALIAS CDRCV command parameter 57 Digital Signature SECOPTION parameter FDBPARMS parameter 57 CDRCV command 57 displaying message te
IBM Sterling Connect:Direct for i5/OS User’s Guide LU 6.
Index 175 PNODEID 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, CDSUBMIT command 105 PSTARTT, CDSUBMIT command 105 PSYMBOLS, CDSUBMIT command 105 PUSER, WRKCDPROC command 129 QNAME, WRKCDPROC command 129 RETAIN, CDSUBPROC command
IBM Sterling Connect:Direct for i5/OS User’s Guide QSYS.
Index 177 SPLFNUM parameter 76 Spool Monitor (CDSPLMON) starting a receive 45 a send 19, 20 a send of a spool file a task 93 TDSN/FDSN format MSP 49 Stratus VOS 49 VM 49 VSE 49 z/OS 49 8 73 STARTQ, definition TEXTFILE parameter CDRCV command 51 CDSND command 25 129 STARTT parameter CDSUBPROC command Timer (TIMER) component 8 125 TIMERQ definition statistics logging 8 selecting and printing 140 selecting, displaying, and printing Statistics Manager (STATMGR) Status messages routing to specific
IBM Sterling Connect:Direct for i5/OS User’s Guide W WAITQ definition 129 working with processes 128 selecting specific Processes 128 user authority 128 viewing all Processes 128 WRKCDPROC command 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 129 QNAME 129 RMTNODE 129 screens 130 suspend 132 TYPE 129 128 WRKCDPROC command, PNAME 128 WRKCDPROC screens accessing 130 monitoring and controlling Processes