CTDUPTR Parameters

The following groups of input parameters can be specified in the input stream:

General parameters
General parameters are specified in the beginning of the parameters stream. They define the utility’s working and output report printing mode. For details, see Table 281 below.

Action parameters

Selection parameters, described in Table 282 below, enable you to select recipient entries on which actions will be performed, and update parameters, described in Table 283 below, enable you to specify fields that will be updated.

Each action may be specified several times with different selection and update parameters.

SELECT selection parameters
CHANGE TO update parameters
The recipient entries are selected according to selection parameters and are updated with the values specified by the update parameters. If the recipient name or level is updated in a recipient entry and this recipient is specified as a parent in other entries, the parent recipient name or level or both are updated in all child recipient entries.
DELETE [WITHCHILD] [NOREPORTS] selection parameters
The recipient entries are selected according to specified selection parameters and are deleted from the recipient tree.

If the WITHCHILD parameter is specified and a recipient to be deleted is defined as a parent to other recipients, all child elements of all generations are deleted together with the selected recipient entry.

If the WITHCHILD parameter is not specified and a recipient to be deleted is defined as a parent to other recipients, the recipient entry is not deleted and a warning message is issued.

If NOREPORTS is specified, the selected recipient entry is deleted only if this recipient, and all its children, do not have reports in any User file (Active, Migrated, or History).
INSERT update parameters
A new recipient entry is added to the recipient tree.

The update parameters are the same as for the CHANGE TO function, but the RECIPIENT and LEVEL parameters are mandatory in this case.
COPY <recipient> TO update parameters
The recipient entry with the recipient name <recipient> is copied to the new entry with the recipient name that is specified in the RECIPIENT update parameter. The RECIPIENT update parameter is mandatory and the specified recipient name should be different than the input recipient name. Other fields may be updated with the values specified in the update parameters or can be copied from the input recipient entry, if corresponding update parameters are not specified.

Table 281 CTDUPTR general parameters

Parameter	Description
MODE	Indicates whether the utility should save the updated recipient tree member, or only issue the update report without saving the updated recipient tree member. Optional. Valid values are: PROD – The updated recipient tree is saved in the library and the report is issued. Default. TEST – The updated recipient tree member is not saved. Only a report is issued.
LIBRARY	The dataset name of the library where the recipient tree member is located. Maximum 44 characters. Mandatory.
MEMBER	The recipient tree member name. Maximum: 8 characters. Mandatory.

Parameter

Description

MODE

Indicates whether the utility should save the updated recipient tree member, or only issue the update report without saving the updated recipient tree member. Optional. Valid values are:

PROD – The updated recipient tree is saved in the library and the report is issued. Default.
TEST – The updated recipient tree member is not saved. Only a report is issued.

LIBRARY

The dataset name of the library where the recipient tree member is located. Maximum 44 characters. Mandatory.

MEMBER

The recipient tree member name. Maximum: 8 characters. Mandatory.

Table 282 CTDUPTR selection parameters

Parameter	Description
RECIPIENT	The recipient name. Complete value or mask. Maximum length: 8 characters.
LEVEL	The level of the recipients to be updated. Maximum length: 2 characters.
PARENT	The name of the recipient’s parent. Complete value or mask. Maximum length: 8 characters.
PARENT-LEVEL	The level of the recipient’s parent. Maximum length: 2 characters.
SYNONYM	The synonym name. Complete value or mask. Maximum length: 20 characters. If the specified value includes blank spaces, the parameter value must be surrounded by apostrophes.
AUTHORIZE	The TSO user to which the recipient is authorized. Complete value or mask. Maximum length: 8 characters.
DESC	Recipient description line or its substring. Maximum length: 59 characters. If blank spaces or apostrophes are included in the substring, the value must be written surrounded by apostrophes, and the apostrophes included in the substring must be doubled.
ADDRESS	Recipient address line or its substring. Maximum length: 52 characters. If blank spaces or apostrophes are included in the substring, the value must be written surrounded by apostrophes, and the apostrophes included in the substring must be doubled.

Table 283 CTDUPTR update parameters

