PERFORM STATISTICS RECORD

Record statistics immediately.

Read syntax diagramSkip visual syntax diagramPERFORM STATISTICS RECORD
 
                              .-----------------------.
                              V                       |
>>-PERFORM STATISTICS RECORD----+-------------------+-+--------><
                                +-ALL--+----------+-+
                                |      '-RESETNOW-' |
                                +-AUTOINSTALL-------+
                                +-BEAN--------------+
                                +-CONNECTION--------+
                                +-CORBASERVER-------+
                                +-DB2---------------+
                                +-DISPATCHER--------+
                                +-ENQUEUE-----------+
                                +-FEPI--------------+
                                +-FILE--------------+
                                +-+-JOURNALNAME-+---+
                                | '-JOURNALNUM--'   |
                                +-JVMPOOL-----------+
                                +-JVMPROFILE--------+
                                +-JVMPROGRAM--------+
                                +-LSRPOOL-----------+
                                +-MONITOR-----------+
                                +-PIPELINE----------+
                                +-PROGAUTO----------+
                                +-PROGRAM-----------+
                                +-RECOVERY----------+
                                +-REQUESTMODEL------+
                                +-STATS-------------+
                                +-STORAGE-----------+
                                +-STREAMNAME--------+
                                +-SYSDUMP-----------+
                                +-TABLEMGR----------+
                                +-TCPIP-------------+
                                +-TCPIPSERVICE------+
                                +-TDQUEUE-----------+
                                +-TERMINAL----------+
                                +-+-TRANCLASS-+-----+
                                | '-TCLASS----'     |
                                +-TRANDUMP----------+
                                +-TRANSACTION-------+
                                +-TSQUEUE-----------+
                                +-URIMAP------------+
                                +-VTAM--------------+
                                '-WEBSERVICE--------'
 

Conditions: IOERR, NOTAUTH, NOTFND

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 of interval statistics in the SET STATISTICS command in topic SET STATISTICS options - ENDOFDAYSECS.)

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 wish, 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 statistics for each installed resource of the type in question, and for some resource types, CICS keeps global counts as well.

The CICS® Performance Guide contains details about 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.

In addition, you can reset the counts when you use this option (see the RESETNOW option).

AUTOINSTALL
records global statistics on the automatic installation of terminal definitions.
BEAN
records specific statistics for all enterprise beans installed in the CICS region.
CONNECTION
records specific statistics for all connections installed in the CICS region.
CORBASERVER
records specific statistics for all CorbaServers 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.
ENQUEUE
records global statistics for the enqueue manager.
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.
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.
JVMPOOL
records global statistics for the JVM pool.
JVMPROFILE
records specific statistics for all JVM profiles in the CICS region.
JVMPROGRAM
records specific statistics for all Java programs in the CICS region that run in a JVM.
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.
Start of changePIPELINE End of change
Start of changerecords statistics related to a PIPELINE.End of change
PROGAUTO
records global statistics on automatic installation of program definitions.
PROGRAM
records global and specific statistics for all programs installed in the CICS region, except for Java™ programs that run in a JVM (for which you can use the JVMPROGRAM option).
RECOVERY
records global statistics on the recovery manager.
REQUESTMODEL
records statistics for all REQUESTMODEL definitions installed in the CICS region.
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; see the CICS Performance Guide for details.
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 statstics 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.
Start of changeURIMAPEnd of change
Start of changerecords statistics related to a URIMAP resource.End of change
VTAM
records global VTAM statistics for the CICS region.
Start of changeWEBSERVICEEnd of change
Start of changerecords statistics related to a WEBSERVICE resource.End of change

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. (See note below.)
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 CICS was initialized without support for the function. (See note below.)
Note:
When statistics of a requested type are unavailable, CICS raises the IOERR or NOTFND exception condition, as appropriate, but continues through the remaining types, recording as much information as available.

Start of changeNOTFND is also returned if you attempt to use PERFORM STATISTICS RECORD PROGRAM when you should use PERFORM STATISTICS RECORD JVMPROGRAM. See Collecting statistics for Java programs that run in a JVM for additional information.End of change

The RESP2 value n identifies the last type to fail in this way, as follows:

n
 
Resource type
 
1 AUTOINSTALL
2 CONNECTION
3 DISPATCHER
6 FILE
8 JOURNALNUM and JOURNALNAME
10 LSRPOOL
11 MONITOR
12 PROGRAM
13 STATS
14 STORAGE
15 SYSDUMP
16 TABLEMGR
18 TCLASS, TRANCLASS
19 TDQUEUE
20 TERMINAL
21 TRANDUMP
22 TRANSACTION
23 TSQUEUE
24 VTAM
25 FEPI
26 PROGAUTO
28 ENQUEUE
29 RECOVERY
30 STREAMNAME
31 DB2
32 TCPIPSERVICE
33 TCPIP
34 REQUESTMODEL
35 CORBASERVER
36 JVMPOOL
37 JVMPROFILE
38 BEAN
39 JVMPROGRAM
40 MQCONN
Start of change41End of change Start of changeURIMAPEnd of change
Start of change42End of change Start of changeWEBSERVICEEnd of change
Start of change43End of change Start of changePIPELINEEnd of change
[[ Contents Previous Page | Next Page Index ]]