Making a monitor service request
Type SM or MONSERV on the COMMAND line of any view and press Enter.The Start Monitors (SM or MONSERV) view is displayed, as shown in Start Monitors view (SM or MONSERV). The Start Monitors view lists all available monitors.
To learn about a monitor service, in the CMD field next to the service, type H and press Enter. A description of the service, its parameters, and the syntax of its warning message are displayed. For a brief description of the monitors, see IMS-workload-monitors and IMS-resource-monitors.
To learn about a field on the Start Monitors view, position the cursor on the field and press the Help key.
Monitor Services
Commands: BLK (Requests) JOURNAL (Log Display)
Line CMDs: S (Select), L (Lock), U (unlock), H(Help)
CMD Service Num Title Parm Type Area Status
--- ------- Actv -------------------------- -------------- ----- ------
$CBMP TOTAL BMP CALLS (IDENTIFIER) IWGBL
$CDBT TOTAL DBT (CICS) CALLS (IDENTIFIER) IWGBL
$CMPP TOTAL MPP CALLS (IDENTIFIER) IWGBL
$CTOT TOTAL PROGRAM CALLS (IDENTIFIER) IWGBL
#CDB2 DB2 DATABASE CALLS (IDENTIFIER) IWDB2
#CIC CI CONTENTIONS (IDENTIFIER) IWFP
#OBAW OVERFLOW BUFFER WAITS (IDENTIFIER) IWFP
#PROC TRANS PROCESSED (IDENTIFIER) IWTRN
#SDB2 DB2 SPECIAL CALLS (IDENTIFIER) IWDB2
@CRSP AVG IMS CONNECT RESPONSE (IDENTIFIER) IWTRN
@ELAP 1 AVG ELAPSED TIME (IDENTIFIER) IWTRN
@INPQ AVG INPUT Q TIME (IDENTIFIER) IWTRN
F1=HELP F2=SPLIT F3=END F4=RETURN F5=RFIND F6=RCHANGE
F7=UP F8=DOWN F9=SWAP F10=LEFT F11=RIGHT F12=RETRIEVEIn the CMD field next to the service that you want to start, type S and press Enter.The Start Workload Monitor dialog box is displayed. For more information, see Start Workload Monitor dialog box.
Depending on the type of monitor service selected (see Types-of-monitor-services), the Specify Workload Selections section might not be displayed and the exact workload selection fields listed varies.
.-------------------------- Start Workload Monitor ---------------------------.
| COMMAND ===> SCROLL ===> CSR |
| |
| @ELAP - AVG ELAPSED TIME |
| Monitor Attributes: |
| PARM (Identifier) START (hh:mm:ss) |
| INTERVAL 00:01:00 (hh:mm:ss) STOP (hh:mm:ss/mins) |
| WVAL (Warning value) WIF 1 (Intvls to 1st msg) |
| WMSG (Log warnings to) WIN 1 (Message Intervals) |
| WLIM 10 (Warnings limit) RST HOT (HOT,PUR,QIS) |
| QIS YES (YES/NO) |
| TITLE AVERAGE ELAPSED TIME |
| PLOTMAX (Maximum PLOT X-Axis value) |
| RANGES (1-4 Range Distr. Upper Limits) |
| LOG (NO,ATSTOP,ATPD,ATINTVL,ATWARN) |
| |
| Specify Workload Inclusion Selections: |
| PGMTYPE (MPP, BMP, MDP, NDP, FPU, TPI, DBT, NOTDBT) |
| TRANTYPE (DLI, DB2, FP) |
| TRAN |
| PROG |
| PSB |
| CLASS |
| REGION |
| RGNID |
| USERID |
| TMEM (OTMA member or IMS Connect name) |
| TERM (name, TPIPE, APPC, SYNCLOCK, MSCCLOCK, |
| IMSCON, MQS) |
| Specify Workload Exclusion Selections: |
| XTRAN |
| XPROG |
| XPSB |
| XCLASS |
| XREGION |
| XUSERID |
| XTERM (name, TPIPE, APPC, SYNCLOCK, MSCCLOCK, |
| IMSCON, MQS) |
| |
| |
| ENTER to process the request |
| END to cancel the request |
| HELP to display related help |
'-----------------------------------------------------------------------------'Specify the monitor service criteria:
Field
Description
Default
PARM
Unique name for the request
Blanks
START
When to start the monitor service
Next full minute
INTERVAL
Time interval between successive service invocations
Not applicable
STOP
When to stop the monitor service
24 hours
WVAL
Warning threshold for the monitor request
0, no warnings
WIF
Number of intervals before the first warning message
1
WMSG
Where the warning messages are to be sent
LOG
WIN
Number of intervals between warning messages
1
WLIM
Maximum number of warning messages
10
RST
Restart option to be used when a service is quiesced because of an inactive target region
HOT
QIS
Action to be taken when an IMS target is not active
YES
TITLE
Display title for the monitor service (see Monitor-request-title)
Name of the service
PLOTMAX
Maximum value to be shown on the X-axis boundary for a PLOT of this monitor request
Not applicable
RANGES
One to four upper-range limit values for the PLOT range distribution
No range
LOG
Logging option specification for the monitor service
No logging
Specify Workload Selections
Criteria used to limit or filter monitor data collection to a specific part of the IMS workload
For specific fields that are listed, see the online Help.
Not applicable
For additional information about a field, press F1 for online Help.
Specify workload inclusion and exclusion criteria:
Keyword
Exclusion keyword
Description
PGMTYPE
NA
Qualifies a monitor request by program type
The default is all types. You can specify multiple types:
- MPP—message processing program
- BMP—batch message processing program
- MDP—Fast Path message-driven processing
- NDP—Fast Path non-message-driven processing
- FPU—Fast Path utility program
- TPI—CPI-C driven program
- DBT—DBCTL thread program
- NOTDBT—selects programs that do no use a DBCTL thread
TRANTYPE
NA
Qualifies a monitor request by transaction type
The default is all types. You can specify multiple types:
- Db2—transactions that access Db2
- DLI—transactions that make DL/I database calls
- FP—transactions that make Fast Path database calls
TRAN
XTRAN
Qualifies a monitor request by including (TRAN) or excluding (XTRAN) specified IMS or CICS transaction
Valid entries are 1- to 8-character alphanumeric transaction codes. Multiple transaction codes can be specified with a positional qualifier. For CICS DBCTL transactions, use the CICS transaction code. For Fast Path transactions, use the routing code assigned by the DBFHAGUO exit routine.
PROG
XPROG
Qualifies a monitor request by including (PROG) or excluding (XPROG) specified programs
Valid entries are 1- to 8-character alphanumeric program names. You can specify multiple program names with a positional qualifier.
PSB
XPSB
Qualifies a monitor request by including (PSB) or excluding (XPSB) specified IMS program specification blocks
Valid entries are 1- to 8-character alphanumeric PSB names. You can specify multiple PSB names with a positional qualifier.
CLASS
XCLASS
Qualifies a monitor request by including (CLASS) or excluding (XCLASS) numeric scheduling classes
Multiple classes can be specified as CLASS 1 2 3. The default includes all IMS scheduling classes.
REGION
XREGION
Qualifies a monitor request by including (REGION) or excluding (XREGION) specified IMS region job names
Valid entries are 1- to 8-character alphanumeric region job names. You can specify multiple region job names with a positional qualifier.
RGNID
NA
Qualifies a monitor request by specified region ID Enter a 1- to 3-character numeric region ID from 1 to nnn, where nnn is a valid region number. You can specify multiple region IDs with a positional qualifier.
USERID
XUSERID
Qualifies a monitor request by including (USERID) or excluding (XUSERID) specified IMS sign-on user IDs
Valid entries are 1- to 8-character alphanumeric IMS sign-on user IDs. You can specify multiple user IDs with a positional qualifier.
TMEM
NA
Qualifies a trace request by OTMA member name or that IMS Connect job or started task name
If monitoring by IMS Connect name, the BMC AMI Energizer for IMS Connect product must be installed.
TERM
XTERM
The names of LTERMs or Tpipes to be included (TERM) or excluded (XTERM) from monitoring
Valid entries are 1- to 8-character alphanumeric names, which can include plus qualifies. Multiple names can be specified. For DBCTL transactions, this is the 4- character CICS terminal ID.
- Press Enter.
The service monitor request is started.