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.