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

#### MRAPLSDT

Prolog
Control Block Contents
Cross Reference

#### MRAPLSDT Prolog

####

####

     DSECT NAME - APLSDT
     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 MRAPLEDT for
           the buffer/address/length specified by DIAGNOSE 'DC'.
     NAME - MRAPLSDT
     DESCRIPTIVE NAME - Monitor Sample Record
                        Domain 10 - Appldata domain
                        Record 2  - Application Data Sample Record
     DESCRIPTION - Application data as found in the application-defined
                   buffer at the time of this sample interval. A
                   separate record is generated for each buffer
                   declared by the virtual machine(s) via the Diagnose
                   'DC' START operation.
     NOTES:
        -- APLSDT_CALDATOF should always be used to locate the
           APLSDT_ADATA data area. Its value may be subject to change.
        -- Application data in APLSDT_ADATA is as found in the
           application-defined buffer at the time the record was
           generated.

    MRAPLSDT Control Block Contents

    Offsets
    Dec Hex  Type       Len  Name (Dim)          Description

      0   0  Structure   52  APLSDT              Start of monitor record
      0   0  Character   52  APLSDT_APHDR
      0   0  Character    0  APLSDT_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  APLSDT_CALDATOF     Byte offset, relative to start
                                                 of this record, of the
                                                 APLSDT_ADATA application data
                                                 area.
     22  16  Signed       2  APLSDT_CALDATLN     Length, in bytes, of application
                                                 data in APLSDT_ADATA.
     24  18  Character    8  APLSDT_USERID       Userid of virtual machine that
                                                 generated the application data in
                                                 APLSDT_ADATA.
     32  20  Character   16  APLSDT_MDGPROD      Application product id and
                                                 release id of application that
                                                 generated the application data in
                                                 APLSDT_ADATA.
     48  30  Bitstring    1  APLSDT_STATUS       Flag byte
              1... ....      APLSDT_SVMSTAT      Userid has OPTION SVMSTAT in its
                                                 directory
              .1.. ....      APLSDT_FIRSTR       This is the first record
                                                 generated since the Diagnose 'DC'
                                                 was issued for this application
                                                 product/release id
              ..1. ....      *
              ...1 ....      *
              .... 1...      *
              .... .1..      *
              .... ..1.      *
              .... ...1      *
     49  31  Character    3  *                   Reserved for IBM use
     52  34  Character    0  APLSDT_ADATA        Application data.
                                                 APLSDT_CALDATOF should be used to
                                                 get the correct location. See
                                                 APLSDT_CALDATLN for its length.

    MRAPLSDT Cross Reference

                          Hex           Hex
    Name                 Offset Length Value

    APLSDT                  0     52
    APLSDT_ADATA           34      0
    APLSDT_APHDR            0     52
    APLSDT_CALDATLN        16      2
    APLSDT_CALDATOF        14      2
    APLSDT_FIRSTR          30           40
    APLSDT_MDGPROD         20     16
    APLSDT_MRHDR            0      0
    APLSDT_STATUS          30      1
    APLSDT_SVMSTAT         30           80
    APLSDT_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