CTDUPMIS selection parameters

The decollation mission definitions selected according to selection parameters are updated with the values specified by the update parameters. Depending on the general input parameters the utility can update the decollation mission members in the original library or store the selected members to another library.

A decollation mission definition member can contain several decollation missions (categories). Each decollation category definition has the following blocks:

The general block specifies common decollation mission characteristics.
The ON block provides instructions for decollating a particular set of jobs or sysouts. Several ON blocks can be included in the decollation mission definition.
The WHEN block selects certain report pages and defines the decollation actions (DO statements) for these report pages. Several WHEN blocks can be included in each ON block.

The following selection parameters correspond to the decollation category definition blocks:

General selection parameters, specifying general block values, are listed in Table 274 below.
ON selection parameters, specifying common ON block values, are listed in Table 275 below.
WHEN selection parameters, specifying WHEN and DO statement values, are listed in Table 276 below.

The following rules apply to the selection parameters:

No particular selection parameter is mandatory, but at least one selection parameter must be specified in the SELECT statement.
The SELECT statement can contain different selection parameters and the same parameter can be specified several times with different values. Similar selection parameters are related by logical OR, while different selection parameters are related by logical AND.
Selection parameter values can be specified as a mask (contain wildcard characters ‘*’ and ‘?’).
If blank spaces or apostrophes are included in the specified parameter, the value must be surrounded by apostrophes and the embedded apostrophes must be doubled.
Several SELECT … CHANGE TO … groups can be specified in the input stream.
In additional to the valid values described in Table 274, Table 275, and Table 276, every selection parameter can be specified as * or $NONE. If * is specified, any decollation mission definition that includes a non-blank value for the parameter is selected. If $NONE is specified, any decollation mission definition that does not have a value for the parameter is selected.

If a CHANGE TO statement is missing, the list of selected decollation mission definitions is issued to the output report without changing any of the decollation mission definitions.

Table 274 CTDUPMIS general selection parameters

Parameter	Description
MEMBER	Decollation member name. Maximum length: 8 characters.
CATEGORY	Decollation mission category. Maximum length: 20 characters.
CLS	Any valid non-held output class. If CLS is specified, a decollating mission does not start unless some output from the job is currently in the specified class.
JOBNAME	Job name. Maximum length: 8 characters.
GENERIC	GENERIC decollation parameter. Valid values are Y or N.
MONITOR	Monitor number. Valid value is a number from 1 through 9.
OWNER	User that created the decollation mission definition. Maximum length: 8 characters.
GROUP	Decollation mission's group name. Maximum length: 20 characters.
JOBID	Job ID. Maximum length: 7 characters.
DESC	Decollation description first line. Maximum length: 50 characters.
IN	Input condition text. Maximum length: 20 characters.
OUT	Output condition text. Maximum length: 20 characters.
DEF-USER	Default recipient name. Maximum length: 20 characters.
DEF-DEST	Default destination. Maximum length: 8 characters.
DEF-COPIES	Default number of copies of the job's reports to be printed for each recipient, if not specified elsewhere. Valid values: 00 through 99. The default is 01. A leading zero is required.
TASKTYPE	Decollation task type. Valid values are REP, CRP, and ERP.
WHEN-IN-QUEUE	Determines whether the output queue is searched for the job to be decollated. Valid values are: Y - Search for the job in the output queue. Default. E - Search for the job in the output queue. Include currently executing jobs in the search. N - Do not search for the job in output queue. S - Search for the job in the output queue, using as selection criteria parameters defined in all ON CLASS or ON TRNCLASS statements (CLASS, EXTWTR, DEST, FORM).

Table 275 CTDUPMIS ON block selection parameters

Parameter	Description
ON-CLASS	Valid values are: One letter of output class specified in ON CLASS decollation parameter. It can be followed by the list of subparameters EXTWRT, DEST, FORM enclosed in parentheses. For example: ON-CLASS=A(EXTWRT=NAME1,DEST=NAME2) The valid subparameter values are described in the Control-D and Control-V User Guide.
ON-TRNCLASS	Valid values are: One letter of output classes specified in ON TRNCLASS decollation parameter. It can be followed by the list of subparameters EXTWRT, DEST, FORM, CLIQUE in parentheses. For example: ON-TRNCLASS=A(CLIQUE=NAME3) The valid subparameter values are described in the Control-D and Control-V User Guide.
ON-DSN	Valid values are: List of subparameters enclosed in parentheses. One or several CDAM selection criterions as they are specified in the decollation mission definition should be specified in subparameters. For example: ON-DSN=(LAST=YES,PREFIX=CTD.D60) The valid subparameter values are described in the Control-D and Control-V User Guide.
ON-TRNDSN	Valid values are: List of subparameters enclosed in parentheses. One or several CDAM selection criterions as they are specified in the decollation mission definition should be specified in subparameters. For example: ON-TRNDSN=(PREFIX=CTD.D60,CLIQUE=CLNAME) The valid subparameter values are described in the Control-D and Control-V User Guide.
ON-SYSOUT	Valid values are: List of subparameters PGMSTEP, PROCSTEP, DDNAME, CLASS enclosed in parentheses. For example: ON-SYSOUT=(DDNAME=SYSUT2,CLASS=A) The valid subparameter values are described in the Control-D and Control-V User Guide.
ON-SYSJCL	Valid values are only * and $NONE.
ON-SYSLOG	Valid values are only * and $NONE.
ON-SYSMSG	Valid values are only * and $NONE.
ON-DEF-USER	ON block default recipient name. Maximum length is 20 characters.
ON-DEF-DEST	ON block default destination. Maximum length is 8 characters.
PRINT/CDAM-PARMS	One or several PRINT/CDAM-PARMS parameters. The list of parameters must be enclosed in parentheses. For example: PRINT/CDAM-PARMS=(ALLOCOPT=JOBSDSN1) The valid parameter values are described in the Control-D and Control-V User Guide.

Table 276 CTDUPMIS WHEN block selection parameters

Parameter	Description
WHEN-STRING	Search string specified in the WHEN decollation mission definition parameter. Maximum length: 60 characters.
DO-USER	Recipient name. Maximum length: 20 characters.
DO-NAME	Report name. Maximum length: 50 characters.
DO-BACKUP	Backup mission name. Maximum length: 8 characters.
DO-MIGRATE	Migration mission name. Maximum length: 8 characters.
DO-PRINT	Print mission name. Maximum length: 8 characters.
DO-INDEX	Main Index name or Index path. If Index path is specified, the Index and subindex names in path should be separated by '/'. Maximum length of each path level is 20 characters.
DO-REMARK	REMARK value. Maximum length is 20 characters.
DO-REMARK2	REMARK2 value. Maximum length is 20 characters.
DO-REMARK3	REMARK3 value. Maximum length is 20 characters.

Parent Topic

CTDUPMIS Parameters