Enhancements to Existing Features › Options › Option for CICS › Configuration Options - Parmlib Member CICSOPTS

Configuration Options - Parmlib Member CICSOPTS

The configuration options member CICSOPTS has been enhanced to include the following options:

CEAPM-MRO

Default: Yes

Change: This option can be modified after initialization using the CCONFIG or CICSSET commands.

CA Cross-Enterprise APM - CICS Transaction Trace integration provides performance information about CICS transactions. CA SYSVIEW provides the performance details for those transactions that execute in CICS regions.

The CICS transactions can run as a transaction within a single CICS region or as a more complex transaction running in several CICS MRO regions. This environment is sometimes referred to as a TOR to the AOR environment.

Specify whether to perform transaction correlation in an MRO environment.

The MRO environment includes the following requests:

• The LINK requests to programs running in a different CICS region within the same z/OS system
• Transaction START requests to initiate a transaction in the same CICS region
• Transaction START requests to initiate a transaction in a different CICS region within the same z/OS system

Valid Values:

• No - Do not perform transaction correlation for MRO transactions.
• Yes - Perform transaction correlation for MRO transactions.

Related Options:

• CEAPM-MRO-LINK
• CEAPM-MRO-START

CEAPM-MRO-LINK

Default: Yes

Change: This option can be modified after initialization using the CCONFIG or CICSSET commands.

CA Cross-Enterprise APM - CICS Transaction Trace integration provides performance information about CICS transactions. CA SYSVIEW provides the performance details for those transactions that execute in CICS regions.

The CICS transactions can run as a transaction within a single CICS region or as a more complex transaction running in several CICS MRO regions. This environment is sometimes referred to as a TOR to the AOR environment.

Specify whether to perform transaction correlation for program LINK requests.

Valid Values:

• No - Do not perform transaction correlation for program LINKs.
• Yes - Perform transaction correlation for program LINKs.

Related Options:

• CEAPM-MRO
• CEAPM-MRO-START

CEAPM-MRO-START

Default: Yes

Change: This option can be modified after initialization using the CCONFIG or CICSSET commands.

CA Cross-Enterprise APM - CICS Transaction Trace integration provides performance information about CICS transactions. CA SYSVIEW provides the performance details for those transactions that execute in CICS regions.

The CICS transactions can run as a transaction within a single CICS region or as a more complex transaction running in several CICS MRO regions. This environment is sometimes referred to as a TOR to the AOR environment.

Specify whether to perform transaction correlation for transaction START requests.

Valid Values:

• No - Do not perform transaction correlation for transaction START requests.
• Yes - Perform transaction correlation for transaction START requests.

Related Options:

• CEAPM-MRO
• CEAPM-MRO-LINK

DynAllocUseMsgLevel0

This option controls whether the DYNALLOC requests set the S99MSGL0 flag in the S99RB.

Default: Yes

Change: This option can be modified after initialization using the CCONFIG or CICSSET commands.

Valid Values are:

• Yes - The DYNALLOC S99MSGL0 option is set for all dynamic allocation requests. This value causes the dynamic allocation request to ignore the JCL MSGLEVEL= operand and to use MSGLEVEL=(,0) instead.
• No - The DYNALLOC S99MSGL0 option is not set for any dynamic allocation request. This value allows normal JCL MSGLEVEL= operand value to be used.

LOGGER-CONNECT-RETRY-COUNT

This option specifies the retry limit for connecting to the CICS logger.

Default: 20

Change: This option can only be set during the initialization using the CICSOPTS parmlib member.

The CICS data collector initialization process attempts to connect to a CICS logger that executes in the Main Services Address Space or Auxiliary Address Space. If the connect fails, multiple retry attempts can be made up to the retry limit count specified.

Valid Values:

0 - Specifies that no retries are attempted.

Minimum - 1

Maximum - 20

Related Options:

• LOGGER-CONNECT-RETRY-INTERVAL
• LOGGER-NAME

LOGGER-CONNECT-RETRY-INTERVAL

Specifies the retry interval for connecting to the CICS logger.

Default: 15

Change: This option can only be set during the initialization using the CICSOPTS parmlib member.

The CICS data collector initialization process attempts to connect to a CICS logger that executes in the Main Services Address Space or Auxiliary Address Space. If the connect fails, multiple retry attempts can be made at the specified interval in seconds.

Valid Values:

Minimum - 5

Maximum - 60

