ADIC Automated Tape Libraries Managed by HACC

Use the following steps to implement the Control-M/Tape interface to an ADIC (formerly EMASS/GRAU) automated tape library at your site:

Note: A batch interface between Control-M/Tape and the HACC software that synchronizes the CDS (that is, the automated tape library database) with the Control-M/Tape Media Database can also be implemented at your site through an exit supplied with the HACC software. For more information, see the HACC Installation and Customization Reference.

1. Specify HACC as one of the values for the RBTTYPE parameter in the CTTPARM member (through Control-M/Tape step 2.10 in ICE).
2. Use the ICE Automatic Exit Installation Tool (described in the exits chapter of the INCONTROL for z/OS Administrator Guide) to compile the CTTHACC member. The CTTHACC member contains the code necessary for interfacing with the HACC software.
3. Save the CTTRTM procedure under the name CTTRTM2. Rename the CTTRTMB procedure in the procedure library to CTTRTM. The new CTTRTM procedure contains an additional step (CTTRBM) that interfaces with HACC.
4. Save the CTTVTM procedure under the name CTTVTM2. Rename the CTTVTMB procedure in the procedure library to CTTVTM. The new CTTVTM procedure contains an additional step (CTTRBM) that interfaces with HACC.
5. Adjust procedures that access the automated tape library.

   Control-M/Tape uses the HACC API to access the automated tape library and to update the HACC Control Dataset (CDS).

   • If the HACC load library is not in the LINKLIST, it should be added to the STEPLIB DD statement of all procedures that access the automated tape library.
   • If the HACC parameters are defined in another library other than SYS1.PROCLIB, then the following DD card should be added:

     HACCPARM DD DSN=dsname,DISP=SHR

     where dsname is the library where the HACPARM1 member is searched, or

     HACCPARM DD DSN=dsname(memname),DISP=SHR

   where dsname is the library and memname is the member that contain HACC parameters.

   • The following DD card should also be added to all the environments that may access the library:

     HACCOUT  DD  SYSOUT=*

   The list of procedures that may access the automated tape library includes:

   • the CTTRBM step in the CTTRTM and CTTVTM utilities
   • the CTTSYNC utility
   • the IOA Functional Monitor procedure (IOAFMON)

   Note: In order to add the required library to the STEPLIB, edit the procedure of the utility at IOA.PROCLIB library, remove the line 'INCLUDE MEMBER=&IOAENV' and instead add the following lines:

   //STEPLIB DD DISP=SHR,DSN=&STEPLIB
//        DD DISP=SHR,DSN=robotic-tape-library-load-library
//DAPARM  DD DISP=SHR,DSN=&ILPREFA..PARM
//        DD DISP=SHR,DSN=&ILPREFA..IOAENV

   If you have implemented EDM support (for example, using the ARCTVEXT exit for DFSMShsm or the TMSCTLEX exit for CA-Disk), the HACC load library should be added to the DFSMShsm, or CA-Disk procedure STEPLIB.

6. Implement HACC exits.

   Control-M/Tape uses HACC Insert and Eject exits to update the IN-ATL status in volume records of the Media Database. Implement these exits through the following steps:

   1. Use the ICE Automatic Exit Installation Tool (described in the exits chapter of the INCONTROL for z/OS Administrator Guide) to compile the CTTHACVI (the Insert exit) and CTTHACEJ (the Eject exit) members.
   2. Include the expressions VIEXIT=CTTHACVI and EJEXIT=CTTHACEJ in the HACPARM statements in the HACPARM installation library.
   3. Add the IOA LOAD library to the STEPLIB DD statement of the HACC procedure.