DFSMShsm and ADSM Support

The Control-M/Tape interfaces for DFSMShsm and ADSM (ADSTAR Distributed Storage Manager) are identical. The same members and steps are used for both of these EDMs. However, for easier reading, the steps shown below mention only DFSMShsm.

The ARCTVEXT member in the IOA SAMPEXIT library is called by DFSMShsm whenever a tape volume no longer contains valid data. The exit marks the volume as scratch in the Media Database and, optionally, interfaces with an automated tape library at the site.

Figure 35 DFSMShsm Calling the ARCTVEXT Member

Use the following steps to implement the Control-M/Tape to DFSMShsm interface:

1. If you are currently not using Exit ARCTVEXT, continue with Step 2 below.

   If this exit is already in use at your site (meaning, by another tape management system), use the following steps to integrate your current ARCTVEXT exit with Control-M/Tape’s exit in Global Test and Global Phased modes. You should stop using your other product’s ARCTVEXT exit when you first activate Control-M/Tape in Global Production mode.

   1. Rename the load module of the ARCTVEXT exit currently in use at your site. You cannot have two exits with the same name in the DFSMShsm LOAD library.
   2. Change all occurrences of keyword $TMSEXT$ in the ARCTVEXT sample member that is supplied with Control-M/Tape to the exit name you chose in Step A.
   3. "Uncomment" the lines marked *CALLEXIT by replacing the asterisk in the first column with a space.
2. Install the DFSMShsm interface using the ICE Automatic Exit Installation Tool to compile the ARCTVEXT member. For details about this tool, see the exits chapter of the INCONTROL for z/OS Administrator Guide.

   The EDM now calls the ARCTVEXT exit supplied with Control-M/Tape that in turn calls the old ARCTVEXT (that has been renamed).

   Figure 36 DFSMShsm Calling the ARCTVEXT Member Supplied with Control-M/Tape

DFSMShsm receives a return code from the exit that communicates with the old tape management system. (This exit was originally named ARCTVEXT.)

1. Verify that the IOA LOAD library is defined as one of the DFSMShsm STEPLIB libraries or as one of the system’s LINKLIST libraries.
2. Make sure that DO RETENTION=EDM statements exist in rules for the data sets created by DFSMShsm, including the CDS backup data sets. This statement indicates that the data sets indicated in the rule's selection criteria are EDM-controlled. Job names, data set names and program names can be used as selection criteria by the rules. The following rule can be used:

   ON DATASET = * AND

   ON PGM = ARCCTL

   DO RETENTION = EDM

   Note: ADSM invokes deletion Exit ARCTVEXT when it releases a tape. This exit, which is invoked in the ADSM address space, is identical to the ARCTVEXT exit used by DFSMShsm.

To disable the old ARCTVEXT exit and replace it with the new ARCTVEXT exit, issue the following commands in this order:

SETSYS EXITOFF(ARCTVEXT)
SETSYS EXITON(ARCTVEXT)

You can use the CTTSYNC utility to list all inconsistencies between the Media database and the DFSMShsm OCDS file. You can run this utility occasionally, just to ensure that the two databases are synchronized.