Previous Topic: 9.2.1 Input CICS Data Dictionary

Next Topic: 9.2.3 Information Area Processing

9.2.2 Input Raw CICS Data


In the input raw CICS data phase, records are read from one
of the data sources specified in prefix.MICS.PARMS(CICOPS).
Data can come from CMF or ASG-TMON.  Any combination of these
data sources can be processed in a given DAY040 step.  For
CICS release 3.1.1 and above, the CA MICS Analyzer Option for
CICS also reads CICS statistics data to obtain system level
information previously provided by CMF global data.

The CA MICS Analyzer Option for CICS also processes any data
that has the same format as any of the above data sources,
such as the CMF type 110 look-alike records produced by
OMEGAMON II for CICS.

The data from these sources is processed sequentially.  That
is, all CMF data is processed, followed by all ASG-TMON data.
The data is formatted to create SAS observations.

Figure 9-2 outlines the flow of this phase.

The user exits invoked in this phase are listed below.  An X
in the data source column means that you can code the exit
using data from that source.

                                               CMF MON
    o  General exits                           ---  ---

       You have the option to define your
       own database file during the main
       input step using the following exits:

       _USRSDKP -  user file name & keeplist    X    X
       _USRSLFL -  user file len, fmt, lbl      X    X

       After reading the SMF record header,
       you can use the following exit to
       skip records before any data
       validation takes place:

       %USRSKIP -  skip unwanted data           X

       After the product section has been
       input, but prior to input of the data
       sections, the following exit is
       invoked:

       _USRSEL  -  input record selection       X    X

       This exit can be used to change the
       original SYSID since it is invoked
       prior to the SYSID macro.  It cannot
       reference any transaction-level
       information since it is invoked prior
       to the input of the data sections.

       %USRSCID -  set CICSID                   X

       This exit can be used to set the
       CICSID when the record's
       ORGSYSID/APPLID is not defined in
       CICOPS.

                                               CMF  MON
    o  Output exits                            ---  ---

       Prior to the output of the specified
       file, these exits can be used for
       data element manipulation:

       _USRSCIN -  CICCIN element derivation    X    X
       _USRSCSW -  CICCSW element derivation    X    X
       _USRSCMF -  CMF transaction-level        X
                   exit
       %USRSCST -  CICS statistics (CICS 3.1    X
                   and higher)
       %USRSTAT -  STATCOPY for CICS stats      X
                   (CICS 3.1 and higher)
       _USRSCDC -  CICCDC element derivation    X    X
       _USRSCSY -  CICCSY element derivation    X    X
       _USRSCSU -  CICCSU element derivation    X    X
       _USRSCAU -  CICCAU element derivation    X    X
       _USRSCAC -  CICCAC element derivation    X    X
       _USRSCSF -  CICCSF element derivation         X
       _USRUTID -  ASG-TMON user segment ID          X
       _USRSCMR -  CICCMR element derivation         X

                                               CMF  MON
    o  Parameter-related exits                 ---  ---

       CICRLRT  -  relative longevity           X    X
       CICACRT  -  account code derivation      X    X
       CICAURT  -  application unit deriv.      X    X
       CICMSAC  -  multi-system account         X    X
                   derivation exit

******************** * Initialization * ******************** | +------------------+ | Delete level 00 | | and oldest cycles| +------------------+ | +------------------+ | Delete any | | work files | +------------------+ | +------------------+ | Initialize | | process control | | variables | +------------------+ | +-------------------+ | Input thresholds | | from PARMS | | member CICTHRSH | +-------------------+ | +-------------------+ | Initialize | | $CICDEP INFORMAT | | | | Input SOURCE | | (CICDEPEL) | +-------------------+ | /------------\ no +-------------+ < $CICDEP OK? >------->| ABEND 470 | \ +-------------+ | +------------------+ | Load data | | dictionary | | arrays | +------------------+ | +-------+ | 2-1 | +-------+

 Figure 9-2.  Input Raw Data Processing (Part 1 of 13)

+-------+ | 2-1 | +-------+ | /----------\ no +-------+ < CMF data ? >-------->| 5-1 | \ +-------+ | yes /----------\ no +-------+ |<-----------------< More DDns? >----->| 5-1 | | \ +-------+ +-----------------+ | | Select INFILE | | | DDNAME | yes| +--------+ +-----------------+ no /----------\ | 2-2 |---------------------------------->|<-----------------< End of File?> +--------+ +-----------------+ \ | Input SMF header | +-------------------+ | +-----------------+ | Verify release | +-----------------+ | +------------------+ | Process | | product section | +------------------+ | /---------------\ +-------+ < CICS statistics?>------>| 2-3 | \ +-------+ | /-----------\ / DDNAME \ no +-------+ < APPLID combo >------>| 2-2 | \ in $CICSEL? / +-------+ \ | **************** * _USRSEL exit * **************** | /-------------\ no +-------+ < Data from new >------>| 3-1 | \ region? / +-------+ \ | +------------------+ +-----------------+ +------------+ | Call CICVMAM to |----->| Call $CICDEP |------>| Initialize | +-------+ | get new region | | to update array | | elements |---->| 3-1 | | array elements. | +-----------------+ +------------+ +-------+ +------------------+

 Figure 9-2.  Input Raw Data Processing (Part 2 of 13)

