Programming Interface Information:
The Monitor Records are intended Programming Interfaces that allow the customer to write programs to obtain services of z/VM. |
MRAPLEDT
PrologControl 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 V5R4.0.
Last updated on 5 Sep 2008 at 09:11:41.
Copyright IBM Corporation, 1990, 2008