3. REPORTS › 3.1 Management Objective Reports › 3.1.4 IMS Report Options › 3.1.4.2 Report Options MACRO Example

3.1.4.2 Report Options MACRO Example

Once the management objectives for IMS have been established
they can easily be incorporated into the IMS reports.

The specification of the management objectives to be used in
the reporting process is defined in the #IMSMOBJ member
contained in library prefix.MICS.USER.SOURCE.  This member
consists of a series of SAS MACROs that define values for
the required objectives.

The #IMSMOBJ member is distributed with a set of default
values; it is the responsibility of the CA MICS System
Administrator to initially tailor the values and maintain
them for subsequent installation changes and CA MICS system
maintenance.

Prior to discussing the specification of the objectives
several points should be explained.  All values input by the
user for defining objectives are specified as SAS MACROs for
ease of incorporation into the reporting process.  A brief
explanation of SAS MACROs is provided.  For instance,  the
objective for maximum messages per hour might be defined as:

    MACRO _IMSCAX  6000 %

A SAS MACRO is defined by the word MACRO followed in order by
the name used to reference the MACRO, the value that is to be
substituted any time the MACRO is used in a SAS program,  and
the % sign that signifies the end of the MACRO definition.
For example,  the name of the MACRO in the above statement is
_IMSCAX; any time that _IMSCAX is referenced in the CA MICS
code the value 6000 is substituted.

In changing the objectives used in the reports, the  user  is
simply changing the appropriate MACRO's value to reflect what
should be in the reports for a particular installation.

The user must ensure that the word MACRO, the CA MICS MACRO
name, and the ending % character ARE NOT ALTERED IN ANY WAY,
and the only item changed is the value within the MACRO.

The #IMSMOBJ member is organized to enable the user to
quickly identify the values that require changing and is
laid-out as shown below in Figure 3-16.

    ****************************************************** ;
    * THE FOLLOWING SECTION DEFINES THE OBJECTIVES,      * ;
    * SELECTION FIELDS, AND CHARTING OPTIONS TO BE USED  * ;
    * FOR DAILY, WEEKLY, AND MONTHLY IMS MANAGEMENT      * ;
    * OBJECTIVE REPORTING.                               * ;
    ****************************************************** ;
    * ;
    * TOTAL RESPONSE SPECIFICATIONS ;
    MACRO _IMSPTR   percentage             %
    MACRO _IMSSTR   seconds                %
    * MEDIUM RESPONSE SPECIFICATIONS ;
    MACRO _IMSPMR   percentage             %
    MACRO _IMSSMR   seconds                %
    * SHORT RESPONSE SPECIFICATIONS;
    MACRO _IMSPSR   percentage             %
    MACRO _IMSSSR   seconds                %
    * AVAILABILITY SPECIFICATIONS;
    MACRO _IMSUT    uptime-mins            %
    MACRO _IMSDT    downtime-mins          %
    * MESSAGE THROUGHPUT SPECIFICATION;
    MACRO _IMSCAX   maximum-transactions   %
    MACRO _IMSCREF  target-transactions    %
    * TIME SELECTION SPECIFICATION - DAILY;
    MACRO _IMSDLHR  low-hour               %
    MACRO _IMSDHHR  high-hour              %
    * TIME SELECTION SPECIFICATION  - WEEKLY;
    MACRO _IMSWLHR  low-hour               %
    MACRO _IMSWHHR  high-hour              %
    * ZONE SELECTION SPECIFICATION - MONTHLY ;
    MACRO _IMSHIZN  low-zone               %
    MACRO _IMSLOZN  high-zone              %
    * MONTHLY - MESSAGE THROUGHPUT SPECIFICATION ;
    MACRO _IMSMCAX  maximum-transactions   %
    MACRO _IMSMCRF  target-transactions    %
    * MONTHLY - AVAILABILITY SPECIFICATIONS ;
    MACRO _IMSMUPH   maximum-uphours        %
    MACRO _IMSRUPH   target-uphours         %

Figure 3-16. IMS Report Options in #IMSMOBJ

Figure 3-17 shows how the IMS options have been defined in
#IMSMOBJ in the distributed version of the member.



    ****************************************************** ;
    * THE FOLLOWING SECTION DEFINES THE OBJECTIVES,      * ;
    * SELECTION FIELDS, AND CHARTING OPTIONS TO BE USED  * ;
    * FOR DAILY, WEEKLY, AND MONTHLY IMS MANAGEMENT      * ;
    * OBJECTIVE REPORTING.                               * ;
    ****************************************************** ;
    * ;
    * TOTAL RESPONSE SPECIFICATIONS ;
    MACRO _IMSPTR 95 %
    MACRO _IMSSTR 15 %
    * MEDIUM RESPONSE SPECIFICATIONS ;
    MACRO _IMSPMR 90 %
    MACRO _IMSSMR 15 %
    * SHORT RESPONSE SPECIFICATIONS ;
    MACRO _IMSPSR 95 %
    MACRO _IMSSSR 5 %
    * AVAILABILITY SPECIFICATIONS ;
    MACRO _IMSUT 60 %
    MACRO _IMSDT  0 %
    * MESSAGE THROUGHPUT SPECIFICATION ;
    MACRO _IMSCAX  5000 %
    MACRO _IMSCREF 4000 %
    * TIME SELECTION SPECIFICATION - DAILY ;
    MACRO _IMSDLHR 0 %
    MACRO _IMSDHHR 23 %
    * TIME SELECTION SPECIFICATION - WEEKLY ;
    MACRO _IMSWLHR 8 %
    MACRO _IMSWHHR 17 %
    * ZONE SELECTION SPECIFICATION - MONTHLY ;
    MACRO _IMSHIZN  3 %
    MACRO _IMSLOZN  1 %
    * MONTHLY - MESSAGE THROUGHPUT SPECIFICATION ;
    MACRO _IMSMCAX 200000 %
    MACRO _IMSMCRF 160000 %
    * MONTHLY - AVAILABILITY SPECIFICATIONS ;
    MACRO _IMSMUPH  210 %
    MACRO _IMSRUPH  200 %

Figure 3-17. Completed #IMSMOBJ Member

The installation need only define the management objectives
in the #IMSMOBJ member and the reporting process will be
tailored to your system's definitions.