Parameter	Description
RECIPIENT	Recipient name. Mandatory for the INSERT and COPY groups. Maximum length: 8 characters.
LEVEL	Recipient level. Mandatory for the INSERT group. Maximum length: 2 characters.
PARENT	The name of the recipient’s parent. Maximum length: 8 characters.
PARENT-LEVEL	The level of the recipient’s parent. Mandatory for the INSERT group if PARENT is specified. Maximum length: 2 characters.
DESC	Recipient description. One or more statements may be specified. The first statement can be started immediately after ‘=’ or from the next card. Each following statement should be started from the new card. The first non-blank character of each statement is a service code with one of the following meanings: ‘+‘ – The following text will be added as a new line to the end of the description. ‘-‘ – The following text is a line that should be deleted from the description. If -ALL is specified, all description lines are deleted. ‘>’ – The following text will be inserted as a new line after the current line. The current line is the line that was added or deleted with the previous statement. If it is the first statement, the line is inserted as the first description line. To replace a line, the old line should begin with ‘-‘ and the new line should begin with ‘>’in the following statement. Maximum length of the description line: 59 characters.
SYNONYM	Recipient synonyms. One or more statements may be specified. The first statement can be started immediately after ‘=’ or from the next card. Each following statement should be started from the new card. The first non-blank character of each statement is a service code with one of the following meanings: ‘+‘ – The following text will be added as a new synonym to the end of the list of synonyms. ‘-‘ – The following text is a synonym that should be deleted. If -ALL is specified, all synonyms are deleted from the recipient entry. ‘>’ – The following text will be inserted as a new synonym after the current synonym. The current synonym is the synonym that was added or deleted with the previous statement. If it is the first statement, the synonym is inserted as the first synonym in the list. To replace a synonym, the old synonym should begin with ‘-‘ and the new synonym should begin with ‘>’ in the following statement. Maximum length of the synonym line: 20 characters.
AUTHORIZE	TSO user names authorized to access the reports of the recipient and its children. The user name should be specified in the format n..n or n..n;S, where n..n is a user name or its prefix (maximum: 8 characters). If the letter S appears after the semi-colon (;), the specified online user is also authorized to access SYSDATA records and create global rulers. One or more statements may be specified. The first statement can be started immediately after ‘=’ or from the next card. Each following statement should be started from the new card. The first non-blank character of each statement is a service code with one of the following meanings: ‘+‘ – The following text will be added as a new user name to the end of the list of users. ‘-‘ – The following text is a user name that should be deleted. If -ALL is specified, all authorized users are deleted from the recipient entry. ‘>’ – The following text will be inserted as a new user name after the current name. The current user name is the user name that was added or deleted with the previous statement. If it is the first statement, the user is inserted as first TSO user in the list. To replace a TSO user name, the old user name should begin with ‘-‘, and the new should begin with ‘>’ in the following statement.
ADDRESS	Location to which the user bundle is sent during distribution. The address will be printed in the user banner. If *P is specified, the address of the parent is used. One or more statements may be specified. The first statement can be started immediately after ‘=’ or from the next card. Each following statement should be started from the new card. The first non-blank character of each statement is a service code with one of the following meanings: ‘+‘ – The following text will be added as a new line to the end of the address. ‘-‘ – The following text is a line that should be deleted from the address. If -ALL* is specified, all address lines are deleted. ‘>’ – The following text will be inserted as a new line after the current line. The current line is the line that was added or deleted with the previous statement. If it is the first statement, the line is inserted as first address line. To replace a line, the old line should begin with ‘-‘, and the new line should appear in the following statement. Maximum length of the address line: 52 characters.
INDEX	Print a report index at the beginning of the user bundle. Valid values are: Y – Yes. Default. N – No.
USER-BANNER	Print a user banner at the beginning and end of the user bundle. Valid values are: Y – Yes. Default. N – No.
REPORT-BANNER	Print a report banner at the beginning and end of the user bundle. Valid values are: Y – Yes. Default. N – No.
DEF-DEST	Default destination (node and user ID separated by ‘;’) of the printed reports. The length of each node and user ID can be 1–8 characters. If Control-D/Delivery Server is installed, reports can be distributed to a UNIX or Windows NT environment by setting the node value to CTDS.
PC-AUTHORIZED	Indicates whether the user can receive reports using Control-D DPC. Since Control-D DPC is not currently supported, only the value N can be specified. This means that the recipient will not be authorized to receive reports using Control-D DPC. This is the default when inserting new recipients.

Parent Topic

CTDUPTR – Global update of Control-D recipient tree