5. FILES › 5.2 IMS Information Area Files › 5.2.2 IMS User Activity File (IMSISU) › 5.2.2.3 IMSISU Usage Considerations

5.2.2.3 IMSISU Usage Considerations

This section identifies any special considerations or
techniques related to using the IMSISU file.  Additionally,
sample retrieval examples are provided to help you use this
file.


In the examples, a SAS macro variable is used to specify the
DDname part of the CA MICS file name. These macro variables
are a standard part of CA MICS and are available for all
files. The macro variable name has the form &diiit, where d
is the database identifier, iii is the information area
name, and t is the timespan.  For the examples, a database
identifier of P is used.  The identifier is installation
dependent, so you should find out what the identifiers are at
your installation.

Special Considerations/Techniques

1.  The following data elements are reserved in this record
    for future use:

      ISUPETTM - Pseudo Elapsed Time
      ISUSRU   - System Resource Units
      ISUCOST  - Processing Charges

2.  Use of the following data element is dependent upon the
    MIPS rate parameter of prefix.MICS.PARMS(SYSID).  Its use
    should be within the frame of reference of the option's
    definition:

      ISUCPUNI - Instructions Executed

3.  Be careful using the special date and time data elements
    contained in each CA MICS file. As the IMSISU file's
    granularity increases in higher timespans, the following
    fields lose significance and should not be used in the
    case described:

      o  HOUR should not be used in MONTHS.
      o  DAY and DAYNAME should not be used in MONTHS.
      o  WEEK should not be used in MONTHS.

4.  The STARTTS and ENDTS, when appearing in the DAYS, WEEKS,
    MONTHS, or YEARS timespans, mark the span of time over
    which the data has been summarized, with STARTTS being
    the lowest (earliest) date and time and ENDTS the highest
    (latest) date and time.


Retrieval Examples

1.  Print IMS application CPU time used yesterday by hour of
    the day.

    PROC FREQ DATA=&PIMSD..IMSISU01;
    TABLES HOUR / NOROW NOCOL; WEIGHT ISUCPUTM; RUN;


2.  Generate a block chart of the percentage of IMS
    application CPU time spent in each message or control
    region functional area.  Use yesterday's data.

    DATA SUMF (KEEP= TIMETYPE PERCENT);
    SET &PIMSD..IMSISU01 END=EOF;
    RETAIN TOTTOT CDLTOT CBFTOT DOCTOT DDLTOT DBFTOT
           DCPTOT 0;
       CDLTOT + ISUTMCDL;
       CBFTOT + ISUTMCBF;
       DOCTOT + ISUTMDOC;
       DDLTOT + ISUTMDDL;
       DBFTOT + ISUTMDBF;
       DCPTOT + ISUTMDCP;
       IF EOF  THEN DO;
         TOTTOT+CDLTOT+CBFTOT+DOCTOT+DDLTOT+DBFTOT+
           DCPTOT ;
         IF TOTTOT NE 0  THEN DO;
           TIMETYPE = 'CTL DLI';
           PERCENT  = 100 * CDLTOT / TOTTOT;
           OUTPUT SUMF;
           TIMETYPE = 'CTL BUF';
           PERCENT  = 100 * CBFTOT / TOTTOT;
           OUTPUT SUMF;
           TIMETYPE = 'OPN/CLOS';
           PERCENT  = 100 * DOCTOT / TOTTOT;
           OUTPUT SUMF;
           TIMETYPE = 'DEP DLI';
           PERCENT  = 100 * DDLTOT / TOTTOT;
           OUTPUT SUMF;
           TIMETYPE = 'DEP BUF';
           PERCENT  = 100 * DBFTOT / TOTTOT;
           OUTPUT SUMF;
           TIMETYPE = 'DEP CPU';
           PERCENT  = 100 * DCPTOT / TOTTOT;
           OUTPUT SUMF;
         END;
       END; RUN;
       PROC CHART DATA=SUMF;
       BLOCK TIMETYPE / SUMVAR=PERCENT ; RUN;