Report Options MACRO Example

Once the management objectives for IMS have been established they can easily be incorporated into the IMS reports.
rm
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
MICS
System Administrator to initially tailor the values and maintain them for subsequent installation changes and
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
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
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 the following table.
IMS Report Options in #IMSMOBJ
    * ;     * 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         %
The following table shows how the IMS options have been defined in #IMSMOBJ in the distributed version of the member.
Completed #IMSMOBJ Member
    * ;     * 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 %
The installation need only define the management objectives in the #IMSMOBJ member and the reporting process will be tailored to your system's definitions.