|
Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRPRCAPC
PrologControl Block Contents
Cross Reference
MRPRCAPC Prolog
DSECT NAME - PRCAPC
FUNCTION - Map a Monitor record.
LOCATED BY -
Through the Monitor Control Area
REFERENCED CONTROL BLOCKS -
MRRECHDR Monitor Record Header
NAME - MRPRCAPC
DESCRIPTIVE NAME - Monitor Sample Record
Domain 5 - Processor Domain
Record 9 - Crypto performance counters
DESCRIPTION - Provides counters and timers for transactions on the
PCI crypto cards. One record is generated to include
all of the information for the processor
configuration.
NOTES:
- This record is generated only if PCI crypto cards are installed
on the system.
- NQ refers to the process of a guest transferring a complete
request to the host or of the host transferring a complete
request to the hardware.
- DQ refers to the process of a guest retrieving a complete
reply from the host or of the host retrieving a complete
reply from the hardware.
MRPRCAPC Control Block Contents
Offsets Dec Hex Type Len Name (Dim) Description 0 0 Structure 360 PRCAPC Start of monitor record 0 0 Character 0 PRCAPC_MRHDR Record header. See MRRECHDR for details. 0 0 Character 20 MRHDR 0 0 Unsigned 2 MRHDRLEN 2 2 Unsigned 2 MRHDRZER 4 4 Unsigned 1 MRHDRDM 5 5 Unsigned 1 * 6 6 Unsigned 2 MRHDRRC 8 8 Character 8 MRHDRTOD 16 10 Character 4 * 20 14 Character 0 MRHDR_END 20 14 Character 4 * Reserved for IBM use 24 18 Character 8 PRCAPC_CRYVSERV Unsigned cumulative time in microseconds from the point the guest finishes NQing a request to the point where the guest begins DQing the associated reply. 32 20 Character 8 PRCAPC_CRYRSERV Unsigned cumulative time in microseconds from the point the host finishes NQing a request to the hardware to the point where the host finishes DQing the associated reply from the hardware. 40 28 Character 8 PRCAPC_CRYNOWNQ Cardinal count of requests waiting for the host to NQ them to hardware. 48 30 Character 8 PRCAPC_CRYNOVNQ Unsigned cumulative count of requests NQed successfully by all guests. 56 38 Character 8 PRCAPC_CRYNOXVN Unsigned cumulative count of guest NQ requests rejected by host. 64 40 Character 8 PRCAPC_CRYNOXRN Unsigned cumulative count of host NQ requests rejected by hardware. 72 48 Character 8 PRCAPC_CRYNOFNQ Unsigned cumulative count of requests host successfully NQed to hardware. 80 50 Character 8 PRCAPC_CRYNOFDQ Unsigned cumulative count of replies host successfully DQed from hardware. 88 58 Character 8 PRCAPC_CRYNOVPR Unsigned cumulative count of guest attempts (successful or or otherwise) to DQ replies. 96 60 Character 8 PRCAPC_CRYNOVPC Unsigned cumulative count of replies successfully DQed by guests. 104 68 Character 8 PRCAPC_CRYNORPR Unsigned cumulative count of host attempts (successful or otherwise) to DQ replies from from hardware. 112 70 Character 8 PRCAPC_NQDELAY 64-bit unsigned integer value for NQ delay used the last time the NQ task chose to wait, expressed in TOD clock units. x'FF...FF' if not initialized. 0 if delay is to be reset to its initial value. 120 78 Character 8 PRCAPC_DQDELAY 64-bit unsigned integer value for DQ delay used the last time the DQ task chose to wait, expressed in TOD clock units. x'FF...FF' if not initialized. 0 if delay is to be reset to its initial value. 128 80 Unsigned 8 PRCAPC_CRYNSERV Unsigned cumulative time in microseconds from the point the guest finishes NQing a request to the host to the point where the host finishes NQing the request to hardware. 136 88 Unsigned 8 PRCAPC_CRYHSERV Unsigned cumulative time in microseconds from the point the guest finishes NQing a request to the host to the point where the host finishes DQing the reply from hardware. 144 90 Unsigned 8 PRCAPC_CRYDSERV Unsigned cumulative time in microseconds from the point the host finishes DQing the reply from hardware to the point where the guest begins DQing the reply from the host. 152 98 Character 4 PRCAPC_CRYVAPQN Cardinal count of resources assigned to the shared pool. 156 9C Character 4 PRCAPC_CRYAVSEQ Unsigned integer. APVIRT pool instantiation sequence number. 160 A0 Character 4 PRCAPC_CRYVFACS Bitmask of APVIRT pool resource capabilities: x40000000 - ME 4K keys supported x20000000 - CRT 4K keys supported x10000000 - CCA mode x08000000 - Accelerator mode 164 A4 Character 1 PRCAPC_CRYVAPTY Unsigned integer. APVIRT pool resource type. The CEX adapter type is CRYVAPTY-6 unless CRYVAPTY=0, in which case no resources are assigned to the shared pool. 165 A5 Character 2 PRCAPC_QSIZE Unsigned integer. Queue size per shared pool resource. For percentage utilization of the shared pool at the moment the monitor sample was collected, compute: (PRCAPC_CRYNOWDQ * 100) / (PRCAPC_CRYVAPQN * PRCAPC_QSIZE) 167 A7 Character 1 * Reserved. 168 A8 Character 8 PRCAPC_CRYNOWDQ Cardinal count of requests for which the host has not yet DQed a reply from hardware. 176 B0 Character 8 PRCAPC_CRYNOAIS Unsigned cumulative count of adapter interruptions for shared pool resources. 184 B8 Character 8 PRCAPC_NQ_APTSTATE A bitmask depicting the task state 184 B8 Character 4 PRCAPC_NQ_APTSTATE_HI Current state, desired state, and mode of operation of the NQ task: x04000000 - Desired state RUN x02000000 - Desired state STOP x01000000 - Desired state TRIGGER (wait for a timer interruption) x00040000 - Current state RUN x00020000 - Current state STOP x00010000 - Current state TRIGGER (waiting for a timer interruption) x00008000 - Task is event-driven x00004000 - Task is disabled x00002000 - Task is waiting for resources. x00001000 - Task's TRQBK is in use. 188 BC Character 4 PRCAPC_DQ_APTSTATE_LO Unassigned state bytes, set to zero 192 C0 Character 8 PRCAPC_NQ_APTNYRUN Unsigned cumulative count of the number of times the NQ task was requested to run and succeeded in running. 200 C8 Character 8 PRCAPC_NQ_APTNYNRN Unsigned cumulative count of the number of times the NQ task was requested to run but was already running and required no APTSTATE change to process new work. 208 D0 Character 8 PRCAPC_NQ_APTNYCHG Unsigned cumulative count of the number of times the NQ task was requested to run but was already running and only required a state change to process new work. 216 D8 Character 8 PRCAPC_NQ_APTNYPRE Unsigned cumulative count of the number of times the NQ task was waiting for a timer interruption to run but a higher priority event preempted it. 224 E0 Character 8 PRCAPC_NQ_APTNSBYP Unsigned cumulative count of the number of times the NQ task was entered but another thread had preempted it. 232 E8 Character 8 PRCAPC_NQ_APTNSRUN Unsigned cumulative count of the number of times the NQ task was entered by a thread that successfully gained the initiative to run. 240 F0 Character 8 PRCAPC_NQ_APTTGTRG Unsigned cumulative count of the number of times the NQ task requested a timer interruption to cause it to be run again. 248 F8 Character 8 PRCAPC_NQ_APTNOPP Unsigned cumulative count of the number of productive passes through the NQ task's work queue where some requests were able to be processed. 256 100 Character 8 PRCAPC_NQ_APTNOPN Unsigned cumulative count of the number of non-productive passes through the NQ task's work queue, where there was no work to process. 264 108 Character 8 PRCAPC_NQ_APTNOPU Unsigned cumulative count of the number of unproductive or partially productive passes through the NQ task's work queue, where work had to be deferred. 272 110 Character 8 PRCAPC_DQ_APTSTATE A bitmask depicting the task state 272 110 Character 4 PRCAPC_DQ_APTSTATE_HI Current state, desired state, and mode of operation of the DQ task: x04000000 - Desired state RUN x02000000 - Desired state STOP x01000000 - Desired state TRIGGER (wait for a timer interruption) x00040000 - Current state RUN x00020000 - Current state STOP x00010000 - Current state TRIGGER (waiting for a timer interruption) x00008000 - Task is event-driven x00004000 - Task is disabled x00002000 - Task is waiting for resources. x00001000 - Task's TRQBK is in use. 276 114 Character 4 PRCAPC_DQ_APTSTATE_LO Unassigned state bytes, set to zero 280 118 Character 8 PRCAPC_DQ_APTNYRUN Unsigned cumulative count of the number of times the DQ task was requested to run and succeeded in running. 288 120 Character 8 PRCAPC_DQ_APTNYNRN Unsigned cumulative count of the number of times the DQ task was requested to run but was already running and required no APTSTATE change to process new work. 296 128 Character 8 PRCAPC_DQ_APTNYCHG Unsigned cumulative count of the number of times the DQ task was requested to run but was already running and only required a state change to process new work. 304 130 Character 8 PRCAPC_DQ_APTNYPRE Unsigned cumulative count of the number of times the DQ task was waiting for a timer interruption to run but a higher priority event preempted it. 312 138 Character 8 PRCAPC_DQ_APTNSBYP Unsigned cumulative count of the number of times the DQ task was entered but another thread had preempted it. 320 140 Character 8 PRCAPC_DQ_APTNSRUN Unsigned cumulative count of the number of times the DQ task was entered by a thread that successfully gained the initiative to run. 328 148 Character 8 PRCAPC_DQ_APTTGTRG Unsigned cumulative count of the number of times the DQ task requested a timer interruption to cause it to run again. 336 150 Character 8 PRCAPC_DQ_APTNOPP Unsigned cumulative count of the number of productive passes of shared pool resources by the DQ task where replies were able to be retrieved. 344 158 Character 8 PRCAPC_DQ_APTNOPN Unisgned cumulative count of the number of non-productive passes through shared pool resources by DQ task where no replies were available. 352 160 Character 8 PRCAPC_DQ_APTNOPU Unsigned cumulative count of the number of unproductive or partially productive passes by the DQ task where retrieval of some replies was deferred. 360 168 Character 0 PRCAPC_END End of record
MRPRCAPC Cross Reference
Hex Hex
Name Offset Length Value
MRHDR 0 20
MRHDR_END 14 0
MRHDRDM 4 1
MRHDRLEN 0 2
MRHDRRC 6 2
MRHDRTOD 8 8
MRHDRZER 2 2
PRCAPC 0 360
PRCAPC_CRYAVSEQ 9C 4
PRCAPC_CRYDSERV 90 8
PRCAPC_CRYHSERV 88 8
PRCAPC_CRYNOAIS B0 8
PRCAPC_CRYNOFDQ 50 8
PRCAPC_CRYNOFNQ 48 8
PRCAPC_CRYNORPR 68 8
PRCAPC_CRYNOVNQ 30 8
PRCAPC_CRYNOVPC 60 8
PRCAPC_CRYNOVPR 58 8
PRCAPC_CRYNOWDQ A8 8
PRCAPC_CRYNOWNQ 28 8
PRCAPC_CRYNOXRN 40 8
PRCAPC_CRYNOXVN 38 8
PRCAPC_CRYNSERV 80 8
PRCAPC_CRYRSERV 20 8
PRCAPC_CRYVAPQN 98 4
PRCAPC_CRYVAPTY A4 1
PRCAPC_CRYVFACS A0 4
PRCAPC_CRYVSERV 18 8
PRCAPC_DQ_APTNOPN 158 8
PRCAPC_DQ_APTNOPP 150 8
PRCAPC_DQ_APTNOPU 160 8
PRCAPC_DQ_APTNSBYP 138 8
PRCAPC_DQ_APTNSRUN 140 8
PRCAPC_DQ_APTNYCHG 128 8
PRCAPC_DQ_APTNYNRN 120 8
PRCAPC_DQ_APTNYPRE 130 8
PRCAPC_DQ_APTNYRUN 118 8
PRCAPC_DQ_APTSTATE 110 8
PRCAPC_DQ_APTSTATE_HI 110 4
PRCAPC_DQ_APTSTATE_LO BC 4
PRCAPC_DQ_APTSTATE_LO 114 4
PRCAPC_DQ_APTTGTRG 148 8
PRCAPC_DQDELAY 78 8
PRCAPC_END 168 0
PRCAPC_MRHDR 0 0
PRCAPC_NQ_APTNOPN 100 8
PRCAPC_NQ_APTNOPP F8 8
PRCAPC_NQ_APTNOPU 108 8
PRCAPC_NQ_APTNSBYP E0 8
PRCAPC_NQ_APTNSRUN E8 8
PRCAPC_NQ_APTNYCHG D0 8
PRCAPC_NQ_APTNYNRN C8 8
PRCAPC_NQ_APTNYPRE D8 8
PRCAPC_NQ_APTNYRUN C0 8
PRCAPC_NQ_APTSTATE B8 8
PRCAPC_NQ_APTSTATE_HI B8 4
PRCAPC_NQ_APTTGTRG F0 8
PRCAPC_NQDELAY 70 8
PRCAPC_QSIZE A5 2
This information is based on z/VM V7R2.0.
Last updated on 27 May 2022 at 10:15:52.
Copyright IBM Corporation, 1990, 2022