Previous Topic: 3.1.1.1 Report Selection

Next Topic: 3.1.1.3 Integrating Reports into the DAILY Job

3.1.1.2 Report Customizing

 
Because of the potentially large volume of data made
available by the CA MICS Network Analyzer, any one of the
standard reports may produce an inordinately large output,
much of which may be of little interest.  To limit this
output, provisions have been made to allow you to select the
data explicitly.  This is accomplished through the use of
user-coded selection macros written in the SAS language.
 
There is one data selection macro for each of the standard
report types generated by the CA MICS report generator.
These macros have names starting with '%SL', followed by a
three-digit Report-ID number.  Thus, the data selection macro
for the SNT101 report is:  %SL101.
 
The data selection macro stubs reside in
sharedprefix.MICS.SOURCE(#SNTRPTS).  Copy the macro stub to
prefix.MICS.USER.SOURCE(#SNTRPTS) after the %INCLUDE for
SOURCE(#SNTRPTS) and add any selection criteria.  The macros
are invoked in a SAS DATA step prior to any sorting or
summarization for reporting.  Thus, any SAS statement which
is valid in a DATA step may be coded in these macros.
 
IMPORTANT:  Only simple selection statements are permitted
within the macros since the data is in a predetermined order
that you cannot modify.  Therefore, using FIRST.  or LAST.
coding and similar data-sequence-dependent functions within
the macros will not work.
 
A set of null macros is supplied with the Analyzer and will
be concatenated ahead of prefix.MICS.USER.SOURCE(#SNTRPTS) in
the input stream.  This prevents a SAS 180 error from
occurring in case you delete and do not replace one of the
sample macros from prefix.MICS.USER.SOURCE.
 
In the following example, the NLDM Service by Performance
Class Report is to be produced only for the critical
performance class, TSODEV, TSO Development.  The selection
logic in the %SL105 report is as follows.  Figure 3-2 lists
each report and its corresponding report ID.  The arrows
( ==> ) in this example indicate user-developed code.
 
      /* SNT105 REPORT OBSERVATION SELECTION MACRO */
==>   /* SELECT ONLY PERFORMANCE CLASS 'TSODEV'    */
     %MACRO SL105;
==>    IF NSVPCLSS = 'TSODEV';
     %MEND SL105;