INQUIRE MONITOR

Retrieve the status of CICS monitoring.

Read syntax diagramSkip visual syntax diagramINQUIRE MONITOR
 
>>-INQUIRE MONITOR---------------------------------------------->
 
   .---------------------------------------------.
   V                                             |
>----+-----------------------------------------+-+-------------><
     +-APPLNAMEST(cvda)------------------------+
     +-CONVERSEST(cvda)------------------------+
     +-EXCEPTCLASS(cvda)-----------------------+
     +-FILELIMIT(data-area)--------------------+
     +-+-FREQUENCY(data-area)----------------+-+
     | '-| hours |--| minutes |--| seconds |-' |
     +-PERFCLASS(cvda)-------------------------+
     +-RESRCECLASS(cvda)-----------------------+
     +-RMIST(cvda)-----------------------------+
     +-STATUS(cvda)----------------------------+
     +-SUBSYSTEMID(data-area)------------------+
     +-SYNCPOINTST(cvda)-----------------------+
     +-TIME(cvda)------------------------------+
     '-TSQUEUELIMIT(data-area)-----------------'
 
hours:
 
|--FREQUENCYHRS(data-area)--------------------------------------|
 
minutes:
 
|--FREQUENCYMINS(data-area)-------------------------------------|
 
seconds:
 
|--FREQUENCYSECS(data-area)-------------------------------------|
 

Conditions: NOTAUTH

For more information about the use of CVDAs, see CICS-value data areas (CVDAs).

Description

The INQUIRE MONITOR command allows you to find out whether CICS monitoring is active, what types of data are being recorded, and other recording options.

CICS monitoring is controlled by a master switch (the STATUS option) and two switches that govern what types of data are recorded (the EXCEPTCLASS and PERFCLASS options). See the SET MONITOR command on page SET MONITOR for a description of monitor data classes and details of how the switches interact.

Options

APPLNAMEST(cvda)
returns a CVDA value indicating whether CICS application naming support is enabled. CVDA values are:
APPLNAME
CICS application naming support is enabled.
NOAPPLNAME
CICS application naming support is not enabled.
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:
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.
EXCEPTCLASS(cvda)
returns a CVDA value indicating whether the exception class of monitoring data is recorded when monitoring is active. CVDA values are:
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.

There are two formats for the frequency interval:

  • 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 means 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).
PERFCLASS(cvda)
returns a CVDA value indicating whether the performance class of monitoring data is recorded when monitoring is active. CVDA values are:
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:
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:
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:
OFF
CICS monitoring is not active in the region. No monitoring data is accumulated or written out, irrespective of the settings of the monitoring data classes.
ON
CICS monitoring is active. Data is accumulated for all classes of monitor data, and written out for those classes that are active.
SUBSYSTEMID(data-area)
returns the 4-character nameused as the subsystem identification in the MVS workload activity reports. For information on the MVS workload activity reports and the subsystem identification, see the CICS® Performance Guide. For information on how to specify the subsystem identification, see the MNSUBSYS parameter in the CICS System Definition Guide.
SYNCPOINTST(cvda)
returns a CVDA value indicating whether CICS records performance class data separately for each unit of work (UOW) within tasks that contain multiple UOWs. A UOW within a task ends when a syncpoint 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 syncpoint, the UOW does not end. CVDA values are:
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 the CICS Customization Guide for information on the SMF header. CVDA values are:
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.
[[ Contents Previous Page | Next Page Index ]]