Related Options:

• LOGGER-CONNECT-RETRY-INTERVAL
• LOGGER-NAME

MEI-DEBUG

The CA SYSVIEW for CICS Monitor Exit Interface (MEI) provides CICS programs or transactions an API into the CA SYSVIEW for CICS data collection process.

Information that is passed to the MEI is recorded in the detailed transaction record of the calling transaction.

The MEI-DEBUG option can be used to format the MEI parameter blocks to help the diagnosis of potential problems.

Default: No

Change: This option can be modified after initialization using the CCONFIG or CICSSET commands.

The formatted/dumped storage is written as messages to the GSVCLOG ddname.

Sample formatted messages:

GSVC146I (Task) MEI Trace    9 TUMB     652 UserData: dataxyz
GSVC910I (Task) Address   00000000_44180C70   Length 00000160
GSVC911I (Task) Offset--  ------+0 ------+4 ------+8 ------+C
GSVC912I (Task) 00000000  00000009 00000000 00000000 00000000
GSVC912I (Task) 00000010  00000000 00000000 00000000 00000000
GSVC912I (Task) 00000020  8481A381 85938594 8595A395 81948540

Enable SYSVIEW Monitor Exit Interface (MEI) debugging.

Valid Values:

• No - Do not format debug data
• Yes - Format debug diagnostic data

Related Options:

MEI-LOGGING

MEI-LOGGING

The SYSVIEW for CICS Monitor Exit Interface (MEI) provides CICS programs or transactions an API into the SYSVIEW for CICS data collection process.

Information that is passed to the MEI is recorded in the detailed transaction record of the calling transaction.

The MEI-LOGGING option can be used to log MEI requests to help the diagnosis of potential problems.

Default: No

Change: This option can be modified after initialization using the CCONFIG or CICSSET commands.

The log messages are written to the GSVCLOG ddname.

Example logging messages:

GSVC146I GSVCMEI Trace 9 TUMB 661 UserData: dataelementname
GSVC146I CICSMEI Trace 9 TUMB 661 UserData: ThisIsMyDataKey
GSVC146I CICSMEI Trace 9 TUMB 661 UserData: ThisIsMyCounter
GSVC146I CICSMEI Trace 9 TUMB 661 UserData: ThisIsMyCounter
GSVC146I CICSMEI Trace 9 TUMB 661 UserData: ThisIsMyDataKey2
GSVC146I CICSMEI Trace 9 TUMB 661 UserData: ThisIsMyDataKey3
GSVC146I CICSMEI Trace 6 TUMB 661 Event: EXECCICS Type: Event001
GSVC146I GSVCMEI Trace 6 TUMB 661 Event: GSVCMEI  Type: Event001
GSVC146I CICSMEI Trace 1 TUMB 661 Name: TestMEI  Type: SYSVIEW
GSVC146I GSVCMEI Trace 5 TUMB 661 FldCode:   6 Data: GSVCMEI
GSVC146I CICSMEI Trace 2 TUMB 661 Program: PROG0001
GSVC146I CICSMEI Trace 2 TUMB 661 Program: PROG0002
GSVC146I GSVCMEI Trace 2 TUMB 661 Program: PROG0003
GSVC146I GSVCMEI Trace 7 TUMB 661 Event: GSVCMEI  Type: Event001
GSVC146I CICSMEI Trace 7 TUMB 661 Event: EXECCICS Type: Event001

Valid Values:

• No - Do not log the MEI requests.
• Yes - Log the MEI requests.

Related Options:

MEI-DEBUG

MONITOR-DISPATCH-PRIORITY

Default: Yes

Change: This option can be modified after initialization using the CCONFIG or CICSSET commands.

During the initialization, each CICS connects to a specific CICS logger task running in a Main Services address space or Auxiliary Services address space.

The CICS logger is responsible for the logging of all historical data for the CICS region.

The address space executing the CICS logger must execute with a dispatching priority that is higher than the CICS that is connecting to it. Multiple CICS regions can connect to a single CICS logger.

If the CICS region dispatching priority is higher than the CICS logger address space, the CICS regions can overload the CICS logger address space. If the CICS logger is overloaded, data can be lost or discarded.

The activation of dispatch priority monitor monitors or compares the dispatching priorities of the CICS region and connected SYSVIEW CICS logger address space.

If the dispatching priority of the CICS region is greater than or equal to the SYSVIEW CICS logger address space, error message GSVC065 is issued.

