PERFORM STATISTICS RECORD

Description

The PERFORM STATISTICS RECORD command causes current statistics for the resource types and system functions that you specify to be recorded (written out to the SMF data set). Recording occurs immediately, and is not governed by the system options that control the recording of these statistics at intervals. (See the discussion about interval statistics in SET STATISTICS).

Execution of this command does not affect interval or end-of-day statistics either, except when you specify RESETNOW, because the counts are not reset unless RESETNOW is specified.

You can specify as many types of statistics as you want, or you can request all (the ALL option). For each type you request, CICS provides all of the information available (the information that is recorded in interval statistics). For system services, such as dispatch and dynamic transaction backout, CICS keeps summary (global) statistics. For resource types, CICS keeps specific, or resource, statistics for each installed resource of the type in question, and for some resource types, CICS keeps global counts as well.

For resource types that are supported as private resources for applications deployed on platforms, separate statistics records are written for the public resources and for the private resources, each mapped by a different DSECT.

When you use the EXEC CICS PERFORM STATISTICS RECORD command to write resource statistics, use the same resource type keyword whether the resource is public or private. If a resource is a public resource, the public DSECT is used to map its data, and if a resource is a private resource, the private DSECT is used to map its data.

Programs that are declared as application entry points are identified by a field in the DSECTs for public and private program definitions (PROGRAMDEF statistics keyword) and JVM programs (JVMPROGRAM keyword). When interval statistics, end-of-day statistics, requested statistics, requested reset statistics, or unsolicited statistics are produced for a program definition or JVM program that is declared as an application entry point, two statistics records are written, one mapped by the DSECT for public resources, and one mapped by the DSECT for private resources. For the program statistics that are produced by the loader domain (PROGRAM keyword), application entry points are not identified, and only one private program statistics record is written.

For more information about CICS statistics, see Introduction to CICS statistics.

Options

ALL

Records statistics for all resource types and system services. This is the same information that is recorded for interval statistics, and includes counts from the user domain, which are not otherwise available with this command.

ATOMSERVICE

Records specific statistics for all ATOMSERVICE resources that are installed in the CICS region.

AUTOINSTALL

Records global statistics on the automatic installation of terminal definitions.

BUNDLE

Records specific statistics for all BUNDLE resources that are installed in the CICS region.

CAPTURESPEC

Records specific statistics for all capture specifications that are installed in the CICS region.

CONNECTION

Records specific statistics for all ISC over SNA and MRO connections installed in the CICS region.

DB2

Records global statistics for the CICS DB2 connection and specific statistics for each DB2ENTRY defined in the CICS region.

DISPATCHER

Records global statistics on the dispatch function, including task counts and concurrency levels and limits.

DOCTEMPLATE

Records specific statistics for each document template installed in the CICS region.

ENQUEUE

Records global statistics for the enqueue manager.

EPADAPTER

Records specific statistics for all EPADAPTER resources that are installed in the CICS region.

EVENTBINDING

Records specific statistics for all EVENTBINDING resources that are installed in the CICS region.

EVENTPROCESS

Records global statistics for event processing.

FEPI

Records global statistics on the front-end programming interface (FEPI) and specific statistics on FEPI connections, targets, and pools.

FILE

Records specific statistics for all files installed in the CICS region.

IPCONN

Records specific statistics for all IPIC connections installed in the CICS region.

JOURNALNAME

Records specific statistics for all journals installed in the CICS region. This parameter replaces the JOURNALNUM parameter. To record specific statistics for all journals installed in the CICS region, you are recommended to use this parameter.

JOURNALNUM

Records specific statistics returned by the JOURNALNAME parameter.

JVMPROGRAM

Records specific statistics for all public and private Java programs in the CICS region that run in a JVM.

JVMSERVER

Records specific statistics for all JVMSERVER resources.

LIBRARY

Records specific statistics for all public and private LIBRARY resources.

LSRPOOL

Records specific statistics on all VSAM LSR pools defined in the CICS region, including statistics on the files within the pool additional to the statistics produced by the FILE option.

MONITOR

Records global statistics on the monitor function of CICS.

MQCONN

Records global statistics for the WebSphere MQ connection.

PIPELINE

Records statistics related to installed pipelines.

PROGAUTO

Records global statistics on automatic installation of program definitions.

PROGRAM

Records global and specific statistics for all public and private programs installed in the CICS region, except for Java™ programs that run in a JVM (for which you can use the JVMPROGRAM option).

PROGRAMDEF

Records the public and private program definition statistics.

RECOVERY

Records global statistics on the recovery manager.

RESETNOW

Resets all statistics to initial values after recording. You can use this option only in conjunction with the ALL option. The definition of the initial value depends on the statistic being kept; for more information, see CICS statistics in DSECTS and DFHSTUP report.

STATS

Records global statistics about the statistics-gathering function of CICS.

STORAGE

Records global statistics for all CICS dynamic storage subpool areas, and specific statistics by subpool.

STREAMNAME

Records global statistics on the log manager and specific statistics for all the log streams currently connected.

SYSDUMP

Records global statistics on system dumps and specific statistics for each dump code in the system dump code table.

TABLEMGR

Records global statistics on the CICS table manager.

TCLASS

Records specific statistics for every transaction class defined in the CICS region. This option has the same effect as TRANCLASS and is retained for compatibility with older versions of CICS only; use TRANCLASS instead where possible.

TCPIP

Records global statistics on the IP sockets.

TCPIPSERVICE

Records specific statistics for every TCP/IP service installed in the CICS region.

TDQUEUE

Records global statistics for transient data and specific statistics for each queue defined in the CICS region.

TERMINAL

Records specific statistics for each terminal and session installed in the CICS region.

TRANCLASS

Records specific statistics for every transaction class defined in the CICS region.

TRANDUMP

Records global statistics on transaction dumps and specific statistics for each dump code in the transaction dump table.

TRANSACTION

Records global statistics on transactions and specific statistics for each transaction installed in the system.

TSQUEUE

Records global statistics on temporary storage.

URIMAP

Records statistics related to a URIMAP resource.

VTAM (now z/OS Communications Server)

Records global z/OS Communications Server statistics for the CICS region.

WEBSERVICE

Records statistics related to a WEBSERVICE resource.

XMLTRANSFORM

Records statistics related to an XMLTRANSFORM resource.

Conditions

IOERR

RESP2 values:

n

Statistics for at least one of the options chosen were not available; usually the reason for this error is corruption of the memory in which they are accumulated. For more information, see Unavailable statistics.

NOTAUTH

RESP2 values:

100

The user associated with the issuing task is not authorized to use this command.

NOTFND

RESP2 values:

n

Statistics for at least one of the options chosen were not available because, although the resource type is valid, CICS was initialized without support for the function. For more information, see Unavailable statistics.

Unavailable statistics