Previous Topic: 5.2.7.2 CICCSY Data Elements List

Next Topic: 5.2.7.4 CICCSY Retrieval Examples

5.2.7.3 CICCSY Usage Considerations


This section identifies some special considerations or
techniques for using the CICCSY File.

1.  The following data elements are defined within the
    CICGENIN member of sharedprefix.MICS.GENLIB and are
    reserved for user derivation:

    CSYSRU   - System Resource Units
    CSYEXCPS - I/O (EXCPs) Generated
    CSYSERVU - Service Units
    CSYSRMTR - SRM Ended Transactions
    CSYCONTM - Terminal Connect Time

2.  The following data elements are dependent upon the
    options set within the prefix.MICS.PARMS(CICOPS) member
    or the prefix.MICS.PARMS(SYSID) member.  This dependency
    is outlined below.

    prefix.MICS.PARMS(SYSID)
      CSYCPUNI - Instructions Executed

    prefix.MICS.PARMS(CICOPS) - parameter RESP
      CSYRVAL1-CSYRVAL8 - Response Distribution Limits

3.  The ENDTS and STARTTS, when appearing in the DAYS, WEEKS,
    MONTHS, or YEARS timespans, bound the span of time over
    which the data has been summarized, with STARTTS being
    the lowest date and time, and ENDTS the highest date and
    time for the data summarized.

4.  The data elements in the following list do not exist in
    the DETAIL timespan for the CICCSY File.  These data
    elements are not derived from the raw data, but rather
    are derived by a summarization of the CICCSU DAYS file.

    CSYCDST1 - CSYCDST8 - Count Conv. Responses In Limit
    CSYCRSTM - Conversational Response Time Total
    CSYCTRN  - Conversational Transactions Processed
    CSYDAMSC - Damaged Storage Chain
    CSYERSTM - Excessive Response Time Total
    CSYETRN  - Excessive Transactions Processed
    CSYINCH  - Input Message Character Traffic
    CSYINVPA - Invalid CMF Call Encountered
    CSYLDST1 - CSYLDST8 - Count Long Responses In Limit
    CSYLRSTM - Long Response Time Total
    CSYLTRN  - Long Transactions Processed
    CSYMDST1 - CSYMDST8 - Count Medium Responses In Limit
    CSYMRSTM - Medium Response Time Total
    CSYMTRN  - Medium Transactions Processed
    CSYMXCTM - Max Conversational Response Time
    CSYMXETM - Max Excessive Response Time
    CSYMXLTM - Max Long Response Time
    CSYMXMTM - Max Medium Response Time
    CSYMXSTM - Max Short Response Time
    CSYMXTSK - Max Tasking Condition
    CSYMXTTM - Max Response Time All Functions
    CSYOUTCH - Output Messages Character Traffic
    CSYPCCR1 - CSYPCCR7 - Cumm Pct Conv Resp In Limit
    CSYPCLR1 - CSYPCLR7 - Cumm Pct Long Resp In Limit
    CSYPCMR1 - CSYPCMR7 - Cumm Pct Medium Resp In Limit
    CSYPCSR1 - CSYPCSR7 - Cumm Pct Short Resp In Limit
    CSYPCTR1 - CSYPCTR7 - Cumm Pct All Resp In Limit
    CSYSDST1 - CSYSDST8 - Count Short Responses In Limit
    CSYSOS   - Short On Storage Condition
    CSYSRSTM - Short Response Time Total
    CSYSTRN  - Short Transactions Processed
    CSYTMERR - CMF Timing Error Encountered
    CSYTRANS - Total Transactions Ended in Interval
    CSYTRSTM - Total Response Time All Functions

5.  CICS System File User Data Accumulation

    While most data elements in the CICCSY File contain
    system data, some elements originate from the CICCSU File
    and provide transaction statistics.  This combination of
    elements allows the CICCSY File to retain a complete
    picture of system activity.  This is necessary because
    response time distribution or system stress data is not
    in the system records produced by any supported monitor.

    The data elements derived from the DAYS.CICCSU
    transaction data are:

    CSYCDSTX - Count Conv. Responses Within Limit
    CSYCRSTM - Conversational Response Time Total
    CSYCTRN  - Conversational Transactions Processed
    CSYDAMSC - Damaged Storage Chain
    CSYERSTM - Excessive Response Time Total
    CSYETRN  - Excessive Transactions Processed
    CSYFCTOT - Total File Requests
    CSYIMSGS - Input Messages Issued
    CSYINCH  - Input Message Character Traffic
    CSYINVPA - Invalid CMF Call Encountered
    CSYLDSTx - Count Long Responses Within Limit
    CSYLRSTM - Long Response Time Total
    CSYLTRN  - Long Transactions Processed
    CSYMDSTx - Count Medium Responses Within Limit
    CSYMRSTM - Medium Response Time Total
    CSYMTRN  - Medium Transactions Processed
    CSYMXCTM - Max Conversational Response Time
    CSYMXETM - Max Excessive Response Time
    CSYMXLTM - Max Long Response Time
    CSYMXMTM - Max Medium Response Time
    CSYMXSTM - Max Short Response Time
    CSYMXTSK - Max Tasking Condition
    CSYMXTTM - Max Response Time All Functions
    CSYOMSGS - Output Messages Issued
    CSYOUTCH - Output Messages Character Traffic
    CSYSDSTx - Count Short Responses Within Limit
    CSYSIOCT - Access Method Calls
    CSYSOS   - Short On Storage Condition
    CSYSRSTM - Short Response Time Total
    CSYSTRN  - Short Transactions Processed
    CSYTDSTx - Count Total Responses Within Limit
    CSYTMERR - Monitor Timing Error Encountered
    CSYTRANS - Total Transactions Ended
    CSYTRSTM - Total Response Time All Functions

    During the summarization process for the DAYS.CICCSY
    File, a subset of the DAYS.CICCSU DAYS data is created
    (the CSR work file).  This file contains the data
    elements being carried over from the transaction data to
    the CICCSY system records.  The CSY data being summarized
    and the CSR data previously created is then merged to
    create the complete CICCSY observation for this CICS
    system.

    Note: Missing CICS system records will cause transaction
    data for that interval to be lost.

    Example:

    The data element CSYTRANS is the number of transaction
    records for the interval.  This statistic is not
    contained in the CMF global records or the monitor task
    accounting system records, so it must be derived from the
    transaction data.  During the special daily summarization
    process for the CSY file, the summarized DAYS.CICCSU00
    file is passed and certain data elements are extracted,
    including CSUTRANS.  The intermediate file, called
    CICCSR, is sorted into CICCSY DAYS timespan sequence.
    Then CICCSR and DAYS.CICCSY00 are input into the same
    DATA statement.  The values of CSUTRANS are summarized
    into a retained data element called SSYTRANS.  When the
    associated CICCSY record is encountered and rewritten,
    the value of CSYTRANS is assigned from SSYTRANS, and
    SSYTRANS is reset to zero.