Previous Topic: 3.2 Sample Graphics

Next Topic: 3.2.2 Sample Graphics Descriptions

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;