INQUIRE MONITOR

Retrieve the status of CICS® monitoring.

INQUIRE MONITOR

hours

minutes

seconds

Conditions: NOTAUTH

This command is threadsafe.

For more information about the use of CVDAs, see a.

Description

Use the INQUIRE MONITOR command to find out whether CICS monitoring is active, which types of data are being recorded, and other recording options.

CICS monitoring is controlled by a main switch (the STATUS option) and four switches that govern which types of data are recorded (the EXCEPTCLASS, PERFCLASS, RESRCECLASS, and IDNTYCLASS options). See the SET MONITOR command for a description of monitor data classes and details about how the switches interact.

Options

APPLNAMEST(cvda)

Returns a CVDA value indicating whether CICS application naming support is enabled. CVDA values are as follows:

APPLNAME: CICS application naming support is enabled.
NOAPPLNAME: CICS application naming support is not enabled.

COMPRESSST(cvda)

Returns a CVDA value indicating whether data compression is active for the CICS SMF 110 monitoring records produced by the CICS monitoring facility. CVDA values are as follows:

COMPRESS: Data compression is being performed for the monitoring records. Data compression is the default.
NOCOMPRESS: Data compression is not being performed for the monitoring records.

CONVERSEST(cvda)

Returns a CVDA value indicating how CICS is to record performance data for conversational tasks (tasks that wait for terminal or session input). CVDA values are as follows:

CONVERSE: CICS produces a performance class record for a conversational task each time it waits for terminal input as well as at task end, representing the part of the task since the previous terminal wait or task start. These waits occur during execution of a CONVERSE command or a RECEIVE command that follows a SEND.
NOCONVERSE: CICS accumulates performance data across terminal waits and produces a single performance class record for a conversational task.

DPLLIMIT(data-area)

Returns the maximum number of distributed program link requests for which CICS is to perform transaction resource monitoring.

EXCEPTCLASS(cvda)

Returns a CVDA value indicating whether the exception class of monitoring data is recorded when monitoring is active. CVDA values are as follows:

EXCEPT: Exception data is recorded.
NOEXCEPT: Exception data is not recorded.

FILELIMIT(data-area)

Returns the maximum number of files for which CICS is to perform transaction resource monitoring.

FREQUENCY(data-area)

Returns the interval at which CICS produces performance class records for long-running tasks. If a task runs longer than the FREQUENCY interval, CICS records its performance data separately for each interval or fraction.

The frequency interval has two formats:

A composite (packed decimal format 0hhmmss+, 4 bytes long), which you obtain by using the FREQUENCY option.
Separate hours, minutes, and seconds, which you obtain by specifying the FREQUENCYHRS, FREQUENCYMIN, and FREQUENCYSEC options.

A value of zero indicates that frequency reporting is inactive; that is, recording of performance data is not affected by the duration of the task.

FREQUENCYHRS(data-area)

Returns the hours component of the frequency interval, in fullword binary form. See the FREQUENCY option.

FREQUENCYMIN(data-area)

Returns the minutes component of the frequency interval, in fullword binary form. See the FREQUENCY option.

FREQUENCYSEC(data-area)

Returns the seconds component of the frequency interval, in fullword binary form. See the FREQUENCY option.

IDNTYCLASS(cvda)

Returns a CVDA value indicating whether the identity class of monitoring data is recorded when monitoring is active. CVDA values are as follows:

IDNTY: Identity data is recorded.
NOIDNTY: Identity data is not recorded.

PERFCLASS(cvda)

Returns a CVDA value indicating whether the performance class of monitoring data is recorded when monitoring is active. CVDA values are as follows:

NOPERF: Performance data is not recorded.
PERF: Performance data is recorded.

RESRCECLASS(cvda)

Returns a CVDA value indicating whether transaction resource monitoring is active in the CICS region. CVDA values are as follows:

NORESRCE: Transaction resource monitoring is not active.
RESRCE: Transaction resource monitoring is active.

RMIST(cvda)

Returns a CVDA value indicating whether additional performance monitoring is active for the resource managers used by your transactions. CVDA values are as follows:

RMI: Performance monitoring is active for the resource managers used by your transactions.
NORMI: Performance monitoring is not active for the resource managers used by your transactions.

STATUS(cvda)

Returns a CVDA value identifying whether CICS monitoring is active in the region. CVDA values are as follows:

OFF: CICS monitoring is not active in the region. No monitoring data is accumulated or written out, regardless of the settings of the monitoring data classes.
ON: CICS monitoring is active. Data is accumulated for all classes of monitor data and is written out for those classes that are active.

SYNCPOINTST(cvda)

Returns a CVDA value indicating whether CICS records performance class data separately for each unit of work (UOW) in tasks that contain multiple UOWs. A UOW in a task ends when a sync point occurs, either explicitly (a SYNCPOINT command) or implicitly (a DL/I TERM call, for example, or task end). A new UOW begins immediately after, except at end of task. When rollback occurs on a sync point, the UOW does not end. CVDA values are as follows:

NOSYNCPOINT: Performance data is combined over all UOWs in a task for recording.
SYNCPOINT: Performance data is recorded separately for each UOW.

TIME(cvda)

Returns a CVDA value identifying whether the performance class time-stamp fields returned to an application using the COLLECT STATISTICS MONITOR command are expressed in local or Greenwich mean time. The value of this option has no effect on the other classes of monitoring data. See SMF header and SMF product section for information on the SMF header. CVDA values are as follows:

GMT: Time stamps are Greenwich mean time.
LOCAL: Time stamps are local time.

TSQUEUELIMIT(data-area)

Returns the maximum number of temporary storage queues for which CICS is to perform transaction resource monitoring.

Conditions

NOTAUTH

RESP2 values:

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