CTDAUTR Parameters

The input parameters for the utility are specified in the stream referred by the SYSIN DD statement. They must be specified in the following order:

General parameters
INCLUDE
Selection parameters
Repeat INCLUDE with other Selection parameters, if needed.
EXCLUDE
Selection parameters
Repeat EXCLUDE with other Selection parameters, if needed.

The general parameters are described in Table 203.

Table 203 CTDAUTR general parameters

Parameter	Description
ACTION	Specifies which report the utility is to produce. Valid values are: RECIPIENTS - list of recipients authorized for a specific user. Default. REPORTS - list of available Control-D reports authorized for a specific user.
ENV	Specifies whether to use the online or web exits to check recipients and Control-D reports authorization. Valid values are: ONLINE - the online exits CTDX004 and CTDSE04 are used. Default. WEB - the IOA Application server exits CTDX024 and CTDSE024 are used.
FILE	Specifies which Control-D user files (active, migrated and history) the utility should scan to get the list of authorized reports. To use this parameter the ACTION parameter must be set to REPORTS. Valid values are: ACT - active. Default. MIG - migrated HST - history Combinations for more then one value are allowed. If more then one file is specified, the values should be separated by comma.
USERID	Indicates User ID for which the report should be issued. This parameter can be specified several times. In this case different report for each specified User ID is issued. At least one USERID parameter should be specified obligatory.

Table 204 describes selection parameters that can be specified in the INCLUDE and EXCLUDE statements.

The following rules apply to the INCLUDE and EXCLUDE statements:

Several INCLUDE and EXCLUDE statements can be specified.
All selection parameters are optional. Each selection parameter can be specified several times in the INCLUDE and EXCLUDE statements. In an INCLUDE or EXCLUDE statement, similar selection parameters are related by logical OR, while different selection parameters are related by logical AND.
CTDAUTR selects all reports that satisfy the selection parameters in the INCLUDE statements, except those that satisfy the selection parameters in the EXCLUDE statements.
If the EXCLUDE statements are missing, all reports that satisfy the selection parameters in the INCLUDE statements are selected.
If the INCLUDE statements are missing, all reports, except those which satisfy the selection parameters in the EXCLUDE statements, are selected.

If both the INCLUDE and EXCLUDE statements are missing, all Control-D reports from the specified User file are selected.

Table 204 CTDAUTR selection parameters

Parameter	Description
RECIPIENT	It specifies the name of the report recipient. Complete value or mask. The maximum length is 8 characters.
REPNAME	It specifies the name of the report. Complete value or mask. If blanks or apostrophes are included in the Report name, the Report name must be specified between apostrophes and any apostrophes included in the Report name must be doubled. The maximum length is 50 characters.
JOBNAME	It specifies the name of the job created the report. Complete value or mask. The maximum length is 8 characters.

Parameter

Description

RECIPIENT

It specifies the name of the report recipient. Complete value or mask. The maximum length is 8 characters.

REPNAME

It specifies the name of the report. Complete value or mask.

If blanks or apostrophes are included in the Report name, the Report name must be specified between apostrophes and any apostrophes included in the Report name must be doubled.

The maximum length is 50 characters.

JOBNAME

It specifies the name of the job created the report. Complete value or mask.

The maximum length is 8 characters.

Parent Topic

CTDAUTR – Create list of recipients and reports authorized for a specific User ID