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