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 V6R1.0.

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

    Copyright IBM Corporation, 1990, 2009