Starting Your Product › How to Configure Without CA CSM › Define Log Streams (INST0040 - INST0046) › Step 6: (Optional) Define a Log Stream for IMS Option (INST0045)

Step 6: (Optional) Define a Log Stream for IMS Option (INST0045)

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

This step defines a set of log streams to contain records the IMS transaction data loggers created.

The IMS transaction data loggers create records that are logged through a task running in the CA SYSVIEW main address space. When multiple IMS loggers are running, each logger can share a specific log stream or can define a specific log stream for its use.

Note: Multiple loggers and types can share a log stream. However, sharing the log stream containing IMS transaction log records is not recommended. The volume of data in this log is greater than in other log types.

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

Follow these steps:

1. Specify a log stream as shown in the examples that follows this procedure.

   The following naming convention for the log stream is suggested:

   ssidrrm.IMSLOGR.IMRS.smfi
   

   ssidrrm.IMSLOGR.IMTR.smfi
   

   or

   ssidrrm.IMSssid.IMRS.smfi
   

   ssidrrm.IMSssid.IMTR.smfi
   

   ssid

   Specifies the SYSVIEW subsystem ID

   rrm

   Specifies the release number

   IMS

   Specifies the IMS logger name

   ssid

   Specifies the IMS subsystem

   IMRS

   Specifies the log data type for the IMS region summary records

   IMTR

   Specifies the log data type for the IMS transactions

   smfi

   Specifies the SMF ID

2. Specify the name of the defined log stream in the following parmlib members:

   IMSLOGR

   Provides default configuration options for the IMS Data Logger function.

   LOGSTREAM-IMSREGN-NAME   logstream.name
   

   LOGSTREAM-IMSTRAN-NAME   logstream.name
   

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

   LOGSTREAM-IMSREGN-NAME   NONE
   

   LOGSTREAM-IMSTRAN-NAME   NONE
   

   LGLOOKUP

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

   Sysname  Logname......... LogStream-Name
   Sysname  IMSLOGR.IMRS     logstream.name
   Sysname  IMSLOGR.IMTR     logstream.name
   

   or

   Sysname  IMSssid.IMRS     logstream.name 
   Sysname  IMSssid.IMTR     logstream.name 
   

3. Submit the INST0045 job.

   The log stream for the IMS option is defined, and the collected data can be viewed online.

Example: Define an IMRS Log Stream

This example shows an IMS region summary data log stream:

DATA TYPE(LOGR) REPORT(NO)

DEFINE LOGSTREAM
          NAME(GSVX130.IMSLOGR.IMRS.smfi)
          AUTODELETE(YES)
          DASDONLY(YES)
          DESCRIPTION(IMS_RSUMLOG)
          DIAG(NO)
          EHLQ(LOGGER)
          HIGHOFFLOAD(70)
          LOWOFFLOAD(0)
          LS_SIZE(1000)
          MAXBUFSIZE(32767)
          MODEL(NO)
          OFFLOADRECALL(YES)
          RETPD(14)
          STG_SIZE(750)

Example: Define an IMTR Log Stream

This example shows an IMS transaction data log stream:

DATA TYPE(LOGR) REPORT(NO)

DEFINE LOGSTREAM
          NAME(GSVX130.IMSLOGR.IMTR.smfi)
          AUTODELETE(YES)
          DASDONLY(YES)
          DESCRIPTION(IMS_TRANLOG)
          DIAG(NO)
          EHLQ(LOGGER)
          HIGHOFFLOAD(70)
          LOWOFFLOAD(0)
          LS_SIZE(5000)
          MAXBUFSIZE(32767)
          MODEL(NO)
          OFFLOADRECALL(YES)
          RETPD(5)
          STG_SIZE(4000)