|
Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
MONEQ
Control Block Contents
MONEQ DSECT
Cross Reference (Contains links to field and bit definitions)
MONEQ Prolog
NAME : HCPMONEQ
DESCRIPTION: Monitor Equate Symbols
DSECT : MONEQ
FUNCTION : Provide standardized equate symbols for
domain and record numbers for monitor records.
These equates should also be used to code the
Monitor call instruction (MC) for event processing
LOCATED BY : None
CREATED BY : None : This file contains only constants
and definitions to be used elsewhere
therefore, it takes up no space
and requires no storage.
DELETED BY : NONE
Notes :
Each domain is represented by a constant. The name
of the constant for each domain is derived as follows:
MONxxxCL
Where
MON - Three character control block id
xxx - Three character domain id, where xxx is
determined as follows:
Domain 3 char id
SYSTEM SYT
MONITOR MTR
SCHEDULER SCL
STORAGE STO
USER USE
PROCESSOR PRC
I/O IOD
SEEK SEK
APPLMON APL
CL - Two character id indicating that this is a
monitor class (used in coding the Monitor
Call (MC) instruction.
Each monitor record within a domain is represented by
a constant. This constant defines the record number for
the record. The name of the constant is derived as follows:
MONyzzzC
Where
MON - Three character control block id
y - One character domain id, where y is
determined as follows:
Domain 1 char id
SYSTEM Y
MONITOR M
SCHEDULER C
STORAGE T
USER U
PROCESSOR P
I/O O
SEEK K
APPLDATA A
zzz - Three character record identifier. These
three characters should be the same as the
last three characters of the Monitor record
that this constant represents.
C - One character id indicating that this is a
monitor code (used in coding the Monitor
Call (MC) instruction.
NOTE: The seek domain has violated this convention because
there are three different interfaces to generate the
same monitor record. This is and should remain as the
only violation to this convention.
Example of coding a monitor call:
MC MONyzzzC,MONxxxCL
i.e.
MC code,class
MC record,domain
MONEQ Control Block Content
MONEQ DSECT
Hex Dec Type/Val Lng Label (dup) Comments
---- ---- --------- ---- -------------- --------
0000 0 Structure MONEQ Monitor Equate Symbols
Monitor Domain and record number definitions.
Class 0 Monitor Call System Domain Records
.... .... MONSYTCL X'00' Domain number for SYSTEM
events
.... ...1 MONYSYPC X'001' Sample Record - System
data per processor
.... ..1. MONYPRPC X'002' Sample Record - Processor
data per processor
.... ..11 MONYRSGC X'003' Sample Record - Real
storage data, global
.... .1.. MONYRSPC X'004' Sample Record - Real
storage data, per processor
.... .1.1 MONYXSPC X'005' Sample Record - Expanded
storage data, per processor
.... .11. MONYASGC X'006' Sample Record - Auxiliary
storage data, global
.... .111 MONYSHSC X'007' Sample Record - Shared
storage data
.... 1... MONYUSRC X'008' Sample Record - User data
.... 1..1 MONYCPCC X'009' Sample Record - Channel
path contention
.... 1.1. MONYSCGC X'00A' Sample Record - Scheduler
activity
.... 1.11 MONYCOMC X'00B' Sample Record -
Communications Activity
.... 11.. MONYUWTC X'00C' Sample Record - User wait
states
.... 11.1 MONYSCPC X'00D' Sample Record - Scheduler
Activity data, per processor
.... 111. MONYXSGC X'00E' Sample Record - Expanded
Storage data (global)
.... 1111 MONYCUGC X'00F' Sample Record - PR/SM
Logical CPU Utilization (global)
...1 .... MONYCUPC X'010' Sample Record - CPU
Utilization Dta in a Logical
Partition
...1 ...1 MONYCUMC X'011' Sample Record - Physical
CPU Utilization for LPAR
Management
...1 ..1. MONYCPMC X'012' Sample Record - Channel
path measurement data
...1 ..11 MONYSYGC X'013' Sample Record - System
data (global)
...1 .1.. MONYEPMC X'014' Sample Record - Extended
Channel measurement data
Class 1 Monitor Call Monitor Domain Records
.... ...1 MONMTRCL X'01' Domain number for Monitor
events
.... ...1 MONMEPRC X'001' Event Record - event
profile data
.... ..1. MONMECMC X'002' Event Record - event
alteration command
.... ..11 MONMSUSC X'003' Event Record - suspension
record
.... .1.. MONMSYSC X'004' Sample Record - System
configuration data
.... .1.1 MONMPRPC X'005' Sample Record - Processor
configuration data
.... .11. MONMDEVC X'006' Sample Record - Device
configuration data
.... .111 MONMMEMC X'007' Sample Record - Memory
configuration data
.... 1... MONMPAGC X'008' Sample Record - Paging
configuration data
.... 1..1 MONMSPRC X'009' Sample Record - Sample
profile data
.... 1.1. MONMSCMC X'00A' Sample Record - Sample
alteration command
.... 1.11 MONMENDC X'00B' Sample Record - Interval
end
.... 11.. MONMSOSC X'00C' Event Record - Start of
event suspend
.... 11.1 MONMEOFC X'00D' Event and Sample Record -
End of Frame
.... 111. MONMDDRC X'00E' Event and Sample Record -
Domain Detail
.... 1111 MONMUSRC X'00F' Sample Record - Logged on
Users
...1 .... MONMSCHC X'010' Sample Record - Scheduler
Settings
...1 ...1 MONMXSGC X'011' SAMPLE RECORD - EXPANDED
STORAGE data
Class 2 Monitor Call Scheduler Domain Records
.... ..1. MONSCLCL X'02' Domain number for Scheduler
events
.... ...1 MONCRDBC X'001' Event Record - Begin read
.... ..1. MONCRDCC X'002' Event Record - Read
complete
.... ..11 MONCWRRC X'003' Event Record - Write
response
.... .1.. MONCADLC X'004' Event Record - Add user to
dispatch list dispatch list
.... .1.1 MONCDDLC X'005' Event Record - Drop user
from dispatch list
.... .11. MONCAELC X'006' Event Record - Add user to
eligible list
.... .111 MONCSRMC X'007' Event Record - SET SRM
changes
.... 1... MONCSTPC X'008' Event Record - System
timer pop
.... 1..1 MONCSHRC X'009' Event Record - SET SHARE
changes
.... 1.1. MONCSQDC X'00A' Event Record - SET
QUICKDISP changes
Class 3 Monitor Call Storage Domain Records
.... ..11 MONSTOCL X'03' Domain number for Storage
Events
.... ...1 MONTRSGC X'001' Sample Record - Real
storage management, global data
.... ..1. MONTRSPC X'002' Sample Record - Real
storage activity, per processor
.... ..11 MONTSHRC X'003' Sample Record - Shared
storage management
.... .1.. MONTASPC X'004' Sample Record - Auxiliary
storage management
.... .1.1 MONTSHSC X'005' Event Record - NSS/DCSS
saved
.... .11. MONTSHPC X'006' Event Record - NSS/DCSS
successfully purged
.... .111 MONTATCC X'007' Event Record - Attach CP
volume
.... 1... MONTBPGC X'008' Sample Record - Block
Paging data
.... 1..1 MONTXSGC X'009' Sample Record - Expanded
storage data (global)
.... 1.1. MONTXSUC X'00A' SAMPLE RECORD - EXPANDED
STORAGE data (per user)
.... 1.11 MONTASSC X'00B' Sample Record - Auxiliary
storage/Shared Device Management
.... 11.. MONTASCC X'00C' Event Record - Address
space created
.... 11.1 MONTASDC X'00D' Event Record - Address
space deleted
.... 111. MONTASIC X'00E' Sample Record - Address
space information
.... 1111 MONTSHLC X'00F' Event Record - A saved
System/Segment has been loaded
into storage (ie. accessed by the
1st user).
...1 .... MONTSHDC X'010' Event Record - A saved
System/Segment has been deleted
from storage (ie. released by the
last user).
...1 ...1 MONTVDKC X'011' Sample Record - Vdisk
information
Class 4 Monitor Call User Domain Records
.... .1.. MONUSECL X'04' Domain number for User
events
.... ...1 MONULONC X'001' Event Record - User log on
.... ..1. MONULOFC X'002' Event Record - User log
off
.... ..11 MONUACTC X'003' Sample Record - User
activity
.... .1.. MONUINTC X'004' Sample Record - User
interaction
.... .1.1 MONUDFCC X'005' Event Record - DEFINE CPU
.... .11. MONUDTCC X'006' Event Record - DETACH CPU
.... .111 MONURDCC X'007' Event Record - DEFINE CPU
n AS m
.... 1... MONUTREC X'008' Event Record - Transaction
End
.... 1..1 MONUATEC X'009' Event Record - Actitity at
transaction end
.... 1.1. MONUITEC X'00A' Event Record - Interaction
at transaction end
Class 5 Monitor Call Processor Domain Records
.... .1.1 MONPRCCL X'05' Domain number for Processor
events
.... ...1 MONPVONC X'001' Event Record - Vary on
processor
.... ..1. MONPVOFC X'002' Event Record - Vary off
processor
.... ..11 MONPPRPC X'003' Sample Record - Processor
activity, per processor
.... .1.. MONPVFNC X'004' Event Record - Vary on
vector facility
.... .1.1 MONPVFFC X'005' Event Record - Vary off
vector facility
.... .11. MONPCFNC X'006' Event Record - Vary on
crypto facility
.... .111 MONPCFFC X'007' Event Record - Vary off
crypto facility
Class 6 Monitor Call I/O Domain Records
.... .11. MONIODCL X'06' Domain number for IO domain
events
.... ...1 MONOVONC X'001' Event Record - Vary on
device
.... ..1. MONOVOFC X'002' Event Record - Vary off
device
.... ..11 MONODEVC X'003' Sample Record - Device
activity data
.... .1.. MONOCADC X'004' Sample Record - Cache
activity data
.... .1.1 MONOATDC X'005' Event Record - Attach
device
.... .11. MONODTDC X'006' Event Record - Detach
device
.... .111 MONOENBC X'007' Event Record - Enable
terminal
.... 1... MONODSBC X'008' Event Record - Disable
terminal
.... 1..1 MONOATSC X'009' Event Record - Attach
shared device
.... 1.1. MONOALSC X'00A' Event Record - Automated
library statistics
.... 1.11 MONOSONC X'00B' Event Record - Vary on
Subchannel
.... 11.. MONOSOFC X'00C' Event Record - Vary off
Subchannel
.... 11.1 MONOMONC X'00D' Event Record - Set Chanmon
on
.... 111. MONOMOFC X'00E' Event Record - Set Chanmon
off
.... 1111 MONODDVC X'00F' Event Record - Device
Deleted
...1 .... MONOMDVC X'010' Event Record - Device
Modified
...1 ...1 MONODCHC X'011' Event Record - CHPID
deleted
...1 ..1. MONOTONC X'012' Event Record - Throttle
rate set
...1 ..11 MONOTOFC X'013' Event Record - Throttle
turned off
...1 .1.. MONOSTCC X'014' Event Record - State
Change
Class 7 Monitor Call Seek Domain Records
.... .111 MONSEKCL X'07' Domain number for Seek
events
.... ...1 MONKSEKC X'001' Event Record - Seek event
Class 10 Monitor Call Appldata Domain records
.... 1.1. MONAPLCL X'00A' Domain number of Appldata
.... ...1 MONAEDTC X'001' Event record - appldata:
created only on diag DC stop,
virtual machine reset or purge
nss
.... ..1. MONASDTC X'002' Sample record - appldata:
interval application buffer data
record
The following two constants define the minimum and maximum values
allowed for a domain number (monitor class) used in a Monitor Call (MC)
instruction.
These are used by HCPMNEVN to declare an array of addresses of
subroutines that process the records.
.... .... MONMINDM X'00' Minimum domain number
.... 1111 MONMAXDM X'0F' Maximum domain number
The following two constants provide dummy domain and record numbers.
They must not be used in a MC instruction.
1111 1111 MONDUMCL X'FF' Dummy domain number
0000FFFF MONDDUMC X'FFFF' Dummy record number
MONEQ Storage Layout
*** MONEQ - Monitor Equate Symbols
*
*
*** MONEQ - Monitor Equate Symbols
MONEQ Cross Reference
Symbol Dspl Value -------------- ---- ----- MONAEDTC 0000 01 MONAPLCL 0000 0A MONASDTC 0000 02 MONCADLC 0000 04 MONCAELC 0000 06 MONCDDLC 0000 05 MONCRDBC 0000 01 MONCRDCC 0000 02 MONCSHRC 0000 09 MONCSQDC 0000 0A MONCSRMC 0000 07 MONCSTPC 0000 08 MONCWRRC 0000 03 MONDDUMC 0000 0000FFFF MONDUMCL 0000 FF MONIODCL 0000 06 MONKSEKC 0000 01 MONMAXDM 0000 0F MONMDDRC 0000 0E MONMDEVC 0000 06 MONMECMC 0000 02 MONMENDC 0000 0B MONMEOFC 0000 0D MONMEPRC 0000 01 MONMINDM 0000 00 MONMMEMC 0000 07 MONMPAGC 0000 08 MONMPRPC 0000 05 MONMSCHC 0000 10 MONMSCMC 0000 0A MONMSOSC 0000 0C MONMSPRC 0000 09 MONMSUSC 0000 03 MONMSYSC 0000 04 MONMTRCL 0000 01 MONMUSRC 0000 0F MONMXSGC 0000 11 MONOALSC 0000 0A MONOATDC 0000 05 MONOATSC 0000 09 MONOCADC 0000 04 MONODCHC 0000 11 MONODDVC 0000 0F MONODEVC 0000 03 MONODSBC 0000 08 MONODTDC 0000 06 MONOENBC 0000 07 MONOMDVC 0000 10 MONOMOFC 0000 0E MONOMONC 0000 0D MONOSOFC 0000 0C MONOSONC 0000 0B MONOSTCC 0000 14 MONOTOFC 0000 13 MONOTONC 0000 12 MONOVOFC 0000 02 MONOVONC 0000 01 MONPCFFC 0000 07 MONPCFNC 0000 06 MONPPRPC 0000 03 MONPRCCL 0000 05 MONPVFFC 0000 05 MONPVFNC 0000 04 MONPVOFC 0000 02 MONPVONC 0000 01 MONSCLCL 0000 02 MONSEKCL 0000 07 MONSTOCL 0000 03 MONSYTCL 0000 00 MONTASCC 0000 0C MONTASDC 0000 0D MONTASIC 0000 0E MONTASPC 0000 04 MONTASSC 0000 0B MONTATCC 0000 07 MONTBPGC 0000 08 MONTRSGC 0000 01 MONTRSPC 0000 02 MONTSHDC 0000 10 MONTSHLC 0000 0F MONTSHPC 0000 06 MONTSHRC 0000 03 MONTSHSC 0000 05 MONTVDKC 0000 11 MONTXSGC 0000 09 MONTXSUC 0000 0A MONUACTC 0000 03 MONUATEC 0000 09 MONUDFCC 0000 05 MONUDTCC 0000 06 MONUINTC 0000 04 MONUITEC 0000 0A MONULOFC 0000 02 MONULONC 0000 01 MONURDCC 0000 07 MONUSECL 0000 04 MONUTREC 0000 08 MONYASGC 0000 06 MONYCOMC 0000 0B MONYCPCC 0000 09 MONYCPMC 0000 12 MONYCUGC 0000 0F MONYCUMC 0000 11 MONYCUPC 0000 10 MONYEPMC 0000 14 MONYPRPC 0000 02 MONYRSGC 0000 03 MONYRSPC 0000 04 MONYSCGC 0000 0A MONYSCPC 0000 0D MONYSHSC 0000 07 MONYSYGC 0000 13 MONYSYPC 0000 01 MONYUSRC 0000 08 MONYUWTC 0000 0C MONYXSGC 0000 0E MONYXSPC 0000 05
Copyright IBM Corporation, 1990, 2001