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
              .... 1.11      MONCIOPC       X'00B' Event Record - I/O
                                            Priority 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
              .... 1...      MONPIOPC       X'008' Sample Record - I/O
                                            Processor Utilization Data
         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
    MONCIOPC       0000 0B
    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
    MONPIOPC       0000 08
    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 V4R3.0. Last updated on 30 Apr 2002 at 16:58:05 EDT.
Copyright IBM Corporation, 1990, 2002