Valid Values:

• Yes - Monitor dispatching priorities.
• No - Do not monitor dispatching priorities. A message is issued at the initialization to document the priorities. Monitoring stops.

PERFORMANCE-DATA-EXIT-IC

Default: Yes

Change: This option can be modified after initialization using the CCONFIG or CICSSET commands.

The CICS data collector can monitor and collect detailed information about requests and resources that a transaction used.

This option controls the collection of data made available using CICS global user exits related to the following CICS domain:

• IC - Interval Control

The following related options are required:

• PERFORMANCE-COLLECTION - Yes
• PERFORMANCE-GLOBAL-EXIT-IC - Yes

Detailed performance information regarding the associated overhead of this option can be viewed using the online command: CGBLEXIT

Valid Values:

• No - Do not collect data.
• Yes - Collect data

Related Options:

• PERFORMANCE-GLOBAL-EXIT-IC

PERFORMANCE-DATA-EXIT-XM

Default: Yes

Change: This option can be modified after initialization using the CCONFIG or CICSSET commands.

The CICS data collector can monitor and collect detailed information about requests and resources a transaction used.

This option controls the collection of data made available using CICS global user exits related to the following CICS domain:

• XM - Transaction Manager

The following related options are required:

• PERFORMANCE-COLLECTION - Yes
• PERFORMANCE-GLOBAL-EXIT-XM- Yes

Detailed performance information regarding the associated overhead of this option can be viewed using the online command: CGBLEXIT

Valid Values:

• No - Do not collect data
• Yes - Collect data

Related Options:

• PERFORMANCE-GLOBAL-EXIT-XM

PERFORMANCE-GLOBAL-EXIT-IC

Default: Yes

Change: This option can only be set during the initialization using the CICSOPTS parmlib member.

The CICS data collector can monitor and collect detailed information about requests and resources a transaction used.

This option controls the enablement of CICS global user exits related to the following CICS domain. The exits must be enabled to collect the related data.

• IC - Interval Control

Global user exits to be enabled:

   Exitname  Description (when or when invoked)
   --------  -----------------------------------------------------
   XICREQ    At the beginning of the interval control program request.

Detailed performance information regarding the associated overhead of this option can be viewed using the online command: CGBLEXIT

Valid Values:

• No - Do not enable the global user exits
• Yes - Enable the global user exits

Related Options:

• PERFORMANCE-DATA-EXIT-IC

PERFORMANCE-GLOBAL-EXIT-TS

The CICS data collector can monitor and collect detailed information about requests and resources a transaction used.

This option controls the enablement of CICS global user exits related to the following CICS domain. The exits must be enabled to collect the related data.

• TS - Temporary Storage Domain

Default: Yes

Migration Information: The default value was changed from No to Yes.

Change: This option can only be set during the initialization using the CICSOPTS parmlib member.

Global user exits to be enabled:

• XTSQRIN - Before the invocation of a TSQR function.
• XTSQROUT - After the invocation of a TSQR function.

You can view the detailed performance information regarding the associated option overhead using the online command: CGBLEXIT

This option must be set to YES for the following System Data Collection metric to be collected:

• TEMPSTG - Temp Storage - TSMain in use HWM
• TEMPSTG% - Temp Storage - TSMain in use percent HWM
• TEMPSTGQ - Temp Storage - Queues in use HWM

Valid Values:

• No - Do not enable the global user exits
• Yes - Enable the global user exits

Related Options:

• PERFORMANCE-DATA-SEGLIMIT-TS
• PERFORMANCE-DATA-EXIT-TS

PERFORMANCE-GLOBAL-EXIT-XM

Default: Yes

Change: This option can only be set during the initialization using the CICSOPTS parmlib member.

The CICS data collector can monitor and collect detailed information about requests and resources a transaction used.

This option controls the enablement of CICS global user exits related to the following CICS domain. The exits must be enabled to collect the related data.

• XM - Transaction Manager

Global user exits to be enabled:

   Exitname  Description (when or when invoked)
   --------  ----------------------------------------------------- 
   XXMATT    Invoked during transaction attach

Detailed performance information regarding the overhead that is associated with this option can be viewed using the online command: CGBLEXIT

Valid Values:

• No - Do not enable the global user exits
• Yes - Enable the global user exits

Related Options:

• PERFORMANCE-DATA-EXIT-XM