Using DFSMShsm user macros

This topic contains general-use programming interface and associated guidance information that allow the customer to write programs that use the services of DFSMShsm.

DFSMShsm has macros available that allow you to request DFSMShsm service from your application programs. When you provide information to the macro and process it from your application program, the macro builds the required DFSMShsm control information and issues the request for DFSMShsm service. The macros are in execute form only. There is no list form provided.

The following user macros are currently supported in DFSMShsm:

ARCFMWE frees up storage in common storage area (CSA)
ARCHBACK backs up a specific data set
ARCHBDEL deletes backed up versions of a data set
ARCHDEL deletes a migrated data set
ARCHMIG migrates a specific data set
ARCHRCAL recalls a data set
ARCHRCOV recovers a data set
ARCHSEND sends a command to DFSMShsm
ARCXTRCT extracts data from DFSMShsm

Note: When these macros are invoked from a application program that runs APF Authorized, in System Key (0 or 7), or Supervisor State, then DFSMShsm bypasses SAF calls for the data sets that are processed. The application owner must ensure that their application program does not introduce a security exposure by enabling unauthorized users access to data via these DFSMShsm macros.