Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM.

MONEQ

Prolog  

Control Block Contents  
   MONEQ DSECT

Storage Layout  

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

This information is based on z/VM V4R2.0. Last updated on 30 Oct 2001 at 15:39:32 EDT.
Copyright IBM Corporation, 1990, 2001