ENDKEY: Determining the ending point for BCDS processing during command execution

Explanation

ENDKEY is an optional parameter that you specify to control on which BCDS record the processing is completed during command execution.

The following is a required parameter of the ENDKEY parameter:
highkey
Provides an ending point for processing in the BCDS. The value of highkey can be up to 44 alphanumeric characters that identify the data set for which you want the deletion of backup versions to end. Numbers are higher in the range (they follow Z) than letters. The value specified cannot end in a period. If fewer than 44 characters are entered, the value specified is appended with X'FF' to make 44 characters.

Defaults

If the ENDKEY subparameter is not specified, the planned end key is different, depending upon whether you specify RESUME. If the RESUME parameter is specified without ENDKEY, processing continues until the last specified planned end key, saved from the last EXPIREBV command issued for this host. If RESUME is specified without ENDKEY and the most recent EXPIREBV command processed in this host did not end early, processing continues to the end of the BCDS. If neither RESUME nor ENDKEY is specified, processing continues to the end of the BCDS.

Usage notes:
  1. When processing is started for the EXPIREBV command, the planned ending key is saved.
  2. If the value of highkey is equal to the value of lowkey, DFSMShsm attempts to process only the data set (MCB) records with those initial characters. If the value of highkey is less than the value of lowkey, DFSMShsm fails the command with an error message.