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

#### MRMTRPCC

Prolog
Control Block Contents
Cross Reference

#### MRMTRPCC Prolog

     DSECT NAME - MTRPCC
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NAME - MRMTRPCC
     DESCRIPTIVE NAME - Monitor Event Record
                        Domain 1  - Monitor Domain
                        Record 35 - Protection Change
                                     Command event
     DESCRIPTION - Generated at each successful SET CPPROTECT
                   or SET SPECEX command.

     The event record is cut when a successful SET CPPROTECT
    command is issued.  The bits in CPPSTCMD and CPPSTOPT tell
    the reduction program what operands were present on the
    command.  The CPPUSER field tells what user was the target
    of the command.  The CPPISSUE field tells who issued the
    command.

    Fields will be set like this:

    SET CPPROTECT MODE1 {ON|OFF}:
       CPPSTM1
       exactly one of CPPON or CPPOFF

    SET CPPROTECT MODE2 DEFAULT {ON|OFF}:
       CPPSTM2
       CPPSTDEF
       exactly one of CPPON or CPPOFF

    SET CPPROTECT MODE2 AGAINST ALL DEFAULT:
       CPPSTM2
       CPPSTAGN
       CPPALL
       CPPDEF

    SET CPPROTECT MODE2 AGAINST userid {DEFAULT|ON|OFF}:
       CPPSTM2
       CPPSTAGN
       CPPUSER filled in with <userid>
       exactly one of CPPDEF, CPPON, or CPPOFF

    SET CPPROTECT MODE2 AGAINST * {DEFAULT|ON|OFF}:
       CPPSTM2
       CPPSTAGN
       CPPUSER filled in with a *
       exactly one of CPPDEF, CPPON, or CPPOFF

    CP translates a SET SPECEX command into its equivalent
    SET CPPROTECT command and then behaves as if SET
    CPPROTECT were the issued command.

#### MRMTRPCC Control Block Contents

    Offsets
    Dec  Hex  Type        Len  Name (Dim)             Description

       0   0  Structure    38  MTRPCC                 Start of monitor record
       0   0  Character     0  MTRPCC_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  Bitstring     1  MTRPCC_CPPSTCMD        SET cmd prot lvl input
              1... ....        MTRPCC_CPPSTM1          MODE1 requested
              .1.. ....        MTRPCC_CPPSTM2          MODE2 requested
              ..1. ....        MTRPCC_CPPSTDEF         setting MODE2 DEFAULT
              ...1 ....        MTRPCC_CPPSTAGN         setting MODE2 AGAINST
              .... 1...        *
              .... .1..        *
              .... ..1.        *
              .... ...1        *
      21  15  Bitstring     1  MTRPCC_CPPSTOPT        SET cmd type
              1... ....        MTRPCC_CPPON            ON requested
              .1.. ....        MTRPCC_CPPOFF           OFF requested
              ..1. ....        MTRPCC_CPPDEF           set a user to the DEFAULT
              ...1 ....        MTRPCC_CPPALL           set all users to the
                                                        DEFAULT
              .... 1...        *
              .... .1..        *
              .... ..1.        *
              .... ...1        *
      22  16  Character     8  MTRPCC_CPPUSER         AGAINST this user
      30  1E  Character     8  MTRPCC_CPPISSUE        user who issued the cmd
      38  26  Character        *
      40  28  Character     0  MTRPCC_END             End of record

#### MRMTRPCC 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
    MTRPCC                     0     38
    MTRPCC_CPPALL             15           10
    MTRPCC_CPPDEF             15           20
    MTRPCC_CPPISSUE           1E      8
    MTRPCC_CPPOFF             15           40
    MTRPCC_CPPON              15           80
    MTRPCC_CPPSTAGN           14           10
    MTRPCC_CPPSTCMD           14      1
    MTRPCC_CPPSTDEF           14           20
    MTRPCC_CPPSTM1            14           80
    MTRPCC_CPPSTM2            14           40
    MTRPCC_CPPSTOPT           15      1
    MTRPCC_CPPUSER            16      8
    MTRPCC_END                28      0
    MTRPCC_MRHDR               0      0

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

    Last updated on 09 August 2020 at 15:23:00.

    Copyright IBM Corporation, 1990, 2020