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.