3. TABULAR REPORTS, GRAPHS, AND MICF INQUIRIES › 3.2 Sample Graphics › 3.2.1 How to Produce Sample Graphics
3.2.1 How to Produce Sample Graphics
The CA MICS Network Analyzer Option Sample Graphics consist
of eleven programs, each of which produces a single graph for
a particular network component such as a link, a
communications controller, or a cluster controller, or for an
application. To generate one of the sample graphics, you
must first tailor the program to your data center's
conventions. This section describes how to tailor the
graphic report programs and how to run them using the MICSSHR
procedure.
Some selection options may be coded using macros provided in
the report program. These are:
o Report selection low time threshold
o Report selection high time threshold
o System Identifier (SYSID) selection
o Network Identifier (NETWRKID) selection
o Data base unit identifier selection
The database unit identifier selection is required, along
with several other selection choices described later in this
section.
REPORT PROGRAM STRUCTURE
Each sample graphics report is produced by a separate report
program. The report programs, identified by name in Figure
3-34, are named SNTGcxx, where
c is the report class 1 = Service Analysis
2 = Workload Analysis
3 = Reliability Analysis
xx is a sequential report number
Each report program has the following sections:
* DEFINE DATA CENTER DEPENDENT DATA;
This section defines macros used in the data selection
process. The macros provided are:
%LET SNTDLHR = 8;
Used to select low data time. Set to 8:00 AM in
this case.
%LET SNTDHHR = 17;
Used to select high data time. Set to 5:00 PM in
this case.
%MACRO SNTSYID;
%MEND SNTSYID;
Used to select System ID. An example of code for
this macro is:
%MACRO SNTSYID;
IF SYSID = 'T084';
%MEND SNTSYID;
%MACRO SNTNEID;
%MEND SNTNEID;
Used to select Network ID. An example of code for
this macro is:
%MACRO SNTNEID;
IF NETWRKID = 'TSONETWK';
%MEND SNTNEID;
%LET SNTD = BSNTD;
Used to set the data base identifier. You must
change the database identifier to correspond to the
database unit from which the reports will be run.
The database identifier is in the second position of
the macro operand, B in this case. To change this
for a CA MICS database unit with an identifier of C,
merely change the B to a C, as below:
%LET SNTD = CSNTD;
To change the timespan selected for the graph,
change the final character in the macro operand, D
in this case, to one of the other acceptable
timespans:
X - DETAIL
D - DAYS (in this example)
W - WEEKS
M - MONTHS
Y - YEARS
Remember that not all files in this product are
supported in all timespans. See the file
descriptions throughout Chapter 5 to determine if
the file exists in your desired timespan.
For example, to select MONTHS data instead of DAYS
data, change the D to M, as follows:
%LET SNTD = CSNTM;
* SET OPTIONS;
SAS and SAS/GRAPH options are set in this section.
Remember that these graphs are set up to run with all
supported versions of SAS, as documented in section
6.7 of the System Administrator Guide.
It is important to tell SAS/GRAPH software the device
you are using for the graphs. This is done in the
DEVICE= operand. IBM3279 is used in all sample
routines.
A sample GOPTIONS statement is supplied below:
GOPTIONS CTITLE=GREEN DEVICE=IBM3279 BAUD=9600
BORDER VPOS=40 COLORS=(WHITE);
* COLLECT THE DATA;
The SET statement determines which file and cycle will
be selected. To change the cycle, modify the last two
numeric values of the SAS data set name. The change
from cycle 01 to cycle 03 is
BEFORE: SET &SNTD.SNTPSY01;
AFTER: SET &SNTD.SNTPSY03;
* SELECT DESIRED OBSERVATIONS;
SYSID, Network ID, time period, and network component
or application are selected here.
You MUST select a network component or application
here. The following table shows the Report-ID and the
variable name that you select. Each report routine
has an example coded in this section to guide you.
Thus, in report SNTG103, Application Service Analysis
by Hour, the sample selection statement is
IF PLU='CICSPROD' OR PLU='CICSTEST';
+-----------------+-------------+
| Select Variable | Report ID |
+-----------------+-------------+
| NSVPCLSS | SNTG101 |
+-----------------+-------------+
| PLU | SNTG102 |
+-----------------+-------------+
| PLU | SNTG103 |
+-----------------+-------------+
| NSVPCLSS | SNTG104 |
+-----------------+-------------+
| NETNAME | SNTG201 |
+-----------------+-------------+
| NCPNAME | SNTG202 |
+-----------------+-------------+
| NCPNAME | SNTG203 |
+-----------------+-------------+
| NETNAME | SNTG204 |
+-----------------+-------------+
| NETNAME | SNTG301 |
+-----------------+-------------+
| NSFFRNAM | SNTG302 |
+-----------------+-------------+
| NEFFRNAM | SNTG303 |
+-----------------+-------------+
Other selections may be coded in this section.
* PROCESSING;
Summarization and sequencing is performed in this
section.
* SETUP VARIABLES FOR PRINTING;
The CALL SYMPUT function is used to set up macro
variables for printing in the TITLE and FOOTNOTE
statements.
* CHART THE DATA;
The SAS/GRAPH GCHART or GPLOT statements are defined
in this section.
* DEFINE THE PATTERNS AND SYMBOLS;
Chart or Plot symbols and patterns are defined in this
section.
* TITLE AND FOOTNOTES;
Titles and Footnotes are defined in this section.
PRODUCING THE SAMPLE GRAPHICS
The sample graphics described in the following sections are
produced using the standard CA MICS CLIST, MICSSHRd where d
is the database identifier of the database unit containing
the CA MICS Network Analyzer Option. Follow the steps below
to produce the graphic inquiries:
___ 1. Ensure that the version of SAS being invoked by
the MICSSHRd procedure includes SAS/GRAPH
software. (Note that SAS/GRAPH software is a
separately licensed product.)
___ 2. To invoke Network Sample Graphics under
SAS/GRAPH software, you must use a graphics
terminal supported by SAS/GRAPH. Refer to the
SAS/GRAPH documentation for a list of graphics
devices supported by SAS/GRAPH software.
___ 3. Edit the graph program using ISPF or another
similar editor and follow the steps outlined.
This is best explained using a particular graph
routine. We have chosen SNTG102. It may be
useful to print a copy of this routine to
review with this example.
Note that the mandatory steps are identified as
REQUIRED in the left margin.
Optional a. Select 7:00 AM as the low data timestamp and
update the &SNTDLHR macro variable.
%LET SNTDLHR = 7;
Optional b. Select 4:00 PM as the high data timestamp and
update the &SNTDHHR macro variable.
%LET SNTDHHR = 16;
Optional c. Select only data from system 'T033' and update
the %SNTSYID macro.
%MACRO SNTSYID;
IF SYSID = 'T033';
%MEND SNTSYID;
Optional d. Select only data from network 'PRODNY01' and
update the %SNTNEID macro.
%MACRO SNTNEID;
IF NETWRKID = 'PRODNY01';
%MEND SNTNEID;
REQUIRED e. Select the database unit identifier, D, and
update the &SNTD macro variable.
%LET SNTD = DSNTD;
Note that there is no change made to the file
timespan, so the DAYS timespan is selected.
Optional f. Select the 02 cycle and update the SET
statement in the * COLLECT THE DATA section of
the program.
SET &SNTD.SNTPSY02;
REQUIRED g. Select one or two applications to be displayed
on the report (the data element name for
application is primary logical unit (PLU)).
Applications 'TSOPRIM' and 'TSOTEST' will be
selected in the * SELECT DESIRED OBSERVATIONS
section of the program.
IF PLU='TSOPRIM' OR PLU='TSOTEST';
IMPORTANT: Only programs SNTG102 and SNTG103
provide for selection of more than one network
component or application. In all other graphic
programs you may select only one component or
application.
___ 4. Access SAS from the CA MICS Workstation Facility
(MWF) main panel by selecting option 3, SAS With
CA MICS Libraries. Then, from this panel select
option 3, SAS with CA MICS Database Unit
Selection. Next, you will be prompted by a panel
where can select the the database unit at your
site that contains the CA MICS Network Analyzer
Option.
___ 5. Enter the following %INCLUDE statement when
prompted by SAS:
%INCLUDE SOURCE(SNTG102);
RUN;