Explanation: SELECT is an optional parameter that is used to specify a selection filter for the eligibility test performed by the RECYCLE function. The SELECT parameter provides increased granularity to filter out tapes that are considered eligible by the percent valid criteria but do not meet the range that is specified with the SELECT parameter.
When the SELECT parameter is specified, you must specify one or both of the following SELECT subparameters:
| Subparameter | Explanation |
|---|---|
| INCLUDE | INCLUDE(RANGE (volser1:volser2 ...)) specifies that this range of tape volumes is included in the RECYCLE eligibility tests. INCLUDE(RANGE(volser1:volser2 ...)) is a required subparameter of the SELECT parameter. |
| EXCLUDE | EXCLUDE(RANGE (volser1:volser2,...)) specifies that this range of tape volumes is not included in the RECYCLE eligibility tests. EXCLUDE(RANGE(volser1:volser2,...)) is a required subparameter of the SELECT parameter. |
| RANGE | RANGE (volser1:volser2,... specifies
a single volser range, a list of volser ranges, a single volume, or
a list of volumes. When you specify a volser range, volser1 is
the beginning of the range, and volser2 is the end of the
range. When you specify a single volume, use that volume serial number
for both volser1 and volser2. The only limit on
the number of volumes or ranges used for RANGE is the RECYCLE command's
limit of 1023 characters for a single command.
All tape volumes within a specified range are included. If you are including a connected set of tapes, all tape volumes in the connected set must be within the specified range of volumes to be considered as eligible. If any tape volume within a connected set is specified in the excluded range, then that whole connected set is excluded. Message ARC0849I is issued when an ending volume serial is specified before a starting volume serial. |
Defaults: If SELECT is not specified on the RECYCLE command, DFSMShsm uses the percentage specified with the PERCENTVALID parameter to determine RECYCLE eligibility.