Previous Topic: View Log Stream Online for Event Capture OptionNext Topic: View Log Streams Online for CICS Option


Step 5: (Optional) Define a Set of Log Streams for CICS Option (INST0044)

This step is required only if you are running the CA SYSVIEW Option for CICS.

This step defines a set of log streams to contain records that the CICS data collectors created.

The CICS data collectors route the records through a specified CICS logger running in the CA SYSVIEW main address space. Multiple CICS loggers can be defined.

A unique log stream must be created for each CICS logger that has been defined on each system.

Note: The parmlib members for specifying log stream names are located in the sysview.CNM4BPRM data set.

Follow these steps:

  1. Specify the log streams as shown in the examples that follow this procedure. You can define 1- to 4-log streams.

    The suggested naming convention for the log stream is as follows:

    ssidrrm.cicslogr.TRAN.smfi
    ssidrrm.cicslogr.TSUM.smfi
    ssidrrm.cicslogr.SYSD.smfi
    ssidrrm.cicslogr.XLOG.smfi
    
    ssid

    Specifies the CA SYSVIEW subsystem ID

    rrm

    Specifies the release number

    cicslogr

    Names the CICS logger

    smfi

    Specifies the SMF ID

    The log data types are as follows:

    TRAN

    Specifies the CICS transaction log

    TSUM

    Specifies the CICS transaction summary

    SYSD

    Specifies the CICS system data

    XLOG

    Specifies the CICS exception log

    Important! Multiple log data types can share a log stream. Sharing the log stream that is defined to contain the CICS transaction log record is not recommended. The volume of data in this log is much greater than other log types.

  2. Specify the name of the log stream that is defined in this step in the following parmlib members:
    CICSLOGR

    Provides default configuration options for the CICS Data Logger function.

    If a log stream is not going to be used or has not been defined, set the appropriate option value to NONE.

    LOGSTREAM-CICSTRAN-NAME    NONE
    LOGSTREAM-CICSTSUM-NAME    NONE
    LOGSTREAM-CICSSYSD-NAME    NONE
    LOGSTREAM-CICSXLOG-NAME    NONE
    
    LGLOOKUP

    Associates a log name that is defined in this member with a log stream name.

    Sysname  Logname......... LogStream-Name
    Sysname  CICSLOGR.TRAN... logstream.name
    Sysname  CICSLOGR.TSUM... logstream.name
    Sysname  CICSLOGR.SYSD... logstream.name
    Sysname  CICSLOGR.XLOG... logstream.name
    
  3. Submit the INST0044 job.

    The log streams for the CICS option are defined, and the contents of CA SYSVIEW maintained log streams can be viewed online.

Example: Define a TRAN Log Stream

This example shows a CICS transaction log stream:

DATA TYPE(LOGR) REPORT(NO)
DEFINE LOGSTREAM
          NAME(GSVX130.CICSLOGR.TRAN.smfi)
          AUTODELETE(YES)
          DASDONLY(YES)
          DESCRIPTION(CICS_TRANLOG)
          DIAG(NO)
          EHLQ(LOGGER)
          HIGHOFFLOAD(70)
          LOWOFFLOAD(0)
          LS_SIZE(20000)
          MAXBUFSIZE(32767)
          MODEL(NO)
          OFFLOADRECALL(YES)
          RETPD(5)
          STG_SIZE(15000)

Example: Define a TRANSUMM Log Stream

This example shows a CICS transaction summary log stream:

DEFINE LOGSTREAM
          NAME(GSVX130.CICSLOGR.TSUM.smfi)
          AUTODELETE(YES)
          DASDONLY(YES)
          DESCRIPTION(CICS_TRANSUMM)
          DIAG(NO)
          EHLQ(LOGGER)
          HIGHOFFLOAD(70)
          LOWOFFLOAD(0)
          LS_SIZE(1000)
          MAXBUFSIZE(32767)
          MODEL(NO)
          OFFLOADRECALL(YES)
          RETPD(30)
          STG_SIZE(750)

Example: Define a SYSD Log Stream

This example shows a CICS data log stream:

DEFINE LOGSTREAM
          NAME(GSVX130.CICSLOGR.SYSD.smfi)
          AUTODELETE(YES)
          DASDONLY(YES)
          DESCRIPTION(CICS_SYSDATA)
          DIAG(NO)
          EHLQ(LOGGER)
          HIGHOFFLOAD(70)
          LOWOFFLOAD(0)
          LS_SIZE(1000)
          MAXBUFSIZE(32767)
          MODEL(NO)
          OFFLOADRECALL(YES)
          RETPD(90)
          STG_SIZE(750)

Example: Define an XLOG Log Stream

This example shows a CICS exception log stream:

DEFINE LOGSTREAM
          NAME(GSVX130.CICSLOGR.XLOG.smfi)
          AUTODELETE(YES)
          DASDONLY(YES)
          DESCRIPTION(CICS_XLOG)
          DIAG(NO)
          EHLQ(LOGGER)
          HIGHOFFLOAD(70)
          LOWOFFLOAD(0)
          LS_SIZE(1000)
          MAXBUFSIZE(32767)
          MODEL(NO)
          OFFLOADRECALL(YES)
          RETPD(30)
          STG_SIZE(750)