+-------+ | 2-3 | +-------+ | +------------------+ | Process | | data section | +------------------+ | /-------------\ no +-------+ < Section len >------>| 2-2 | \ OK? / +-------+ \ | **************** * %USRSCST exit * **************** | +------------------+ +----------------+---------------| Record selection |-+-----------------+---------------------+------------------+ | | +------------------+ | | | | | | | | | | | +-----------+ +------------+ +--------------+ +----------+ +-------------+ +----------------+ +--------------+ | Dispatcher| | Loader | | Stor. Mgr | | Stor. Mgr| | Temp Storage| | Transient Stor.| | Transaction | | (57 or 56)| | (27) | | Subpool (8,6)| | (9 or 2) | | (48) | | (45) | | Mgr (10) | +-----------+ +------------+ +--------------+ +----------+ +-------------+ +----------------+ +--------------+ | | | | | | | +----------------+------------------+-----------------+-----------------+---------------------+----------------+ | /-------------\ no +-------+ < Any of the >------>| 2-3 | \ above type? / +-------+ \ | +------------------+ +----------------+---------------| Output work files|-+--------------+-------------------+------------------+ | | +------------------+ | | | | | | | | | | | +-----------+ +------------+ +-------------+ +----------+ +-------------+ +----------------+ +-------------+ | Dispatcher| | Loader | | Stor. Mgr | | Stor. Mgr| | Temp Storage| | Transient Stor.| | Transaction | | (CICGDP) | | (CICGLD) | | (CICGST) | | (CICGSM) | | (CICGTS) | | (CICGTD) | | Mgr (CICGTM)| +-----------+ +------------+ +-------------+ +----------+ +-------------+ +----------------+ +-------------+ | | | | | | +----------------+------------------+-----------------+----------------+---------------------+ | +-------+ | 2-3 | +-------+

 Figure 9-2.  Input Raw Data Processing (Part 3 of 13)

+-------+ | 3-1 | +-------+ | +-----------------+ | Process CICS | | section | +-----------------+ | /-----------\ no +-------+ < More >-------->| 2-2 | \ sections?/ +-------+ \ | /-----------\ no +-------+ < Section len >-------->| 2-2 | \ OK? / +-------+ \ | /-----------\ no +-------+ < Valid class?>-------->| 3-1 | \ +-------+ | /-----------\ no +-------+ < Dictionary >-------->| 3-2 | \ data? / +-------+ \ | +-----------------+ **************** | Output record |<----->* User output * | to CICCDC | * exit USRSCDC * +-----------------+ **************** | +------------------+ | Call CICVMAM to | +-------+ | update region |----->| 3-1 | | array elements. | +-------+ +------------------+

 Figure 9-2.  Input Raw Data Processing (Part 4 of 13)

+-------+ | 3-2 | +-------+ | +-----------------+ | Process CICS | | data records | +-----------------+ | /-----------\ no +-------+ < More data >-------->| 3-1 | \ records? / +-------+ \ | +------------------+ | Pass connectors | | to $CICDEP | +------------------+ | +------------------+ | Call $CICDEP | | to process data | +------------------+ | /------------\ no +-------+ < $CICDEP OK? >------->| 2-2 | \ +-------+ | +-------+ | 4-1 | +-------+

 Figure 9-2.  Input Raw Data Processing (Part 5 of 13)

+-------+ | 4-1 | +-------+ | /-----------\ no +-----+ < Transaction >-------->| 4-2 | \ data? / +-----+ ----------- | **************** | * User output * |<-------------->* exit USRSCMF * | **************** | +-------------------+ | Perform variable | | computations | +-------------------+ | +-----------------+ **************** | Output record |<----->* User output * | to CICCIN | * exit USRSCIN * +-----------------+ **************** | +-----------------+ | Perform trans | | code translation| %CICTRAN | for CSW | +-----------------+ | **************** | * Relative * |<-------------->* longevity * | * exit CICRLRT * | **************** | | **************** |<-------------->* Account exit * | * CICACRT * | **************** | | **************** |<-------------->* Application * | * exit CICAURT * | **************** | +-----------------+ **************** | Output record |<----->* User output * | to CICCSW | * exit USRSCSW * +-----------------+ **************** | +-------+ | 3-2 | +-------+

 Figure 9-2.  Input Raw Data Processing (Part 6 of 13)

