The DISPMTR command displays and allows you to manage monitors that you have defined using the
customization dialogs for your system.
Syntax
Parameters
monitor
The name of the monitor resource. More than one name can be specified.
Wildcard is supported, for example, SAP*.
resource
The resource name that the associated monitor, or monitors, should
be displayed for. If more than one name is specified, they must be
enclosed in parentheses. Wildcard is supported.
REQ=DETAIL
Displays detailed information for the specified monitor.
Note: Specification of the
full monitor resource name is necessary if it is a remote monitor. Also, when using this option only
one monitor can be specified.
Specifies whether or not to wait until the request is complete.
The default is YES.
nnn is the number of seconds to wait
before giving up and reporting that a timeout has occurred. The maximum
time interval is 999 seconds.
Restrictions and Limitations
The DISPMTR
command can only be used when SA z/OS® is initialized.
Examples
If you enter dispmtr a
panel similar to that shown in Figure 1 is
displayed. Figure 1. DISPMTR
Initial Command Dialog Panel
INGKYMN0 SA z/OS - Command Dialogs Line 1 of 2
Domain ID = IPUN8 ---------- DISPMTR ---------- Date = 01/02/03
Operator ID = NETOP1 System = AOC8 Time = 13:15:00
Cmd: A Reset B Start C Stop D Details E INGVOTE F INGINFO I INGSCHED
CMD Monitor System Status Health Last monitored
--- ------------ -------- ------------ ------------ -------------------
_ JES2MON AOCA ACTIVE UNKNOWN 2009-12-01 17:28:16
_ PMTRA AOCA ACTIVE NORMAL 2009-12-02 15:03:39
_ PMTRB1 AOCA ACTIVE NORMAL 2009-12-02 15:03:40
_ PMTRB2 AOCA ACTIVE NORMAL 2009-12-01 17:28:17
_ PMTRB3 AOCA ACTIVE NORMAL 2009-12-01 17:28:16
Command ===>
PF1=Help PF2=End PF3=Return PF6=Roll
PF8=Forward PF9=Refresh PF11=Next PF12=Retrieve
The amount of data depends on
the screen size. Press PF10/11 to scroll horizontally.
The Cmd field lets you specify command codes. To use one of the command codes shown, type
the appropriate letter next to the resource name and press Enter. The following command codes are
available:
A
Resets the health status to NORMAL, if the monitor status is ACTIVE.
Resets the health
status to INACTIVE, if the monitor status is BROKEN.
B
Starts the monitor resource (makes it available).
C
Stops the monitor resource (makes it unavailable).
D
Shows the monitor details and history data.
E
Invokes INGVOTE for the monitor resource to show votes and requests against the monitor.
F
Invokes INGINFO for the monitor resource to show details about the monitor.
I
Invokes INGSCHED for the monitor resource to show details about the overrides that exist for the
monitor.
The Monitor column shows the name of the monitor.
The System column shows the name of the system where the
monitor runs.
The Status column shows the status of the monitor. It can have one of the following
values:
STARTING
The monitor is about to become active. An activate command might be in progress.
ACTIVE
The monitor is active.
STOPPING
The monitor is about to become inactive. A deactivate command might be in progress.
INACTIVE
The monitor is inactive.
FAILED
The monitor failed. Recovery might be in progress. No acceptable health status is provided.
BROKEN
The monitor and its recovery failed. This is a permanent condition. The monitor is no longer
invoked. Use command code 'A' to reset the monitor to INACTIVE.
The Health column shows the status of the monitor. This implies that the monitor is
active. It can have one of the following values:
UNKNOWN
The health status has not been determined yet.
NORMAL
The health is OK.
WARNING
The health is degraded.
MINOR
Similar to WARNING but more severe.
CRITICAL
Similar to MINOR but more severe.
FATAL
Similar to CRITICAL but more severe.
The Last monitored column shows when the resource was last
monitored.
The Status message column shows message that is associated
with the status. If the message has been truncated it ends with ...,
use command code D to view full details about the message.
The Description column shows descriptive information about
the monitor resource.
The Monitored Object column shows the name of
the real object that is being monitored by this monitor.
The Jobname column shows the name of the job
this Monitor resource accepts events from.
If you enter command code D for a resource, a
panel similar to Figure 2 is
displayed. Figure 2. DISPMTR Command Dialog Panel Showing Details for a Monitor
INGKYMO1 SA z/OS - Command Dialogs Line 1 of 107
Domain ID = IPSFP ---------- DISPMTR ---------- Date = 11/23/09
Operator ID = NETOP1 System = AOC8 Time = 13:15:15
Monitor : CICS1CON1/MTR/AOC8
Target : AOC8
Description : CICS Connection Monitor for CICS1TOR
Monitored Object : BICM.CICSAO84.CONNECT.AO83
Inform List : SDF SMF USR TTT EIF IOM
Commands...
Activate :
Deactivate :
Monitoring :
Interval :
Last termination : 17:50:26 on 11/22/09
Last start : 00:01:09 on 11/23/09
Command ===>
PF1=Help PF2=End PF3=Return PF6=Roll
PF8=Forward PF9=Refresh PF12=Retrieve
