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

#### MRAPLEDT

Prolog
Control Block Contents
Cross Reference

#### MRAPLEDT Prolog

####

####

     DSECT NAME - APLEDT
     FUNCTION - Map a Monitor record.
     LOCATED BY -
            Through the Monitor Control Area
     REFERENCED CONTROL BLOCKS -
            MRRECHDR    Monitor Record Header
     NOTE: The length of the record must be the same as MRAPLSDT for
           the buffer/address/length specified by DIAGNOSE 'DC'.
     NAME - MRAPLEDT
     DESCRIPTIVE NAME - Monitor Event Record
                        Domain 10 - Appldata domain
                        Record 1  - Application Data Event Record
     DESCRIPTION - APPLDATA domain monitoring has ended for the buffer
                   of the specified application product/release id for
                   one of the following reasons:
                   - A Diagnose 'DC' STOP has been issued
                   - A virtual storage reset is detected (this includes
                     FORCE and LOGOFF)
                   - A purge segment occurs and it is determined that an
                     application buffer resides within the address range
                     of the segment being purged, and the segment
                     resides outside the user's virtual storage.
     NOTES:
        -- APLEDT_CALDATOF should always be used to locate the
           APLEDT_ADATA data area. Its value may be subject to change.
        -- Application data in APLEDT_ADATA is as found in the
           application-defined buffer at the time the record was
           generated.

    MRAPLEDT Control Block Contents

    Offsets
    Dec Hex  Type       Len  Name (Dim)          Description

      0   0  Structure   52  APLEDT              Start of monitor record
      0   0  Character   52  APLEDT_APHDR
      0   0  Character    0  APLEDT_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  Signed       2  APLEDT_CALDATOF     Byte offset, relative to start
                                                 of this record, of the
                                                 APLEDT_ADATA application data
                                                 area.
     22  16  Signed       2  APLEDT_CALDATLN     Length, in bytes, of application
                                                 data in APLEDT_ADATA.
     24  18  Character    8  APLEDT_USERID       Userid of virtual machine that
                                                 generated the application data in
                                                 APLEDT_ADATA.
     32  20  Character   16  APLEDT_MDGPROD      Application product id and
                                                 release id of application that
                                                 generated the application data in
                                                 APLEDT_ADATA.
     48  30  Bitstring    1  APLEDT_STATUS       Flag byte
              1... ....      APLEDT_SVMSTAT      Userid has OPTION SVMSTAT in its
                                                 directory
              .1.. ....      *
              ..1. ....      *
              ...1 ....      *
              .... 1...      *
              .... .1..      *
              .... ..1.      *
              .... ...1      *
     49  31  Character    3  *                   Reserved for IBM use
     52  34  Character    0  APLEDT_ADATA        Application data.
                                                 APLEDT_CALDATOF should be used to
                                                 get the correct location. See
                                                 APLEDT_CALDATLN for its length.

    MRAPLEDT Cross Reference

                          Hex           Hex
    Name                 Offset Length Value

    APLEDT                  0     52
    APLEDT_ADATA           34      0
    APLEDT_APHDR            0     52
    APLEDT_CALDATLN        16      2
    APLEDT_CALDATOF        14      2
    APLEDT_MDGPROD         20     16
    APLEDT_MRHDR            0      0
    APLEDT_STATUS          30      1
    APLEDT_SVMSTAT         30           80
    APLEDT_USERID          18      8
    MRHDR                   0     20
    MRHDR_END              14      0
    MRHDRDM                 4      1
    MRHDRLEN                0      2
    MRHDRRC                 6      2
    MRHDRTOD                8      8
    MRHDRZER                2      2

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

    Last updated on 22 Jul 2003 at 15:04:23.

    Copyright IBM Corporation, 1990, 2003