Date filter parameters

To define a date range, you must specify the beginning and ending dates of the range by using one of the following pairs of parameters:

• For an assigned date inclusion filter, specify both REQU_ASSIGN_BEGN_DATE_INC and REQU_ASSIGN_END_DATE_INC.
• For an assigned date exclusion filter, specify both REQU_ASSIGN_BEGN_DATE_EXC and REQU_ASSIGN_END_DATE_EXC.
• For a tape-creation date inclusion filter, specify both REQU_CREATE_BEGN_DATE_INC and REQU_CREATE_END_DATE_INC.
• For a tape-creation date exclusion filter, specify both REQU_CREATE_BEGN_DATE_EXC and REQU_CREATE_END_DATE_EXC.
• For a last-referenced date inclusion filter, specify both REQU_REF_BEGN_DATE_INC and REQU_REF_END_DATE_INC.
• For a last-referenced date exclusion filter, specify both REQU_REF_BEGN_DATE_EXC and REQU_REF_END_DATE_EXC.

Also, you can create inclusion or exclusion filters based on a date that is matched against tape or data-set expiration dates by specifying the REQU_EXPR_DATE_INC and REQU_EXPR_DATE_EXC parameters. The following related parameters can affect how this filtering occurs: REQU_DFRM_USE_VRS, REQU_USE_DSRET_AS_DSNEXP, and REQU_USE_EXP_WHEN_DSNOTRET. For more information about filtering based on expiration dates, see How expiration or retention dates are used in tape filtering.

REQU_ASSIGN_BEGN_DATE_INC=date

Specifies a DFSMSrmm assigned date as the starting date of a date range for including tapes in the copy job. An assigned date is the date on which a data set was first written to the tape. This date must be in the format YYYY/DDD.

REQU_ASSIGN_END_DATE_INC=date

Specifies a DFSMSrmm assigned date as the ending date of a date range for including tapes in the copy job. This date must be in the format YYYY/DDD.

REQU_ASSIGN_BEGN_DATE_EXC=date

Specifies a DFSMSrmm assigned date as the starting date of a date range for excluding tapes from the copy job. An assigned date is the date on which a data set was first written to the tape. This date must be in the format YYYY/DDD.

REQU_ASSIGN_END_DATE_EXC=date

Specifies a DFSMSrmm assigned date as the ending date of a date range for excluding tapes from the copy job. This date must be in the format YYYY/DDD.

REQU_CREATE_BEGN_DATE_INC=date

Specifies a tape-creation date as the starting date of a date range for including tapes in the copy job. This date must be in the format YYYY/DDD.

REQU_CREATE_END_DATE_INC=date

Specifies a tape-creation date as the ending date of a date range for including tapes in the copy job. This date must be in the format YYYY/DDD.

REQU_CREATE_BEGN_DATE_EXC=date

Specifies a tape-creation date as the starting date of a date range for excluding tapes from the copy job. This date must be in the format YYYY/DDD.

REQU_CREATE_END_DATE_EXC=date

Specifies a tape-creation date as the ending date of a date range for excluding tapes from the copy job. This date must be in the format YYYY/DDD.

REQU_REF_BEGN_DATE_INC=date

Specifies a DFSMSrmm last-referenced date as the starting date of a date range for including tapes in the copy job. A last-referenced date is the date on which the tape was last accessed to read or write data. This date must be in the format YYYY/DDD.

REQU_REF_END_DATE_INC=date

Specifies a DFSMSrmm last-referenced date as the ending date of a date range for including tapes in the copy job. This date must be in the format YYYY/DDD.

REQU_REF_BEGN_DATE_EXC=date

Specifies a DFSMSrmm last-referenced date as the starting date of a date range for excluding tapes from the copy job. A last-referenced date is the date on which the tape was last accessed to read or write data. This date must be in the format YYYY/DDD.

REQU_REF_END_DATE_EXC=date

Specifies a DFSMSrmm last-referenced date as the ending date of a date range for excluding tapes from the copy job. This date must be in the format YYYY/DDD.

REQU_EXPR_DATE_INC=date

Specifies a date that Tape Optimizer matches against tape or data-set expiration dates to determine whether to include the tapes or data sets in the copy job. Any tapes or data sets that have expiration dates later than the specified date are eligible for copying. If your site uses VRS retention dates, Tape Optimizer will match the date in this field against retention dates instead (provided that you do not set the REQU_DFRM_USE_VRS parameter to N). This parameter is useful when you want to copy tapes that contain recent data. The date must be in the format YYYY/DDD.

REQU_EXPR_DATE_EXC=date

Specifies a date that Tape Optimizer matches against tape or data-set expiration dates to determine whether to exclude the tapes or data sets from copying. Any tapes or data sets that have expiration dates earlier than the specified date are not copied. If your site uses VRS retention dates, Tape Optimizer will match the date in this field against retention dates instead (provided that you do not set the REQU_DFRM_USE_VRS parameter to N). This parameter is useful when you want to avoid copying tapes that expire soon. The date must be in the format YYYY/DDD.

In the Tape Optimizer interface, you specify this information on the Date Filters panel (GTOP02B).