3.1 TLM Component Reports


The Tape Library Management (TLM) reports are generated by
inquiries accessed using the CA MICS Information Center
Facility (MICF), which is part of the CA MICS Workstation
Facility (MWF).

The MICF inquiries distributed with the component produce
meaningful reports from the CA MICS database files.  These
distributed inquiries can be copied and modified using the
Database Inquiries option on the MICF main menu.  The MICF
facility also provides the flexibility to code and save user-
designed reports.


Reports for the TLM component are distributed as MICF
inquiries and are listed in Figure 3-1.

All of the TLM inquiries generate line-printer reports.
Samples of each report are presented in the following
sections.

The reports are generated from the DAYS timespan files.

User Modification
-----------------

 The MICF inquiries provide a user exit in the independent
 source step that can be used to perform more data element
 modification or record selection from the CA MICS database.
 To invoke this exit, the shared inquiry must first be copied
 into the private MICF catalog, then selected for
 modification.  Finally, the SAS statements must be coded in
 the SELECT macro, bracketed by the %MACRO and %MEND
 statements, which are provided.
 
 The default for the SELECT macro is null.  This macro is
 invoked when the observations are read from the specified CA
 MICS files.  The macro can be used to delete observations
 from the data as it is processed.  For example, for a
 published study, you can change the actual VTS Library
 Sequence Numbers (IVTVLS) and VTS Composite Library ID
 (IVTCMPID) values that appear in the report.  The following
 code would accomplish this requirement:
 
      %MACRO SELECT;
        IF IVTVLS   = 'PROD01' THEN IVTVLS   ='VTS001' ;
        IF IVTCMPID = 'PRDC01' THEN IVTCMPID ='CMP001' ;
        ... additional remapping statements ...
      %MEND  SELECT;
 
 Use this macro to exclude systems from the report, for
 example, exclude all test systems:
 
      %MACRO SELECT;
        IF SYSID NE: 'T';
      %MEND  SELECT;
 
 IMPORTANT!  All SAS statements must be coded in accordance
 with the syntax of the SAS Macro Language, as described in
 the SAS guides.  No validity checking is done on the defined
 code.  If the user code contains syntax errors or the logic
 produces syntax errors, the inquiry is either terminated
 abnormally or produces unpredictable results.


Inquiry Naming Conventions
--------------------------

The TLM component MICF inquiry names follow the form cccptn,
where:

ccc =        The three-character product identifier (TAP).

p =          The type of report: C (color graphic), L (list),
             or P (printer).

t =          The technology reported on is T for Tape Library
             Management.

n =          A character that differentiates this inquiry
             from others.

For example, an inquiry named TAPLTB would be interpreted
as follows:

TAPLTB ---||+= the second list inquiry | || | |+= for Tape Library Management | | | += a list inquiry | += a Tape Analyzer Option inquiry +--------------+----------------------------------------------+----------+ | Report Class | Report Name | Report ID| +--------------+----------------------------------------------+----------+ | Storage | Tape Data Set Summary Report | TAPLTA | | | Tape Volume Summary Report | TAPLTB | +--------------+----------------------------------------------+----------+


 Figure 3-1.  MICF Distributed Inquiries for Tape Library Management

These MICF inquiries for the TLM component are accessed
through the MICF Inquiries panel of the CA MICS Workstation
Facility (MWF).

The first subsection below explains the layout and user-
modifiable fields in the MICF displays for the TLM reports.
The next sections discuss each of the TLM reports:

    1 - TLM MICF Inquiry Specification Panels
    2 - Tape Data Set Summary Report (TAPLTA)
    3 - Tape Volume Summary Report (TAPLTB)