Appendix C. TAPE INTERFACE

While information about your tape library does not currently
reside in CA MICS, CA MICS StorageMate provides an external
interface that allows you to place tape-related information
in a non-CA MICS SAS data set.  This section documents the
steps you must take to create this external data set before
attempting to use tape data in any of the CA MICS StorageMate
reports.  You do not need to follow these steps unless you
plan to process TMC or TLMS data as an input source to
CA MICS StorageMate.

Five sample jobs are distributed with this product as an
example of how external tape library information can be
placed into a SAS data set and then read as input by CA MICS
StorageMate.  These sample jobs are contained in the
following members:

o sharedprefix.MICS.CNTL(STGEXTP1) -- for CA-1 4.9
o sharedprefix.MICS.CNTL(STGEXTP3) -- for CA-1 5.0
o sharedprefix.MICS.CNTL(STGEXTP4) -- for CA-1 5.2 and higher
o sharedprefix.MICS.CNTL(STGEXTP2) -- for TLMS 5.4
o sharedprefix.MICS.CNTL(STGEXTP5) -- for TLMS 5.5 and higher

The sample jobs are designed to use data from your tape
management software system as input into the CA MICS
StorageMate product.  The distributed samples are designed to
use data from two of the more popular tape management library
systems.  Other tape library software can be used if you can
adapt the samples to process the tape data correctly.  The
documentation included with the sample jobs describes the
name of the SAS data set you must create, and the elements it
must contain.  Any routine that creates a data set in this
described format should be able to work with the CA MICS
StorageMate product.

The first step in the STGEXTP1, STGEXTP3 and STGEXTP4 sample
jobs extracts tape information from the tape master catalog
using the TMSDATA utility supplied with TMS/CA-1 and writes
it to a flat file.  To convert the data to SAS format, a
second step is executed that converts the flat file to a SAS
database file with one observation present for each active
tape.

The STGEXTP2 and STGEXTP5 sample jobs read data directly from
the TLMS VMF file and convert it into a SAS data set,
also with each tape represented by one observation.

Macro %STGTAPEX within each sample job may need to be
modified to set the following element correctly:

TAPACTx - Similar to other CA MICS files, up to nine account
          fields may be defined and populated.  By default,
          all sample routines define three accounting
          elements (TAPACT1-TAPACT3) and populate them based
          on the accounting information in the raw TMS and
          TLMS accounting fields, as follows:

TAPACT1 - Positions 1-5 of the accounting area
TAPACT2 - Positions 6-10 of the accounting area
TAPACT3 - Positions 11-15 of the accounting area

For more detailed information, refer to the provided samples.