CDRUNJOB Command Format

The following are the parameters for the CDRUNJOB command. Required parameters are in bold.

Command	Parameters
CDRUNJOB	SNODE(node-name)
	SNODENVIRN(environment-name)
	BATCHID(idname)
	CLASS(n)
	CRC(INITPARMS\|INETMAP\|NOFF\|FON\|O)
	†JOBFILE(filename)
	LINK(CMS-file-information
	NOTIFY(userid)
	PLEXCLASS(user-defined class)
	PNAME(name)
	PNODEID(userid,pswd,newpswd)
	RMTWORK(YES\|NO)
	SACCT(SNODE accounting-data)
	SNODEID(userid,pswd,newpswd)
	‡TSYSOPTS(remote-job-command)
	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)
¹	Note: The CLASS parameter is not used by Sterling Connect:Direct for i5/OS.

Required Parameters

The following parameters are required. Unless otherwise noted, the parameters apply to all remote node environments.

SNODE(node-name)

specifies a 1–16 character alphanumeric name for the remote node.

Note: This value is case sensitive.

SNODENVIRN(environment-name)

specifies the remote environment to execute the job.

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

Note: The CLASS parameter is not used by Sterling Connect:Direct for i5/OS.

CRC(*INITPARMS|I*NETMAP|N*OFF|F*ON|O)

Determines whether node and process statement overrides for Cyclic Redundancy Check (CRC) are allowed. If this value is set to *OFF, setting overrides for CRC checking will be ignored. The default value is *INITPARMS.

*INITPARMS (or *I) specifies that the CRC setting is determined by the value for the initialization parameter TCP.CRC.

*NETMAP (or *N) specifies that the CRC setting is determined by the value for the NETMAP parameter, Cyclic Redundancy Check. The value for the initialization parameter TCP.CRC must be set to *ON and the value for the initialization parameter TCP.CRC.OVERRIDE must be set to *YES.

*OFF (or *F) specifies that CRC is disabled.

*ON (or *O) specifies that CRC is enabled.

JOBFILE(filename)

specifies the name of the file that contains the job to be submitted. This file must already exist on the node where the job is to be submitted.

LINK(CMS-file-information)

specifies where the CMS file is located. This parameter allows you to access the VM CMS file.

owner id specifies the user ID for the owner of the CMS minidisk where the file is located.

owner password specifies the password for the CMS minidisk where the file is located. This parameter accepts 1–8 characters. The default is ALL.

LINK access mode specifies the LINK access mode. The following entries are valid:

W for primary read/write
M for primary multiple access
R for primary read only
RR for primary and secondary read only
WR for primary read/write; alternate read only
MW for primary multiple access; alternate read/write

virtual address specifies the virtual address of the disk where the CMS file is located. A three-digit number is valid.

NOTIFY(userid)

specifies the user ID on the local node to receive status messages that are directed to the message queue of the user.

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. The name is from 1–12 characters long. The first character must be alphabetic. The default name is CDSND.

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 node. You should only use this parameter to validate security with a different ID than the one you used to sign on to Sterling Connect:Direct.

id specifies the security ID passed to the security system at the local node (1–10 alphanumeric characters).

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 you have 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).

Note: Although you can specify a value for the new password, Sterling Connect:Direct for i5/OS does not support this parameter.

RMTWORK(*YES|*NO)

specifies whether a remote Process can run on the session after Sterling Connect:Direct for i5/OS has completed its Process on the session.

*YES allows a remote Process to run on the session after Sterling Connect:Direct for i5/OS completes its Process.

*NO terminates the session after Sterling Connect:Direct for i5/OS executes the command function.

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(userid, pswd, newpswd)

specifies security user IDs and passwords at the remote node. You should only use this parameter to validate security with a different ID than the one you used to sign on to Sterling Connect:Direct.

userid specifies the security ID passed to the security system on 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.

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.

TRACEOPT

Trace Instructions

specifies the trace bits that define functions to be traced by Sterling Connect:Direct for i5/OS. The following are valid options:

L enables the main line logic trace for all components.
S enables the Process step logic trace.
F enables the file handler trace.
C enables the communications 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.
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.
*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.
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. (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]’. This CL command is submitted on the remote i5/OS system through a SBMJOB command. This parameter is valid for i5/OS, OpenVMS, UNIX, Stratus VOS, and Microsoft Windows.

See the IBM Sterling Connect:Direct Processes Web site for valid platform-specific parameters.

† Valid for z/OS, OpenVMS, VM, and Microsoft Windows only

‡ Valid for i5/OS, MS-DOS, OpenVMS, UNIX, Stratus VOS, and Microsoft Windows