TITLECOPY

Syntax

Parameters

OUTDD=DDname

DDname specifies the ddname of the output partitioned data set.

OUTDSN={DSname|(DSname,SHR)|(DSname,OLD)}

• DSname specifies the dsname of the cataloged output partitioned data set.
• {SHR|OLD} specifies the disposition of the dynamically allocated data set. When this parameter is omitted, the default from the "OUTDISP=" EXEC PARM field applies. When both are omitted, SHR is used.

INDD={DDname|((DDname,{R|O}))}

• DDname specifies the ddname of an input partitioned data set.
• R specifies that all member titles that are copied from this input data set are to replace any identically named member titles on the output partitioned data set.
• O specifies that only the titles of the target members that are older than the similarly named input members are to be replaced.

Note: I= is an acceptable abbreviation of INDD=.

INDSN={DSname|(DSname,{SHR|OLD}<,{R|O}>)|(DSname,,{R|O})}

• DSname specifies the dsname of the cataloged input partitioned data set.
• {SHR|OLD} specifies the disposition of the dynamically allocated data set. When this parameter is omitted, the default from the "INDISP=" EXEC PARM field applies. When both are omitted, SHR is used.

Note: IDS= is an acceptable abbreviation of INDSN=.

LIST={YES|NO}

Specifies whether a member title list report is to be written into the SYSPRINT data set. When this parameter is omitted, the default from the EXEC PARM field applies.

LIST=ALL

Same as LIST=YES with additional member pre-filtering related messages.

LIST=ONLY

Same as LIST=YES.

AGE=Age

Specifies the maximum number of days since the most recent update date of a member. The value of variable Age can be either a decimal number that consists of up to seven digits, or one of the following keywords:

TODAY or T

Same as 0.

DAY or D

Same as 1.

WEEK or W

Same as 7.

MONTH or M

Same as 31.

QUARTER or Q

Same as 93.

YEAR or Y

Same as 365.

USERID=Uid or UID=Uid

Specifies the user ID of the most recent update of a member. The value of variable Uid can be either a string that consists of up to seven characters, or a pattern mask.

USERKEY=Ukey or UKEY=Ukey

Replaces the user key value that is stored in every copied title record. The value of variable Ukey is a string that consists of up to 8 printable characters.

Usage notes

• The TITLECOPY statement must be followed by at least one SELECT statement. EXCLUDE statements are optional to be added. The MEMBER keyword entry of each SELECT statement might include a new member name parameter and an R or O option flag.
• You must specify either keyword OUTDD or keyword OUTDSN. If both of the keywords are specified, they are mutually exclusive.
• You must specify either keyword INDD or keyword INDSN. If both of the keywords are specified, they are mutually exclusive.
• The persistent member title list of a partitioned data set is stored by DSC in a dedicated member of the data set. It has a reserved name that can be defined via the DSC customization wizard. For example, Z999TITL.
• The TITLECOPY statement is not allowed to operate on load module data set libraries.