Required parameters

The following are the required parameters of the ARCHBDEL macro:

ALL

DATE

TIME

VERS

are mutually exclusive required parameters.

ALL: specifies that all backup versions are to be deleted, including both active and retained backup versions. ALL does not delete retired versions.
DATE: specifies the address of a field that contains the date when the backup version to be deleted was created. For dateaddr, specify the address of a data area that contains the backup date. The field referenced by dateaddr must contain 7 digits in the form of yyyyddd.
TIME: specifies the address of the field that contains the time when the backup version to be deleted was created. For timeaddr, specify the address of the data area that contains the backup time. The field referenced by timeaddr must contain 6 digits in the form of hhmmss.
VERS: specifies a list of versions to delete. Specify the address of a structure that contains a 2-byte number of entries on the list, followed by entries (2-bytes each) containing the version number (001–999) that you want to delete. You can use the ARCXTRCT macro to extract data for version numbers that currently exist. For more information on this macro, see ARCXTRCT: Extracting data from DFSMShsm. You cannot use the VERS keyword to delete retained backup copies.

DSN

specifies the address of a field that contains the fully qualified name of the data set to be processed. For dsnaddr, use the address of the 44-byte data area that contains the data set name. The data set name must be left-justified and padded with blanks. This data set can be either SMS-managed or non-SMS-managed.

WKAREA

specifies the address of a 200-byte work area that will contain the information specified in the macro. For waaddr, substitute the address of the work area. The work area must be below the 16MB line. The work area serves as a temporary storage area for the macro processing that is available to you as soon as the macro returns control to your program.