CICS File/Database Collection Control

The CICS File/Database Collection Control workspace, in the enhanced 3270 user interface, allows you to control how IBM® Z OMEGAMON® for CICS® collects file and database details.

IBM Z OMEGAMON for CICS can provide both task level and file level details about certain types of data accessed by the task, including MQ. Task level will record overall statistics for the task, where file level details report against each file or database the task has used.

This feature is typically requested via the Global Data area. This panel allows you to update the requested settings for an active CICS region. Changes made here are not permanent; they last only until the CICS region is recycled.

To navigate to this panel:
  1. From the All Active CICSplexes panel (the CICS tab on the OMEGAMON Products panel), select a CICSplex from the CICSplex Name column.
  2. Find the CICS region you want to work with, on the CICSples Regions Summary panel, and enter C to the left of the region name; this brings up the CICS Control Functions menu.
  3. Select D CICS File/Database collection control to bring up the CICS File/Database Collection Control panel.

File/Database Collection for CICS region

This top section of the panel lets you enable or disable statistics for each type of data for the selected CICS region.

Task Level Monitor

This option will collect metrics to indicate the number of requests and how much time has elapsed for the type of data selected. Task level monitoring cannot be changed for VSAM.

File Level Monitor

This option will collect information for each file or database the task has accessed. File level monitoring requires that task level monitoring be active.

Write to Task History

This option will record the collected data for a task to Task History. This will provide the information about each type of data used in the Transaction Detail panel. Selecting a type will provide details on each file or database.

Write to SMF

This option will record the collected information to SMF. The data can then be processed by utilities such as IBM CICS Performance Analyzer.

Remote Files

This option should only be enabled in a file owning region. Files are typically monitored from the EXEC CICS request. In a file owning region, this may not occur, so you may want to enable this option.

Other Collection Statuses

This panel allows you to configure several options related to Monitoring in CICS and SMF recording.

CICS Monitoring Status
This option reports on the current status of the CICS Monitoring Facility (CMF). IBM Z OMEGAMON for CICS uses CMF data to provide many of the features of IBM Z OMEGAMON for CICS. CMF is typically enabled if it is not active when IBM Z OMEGAMON for CICS initializes. If CMF is disabled, the following features will not be available:
  • Task History
  • Application Trace
  • Service Level Analysis
  • File statistics
  • Storage statistics
  • Program statistics
  • Task CPU utilization
  • Resource limiting for some resource types
CICS SMF Data

This option indicates whether IBM Z OMEGAMON for CICS will allow CICS performance data to be written to SMF. If this is set to No, then IBM Z OMEGAMON for CICS will suppress any SMF data from going to SMF. This does not impact Task History or Service Level Analysis reporting.

OMEGAMON Monitoring Status
This option reports on the current status of OMEGAMON in the CICS region. If monitoring is disabled, IBM Z OMEGAMON for CICS will not install the exits required to collect data, and the following features will not be available:
  • Task History
  • Application Trace
  • Service level Analysis
Compress OMEGAMON SMF

This option indicates whether OMEGAMON will compress the data that it produces before writing to SMF. This includes the file or database records, and program statistics. If no file, database, or program statistics are written to SMF, this option will not be applicable.

Include SLA Data

This option indicates if the SLA data for this region is to be reported upon by the OMEGAMON Service Level Analysis feature.

This panel uses attributes from the CICSplex Collection Control Details attribute group.