+-------+ | 4-2 | +-------+ | /-----------\ no +-----+ < Global >-------->| 4-3 | \ data? / +-----+ ----------- | **************** | * User output * |<-------------->* exit USRSCMF * | **************** | | +-------------------+ | Perform variable | | computations | +-------------------+ | +-----------------+ **************** | Output record |<----->* User output * | to CICCSY | * exit USRSCSY * +-----------------+ **************** | +-------+ | 3-2 | +-------+ +-------+ | 4-3 | +-------+ | +------------------+ **************** | CMF accounting |<---->* User output * | and exception | * exit USRSCMF * | record selection | **************** +------------------+ | +-------+ | 3-2 | +-------+

 Figure 9-2.  Input Raw Data Processing (Part 7 of 13)

+-------+ | 7-1 | +-------+ | | /--------------\ / ASG-TMON \ no +-------+ \ data? /------>| 10-1 | \ +-------+ | +-----------------+ | Select INFILE | | DDNAME | +-----------------+ yes /----------\ no +-------+ |<-----------------< More DDns? >----->| 10-1 | | \ +-------+ +-----------------+ | | Select INFILE | | | DDNAME | | +-----------------+ | | | +-------------------+ | | Initialize | | | CICMONUT process | | | and pass DDNAME | | +-------------------+ | | | /------------\ no | +-----------+ < CICMONUT OK? >------------------------->| ABEND 998 | \ | +-----------+ +-------+ | yes | | 7-2 |---------------->| no /-----------\ +-------+ |<-----------------< End of file?> +-----------------+ \ | Input record | +-----------------+ | +------------------+ | Pass connectors | | to $CICDEP | +------------------+ | /-----------\ +------------------+ /-----------\ / DDNAME \ +-------+ | Call $CICDEP |----->< $CICDEP OK? >------->< APPLID combo >------->| 8-1 | | to process rec. | \ \ in $CICSEL? / +-------+ +------------------+ | \ no | | +-------+ no | | 7-2 | +-------+ +-------+ | 7-2 | +-------+

 Figure 9-2.  Input Raw Data Processing (Part 10 of 13)

+-------+ **************** +-----+ | 8-1 |------->* _USRSEL exit * |8-1-1| +-------+ **************** +-----+ | | +----------------------------------------+ | | Perform trans code translation for CSW | %CICTRAN +----------------------------------------+ | | **************** /------------\ no +-------+ | * exit CICRLRT * < Transaction? >------->| 9-1 | |<-------------->* exit CICACRT * \ +-------+ | * exit CICAURT * | | **************** +-------------------------------+ | | Perform variable computations | +-----------------+ **************** +-------------------------------+ | Output record |<----->* User output * | | to CICCSW | * exit USRSCSW * +-----------------+ **************** +-----------------+ **************** | Output record |<----->* User output * | | to CICCIN | * exit USRSCIN * +-------+ +-----------------+ **************** | 7-2 | | +-------+ +----------------+ | Process file | | segments | +----------------+ | +-----------------+ **************** | Output record |<----->* User output * | to CICCSF | * exit USRSCSF * +-----------------+ **************** | +----------------------+ | Process user segment | +----------------------+ | +----------------------------------+ | Process user clocks and counters | +----------------------------------+ | +----------------------+ | Process MRO segments | +----------------------+ | +-----------------+ **************** | Output record |<----->* User output * | to CICCMR | * exit USRSCMR * +-----------------+ **************** | +-----+ |8-1-1| +-----+

 Figure 9-2.  Input Raw Data Processing (Part 11 of 13)

+--------+ +--------+ | 9-1 | | 9-2 | +--------+ +--------+ | | /--------------\ +-----------------+ / \ no +--------+ | ASG-TMON | < System Record >------->| 9-2 | | TD Record | \ / +--------+ +-----------------+ \ | | +------------------+ +------------------+ | Perform variable | | Perform variable | | computations | | computations | +------------------+ +------------------+ | | +-----------------+ +-----------------+ | Output record | | Output record | | to CICCTD | | to CICCSX | +-----------------+ +-----------------+ | | +-------+ +-------+ | 7-2 | | 7-2 | +-------+ +-------+

 Figure 9-2.  Input Raw Data Processing (Part 12 of 13)

+-------+ | 10-1 | +-------+ | +------------------+ | If ASG-TMON | | data, then | | FINISH CICMONUT | +------------------+ | +------------------+ | Issue MICSLOG | | messages | +------------------+ | /-------\ / \ yes +-------------+ < Processing >--------->| Abend U998 | \ abend? / +-------------+ \ | +------------------+ | Update checkpt | +------------------+ | ************************ * End input processing * ************************

 Figure 9-2.  Input Raw Data Processing (Part 13 of 13)