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.

    MRPRCAPC Control Block Contents

    Offsets
    Dec Hex  Type       Len  Name (Dim)             Description

      0   0  Structure  112  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               record length in bytes
      2   2  Unsigned     2  MRHDRZER               field of zeros
      4   4  Unsigned     1  MRHDRDM                domain identifier
      5   5  Unsigned     1  *
      6   6  Unsigned     2  MRHDRRC                record identifier
      8   8  Character    8  MRHDRTOD               Time at which this record was
                                                    built. In time-of-day (TOD)
                                                    clock format. See IBM System
                                                    370 XA Principle of Operation
                                                    for explanation of format.
     16  10  Character    4  *
     20  14  Character    0  MRHDR_END              End of header
     20  14  Character    4  *                      Reserved for IBM use
     24  18  Character    8  PRCAPC_CRYVSERV        Unsigned integer depicting
                                                    the accumulated time, in micro-
                                                    seconds, from guest NQ to DQ
     32  20  Character    8  PRCAPC_CRYRSERV        Unsigned integer depicting
                                                    the accumulated time, in micro-
                                                    seconds, from real NQ to DQ
     40  28  Character    8  PRCAPC_CRYNOWNQ        Unsigned integer depicting
                                                    the count of messages waiting
                                                    for NQ
     48  30  Character    8  PRCAPC_CRYNOVNQ        Unsigned integer depicting
                                                    the count of virtual NQ
                                                    requests
     56  38  Character    8  PRCAPC_CRYNOXVN        Unsigned integer depicting
                                                    the count of rejected virtual
                                                    NQ requests
     64  40  Character    8  PRCAPC_CRYNOXRN        Unsigned integer depicting
                                                    the count of rejected real NQ
                                                    requests
     72  48  Character    8  PRCAPC_CRYNOFNQ        Unsigned integer depicting
                                                    the count of real NQ requests
     80  50  Character    8  PRCAPC_CRYNOFDQ        Unsigned integer depicting
                                                    the count of real DQ requests
     88  58  Character    8  PRCAPC_CRYNOVPR        Unsigned integer depicting
                                                    the count of virtual DQ
                                                    requests
     96  60  Character    8  PRCAPC_CRYNOVPC        Unsigned integer depicting
                                                    the count of virtual DQ
                                                    completions
    104  68  Character    8  PRCAPC_CRYNORPR        Unsigned integer depicting
                                                    the count of real DQ requests
    112  70  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    112
    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_CRYNOWNQ           28      8
    PRCAPC_CRYNOXRN           40      8
    PRCAPC_CRYNOXVN           38      8
    PRCAPC_CRYRSERV           20      8
    PRCAPC_CRYVSERV           18      8
    PRCAPC_END                70      0
    PRCAPC_MRHDR               0      0

    This information is
    based on z/VM V6R1.0.

    Last updated on 8 Oct 2009 at 21:08:13.

    Copyright IBM Corporation, 1990, 2009