3. REPORTS › 3.3 Management Objective Reports › 3.3.4 WLM Report Options › 3.3.4.2 Report Options Macro Variables Example

3.3.4.2 Report Options Macro Variables Example

Once the management objectives for WLM have been established
they can easily be incorporated into the WLM Reports.

The specification of the management objectives to be used in
the reporting process are defined in the #RMFMOBJ member
contained in the sharedprefix.MICS.SOURCE library.  This
member consists of a series of SAS macro variables which
define values for the required objectives.  This member,
however, should not be changed.  Changes should instead be
made to #RMFMOBJ in prefix.MICS.USER.SOURCE.

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

All values input by the user for defining objectives are
specified as SAS macro variables for ease of incorporation
into the reporting process.  A brief explanation of SAS macro
variables is provided.  For instance, the threshold for the
percentage of total service consumed by any given service
class per hour is defined as:

  %LET RMFDREF = 30;

A SAS macro variable is defined by the statement %LET
followed in order by the name used to reference the macro
variable, the value that is to be substituted any time the
macro variable is used in a SAS program, and the ; sign which
signifies the end of the macro variable definition.  For
example, the name of the macro variable in the above
statement is RMFDREF and any time that &RMFDREF is referenced
in the CA MICS code, the value 30 is substituted.

In changing the objectives used in the reports, the user is
changing the appropriate macro variable's value to reflect
what should be used in your installation's reports.

The user must ensure that the statement %LET, the CA MICS
macro variable name, and the ending ; character ARE NOT
ALTERED IN ANY WAY, and the only item changed is the value
within the macro variable.

The #RMFMOBJ 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-27.

 ****************************************************** ;
 * The following section defines the objectives,      * ;
 * selection fields, and charting options to be used  * ;
 * for daily, weekly, and monthly Hardware and SCP    * ;
 * Analyzer objective reporting.                      * ;
 ****************************************************** ;

 %LET RMFDREF =  percentage-limit;
 %LET RMFWREF =  percentage-limit;
 %LET RMFMREF =  percentage-limit;
 /* Time selection specification - daily */
 %LET RMFDLHR =  starting-hour;
 %LET RMFDHHR =  ending-hour;

 Figure 3-27. WLM Report Options in #RMFMOBJ


Figure 3-28 shows how the WLM options have been defined in
#RMFMOBJ 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 Hardware and SCP    * ;
  * Analyzer objective reporting.                      * ;
  ****************************************************** ;

  %LET RMFDREF =  30;
  %LET RMFWREF =  30;
  %LET RMFMREF =  30;
  /* Time selection specification - daily */
  %LET RMFDLHR =   8;
  %LET RMFDHHR =  17;

 Figure 3-28. Completed #RMFMOBJ Member

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