RETENTIONPERIOD: Requesting a specific retention period for the dump copy
Explanation: RETENTIONPERIOD is an optional parameter of DUMP, requesting a specific retention period for the dump copy or copies.
The list of retention periods corresponds to the list of dump classes. The dump copy targeted to the first dump class in the list is retained for the number of days specified by the first retention period in the list, and so forth.
| Subparameter | Explanation |
|---|---|
| days | RETENTIONPERIOD(days) specifies a number of days to retain the dump copy. For days, substitute a decimal number from 1 to 9999 or NOLIMIT. If days is specified as 5, DFSMShsm retains the dump copy for five days before expiring the dump copy. |
| * | RETENTIONPERIOD(*) is specified as a placeholder to denote that the retention period for the corresponding dump class specified with the DUMPCLASS parameter should be used. |
| NOLIMIT | RETENTIONPERIOD(NOLIMIT) indicates to DFSMShsm to not expire the dump copy automatically. |
Defaults: If fewer retention periods are
listed than dump classes, the retention periods are taken from the
corresponding dump class definitions.
Note:
- The BACKVOL command fails if the number of retention periods that are specified for RETENTIONPERIOD is greater than the number of classes specified for DUMPCLASS.
- RETENTIONPERIOD is applicable only if DUMPCLASS is specified.
- If DUMPCLASS is specified without RETENTIONPERIOD, the retention periods are taken from the dump classes specified.
- DFSMShsm will not automatically delete the last and only copy of a source volume, regardless of the RETENTIONPERIOD set. To delete the dump volumes in this copy, issue the DELVOL command with the LASTCOPY option for one of the dump volumes. All of the volumes in the copy will be deleted.