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.

Optional Parameters

The following parameters are optional for the CDSUBPROC command.

HOLD(*YES*NO)

specifies whether Sterling Connect:Direct places the Process in the HOLD queue upon submission.

*YES places the Process in the HOLD queue immediately. HOLD(*YES) is mutually exclusive with the STARTT parameter.

*NO prevents Sterling Connect:Direct from placing the Process in the HOLD queue.

PRIORITY(n)

specifies a priority value for the submitted Process. This parameter determines the Process position in the Process WAIT queue and can affect the order of Process execution. The value is 1–15, with 15 being the highest priority. The default value is 7.

RETAIN(*YES*NO*INITIAL)

specifies whether Sterling Connect:Direct keeps a copy of the Process in the HOLD queue after the Process executes.

*YES places the Process in the HOLD queue after execution.

*NO deletes the Process after execution.

*INITIAL indicates that the Process executes every time the Sterling Connect:Direct for i5/OS node initializes. If you select *INITIAL, the Process does not execute when you submit it.

STARTT(day,time,freq)

specifies when the submitted command runs. Day and time together indicate the scheduled time. Frequency indicates a repeated execution. If you specify frequency, Sterling Connect:Direct ignores any RETAIN parameter.

day specifies the day of the week when the Process is executed. You can specify any of the following: *NONE, *SUN, *MON, *TUE, *WED, *THU, *FRI, *SAT, *TODAY, *TOMORROW, or the date. If you specify the date, you must give the date in the job date format. Input dates are interpreted according to the date format of the current job (i5/OS job date format).

If you use day without a time, the time defaults to 00:00 (midnight). The default value is *NONE, which indicates no scheduled day.

time indicates the time of day when the Process runs. You can specify time as any of the following: *NONE, *NOON, *MIDNIGHT, or hh:mm:ssXM.

If you give time in the hh:mm:ssXM format, you can enter the time with or without separators. Minutes and seconds are optional. If you do not enter minutes and seconds, they default to 00. If you specify AM or PM, Sterling Connect:Direct assumes the time is in 12-hour format. If you do not select AM or PM, Sterling Connect:Direct assumes the time is in 24-hour format.

If you specify time but not day, the Process is run on the first occurrence of the specified time.

Page 125
Image 125
IBM CDI5UG1107 manual CMDcommand string, Hold*Yes*No, PRIORITYn, Retain*Yes*No*Initial, STARTTday,time,freq