CYCLES (CY)

Abend retention is based on the number of cycles (meaning, versions) of a data set.

For a more detailed description, refer to the CYCLECNT parameter in the INCONTROL for z/OS Installation Guide: Installing.

Syntax:

CYCLES=number_cycles

where number_cycles is the number of cycles. A maximum of 4 digits can be specified. After the number of cycles is entered, the PREFIX field is displayed.

The value in the PREFIX field determines whether data set versions are identified according to their prefixes (as specified in the ON DATASET statement), or according to their full names, when counting cycles. Mandatory. Valid values:

• Y (Yes) – Consider data sets with the same prefix as versions of the same data set, and make a unified count of all versions (for example, assuming prefix mask BKP*, make a single count of versions of data sets BKP01 and BKP02).
• N (No) – Ignore prefixes, and consider the entire data set name (for example, count versions of BKP01 separately from versions of BKP02).

And/Or – When A (And) or O (Or) is specified, an additional abend retention field is opened on the screen. See And/Or Subparameter Logic.

DATE (DAT)

Abend retention is based on a specific expiration date.

Syntax:

DATE=expire_date

where expire_date is the expiration date. If date is specified at the same time as the abend retention type, the date must be specified in 6-digit or 8-digit format according to the site standard. For example, the date can be specified in mmddyy or mmddyyyy format.

Alternatively, the date can be specified in a 4-digit format, and the YEAR field is displayed. For example, specify mmdd and press Enter; the YEAR field is displayed. Specify the YEAR in 2-digit (yy) or 4-digit (yyyy) format.

And/Or–And/Or When A (And) or O (Or) is specified, an additional abend retention field is opened on the screen. See And/Or Subparameter Logic.

DAYS (DAY)

Abend retention is based on the number of days since the data set was created.

Syntax:

DAYS=number_days

where number_days is the number of days. A maximum of 5 digits can be specified.

And/Or – When A (And) or O (Or) is specified, an additional abend retention field is opened on the screen. See And/Or Subparameter Logic.

EDM (ED)

Abend retention is controlled by an External Data Manager (EDM).

No subparameters are specified with this abend retention type.

No other abend retention types can be combined with this abend retention type (meaning, using And/Or).

JCL EXPDT (J)

Abend retention is based on the expiration date specified in the JCL EXPDT, RETPD or DATACLAS parameter.

And/Or – When A (And) or O (Or) is specified, an additional abend retention field is opened on the screen. See And/Or Subparameter Logic.

LAST ACCESS (L)

Abend retention is based on the number of days since the data set was last accessed.

Syntax:

LAST ACCESS=number_days

where number_days is the Number of days. A maximum of 4 digits can be specified.

And/Or–When A (And) or O (Or) is specified, an additional abend retention field is opened on the screen. See And/Or Subparameter Logic.

MVS CATALOG (M or CA)

Abend retention is based on the existence of the data set in the MVS catalog. If the MVS catalog still controls the data set, the data set is retained by Control-M/Tape. Otherwise, the data set is no longer retained by Control-M/Tape.

No subparameters are specified with this abend retention type.

And/Or–When A (And) or O (Or) is specified, an additional abend retention field is opened on the screen. See And/Or Subparameter Logic.

PERMANENT (P)

Data set is retained indefinitely. This abend retention type allows data set or volume expiration to be done manually. This can be done using the EXPIRE option in the Inquire/Update screen.

No subparameters are specified with this abend retention type.

No other abend retention types can be combined with this abend retention type (meaning, using And/Or).