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 V5R4.0.
Last updated on 5 Sep 2008 at 09:11:41.
Copyright IBM Corporation, 1990, 2008