Programming Interface Information: The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM.

#### MRPRCAPC

Prolog
Control 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