Programming Interface Information:
This information is NOT
intended to be
used as Programming Interfaces of VM/ESA. It is to be used for diagnosis only. |
AMSG
Cross Reference (Contains links to field and bit definitions)
AMSG Prolog
NAME : HCPAMSG DESCRIPTION: Asynchronous Event Message DSECT : AMSG FUNCTION : Preserve a Delayed Response Message until retrieved by requestor. LOCATED BY : Pointer (VDEVAEVT) in the Virtual Device Block Pointer (VDEVREVT) in the Virtual Device Block Pointer (SCTMFPT/SCTMLPT) in CFLF Subsystem Connect Table (See NOTES below). CREATED BY : HCPSVIAP - Delayed Response Message Routing. HCPLFPSF - CFLF Perform Subsystem Function CCW Simulation (See NOTES below). DELETED BY : HCPAEPPD - Purge all outstanding AEBK, AMSG and IOCM blocks for the Virtual Device. HCPAEPRD - Retrieve Delayed Response Message (CCW SIMULATION) HCPLFSIM - CFLF Read Subsystem Data CCW simulation (See NOTES below). NOTES : This block is also used by the CFLF simulation support. In thi case the Asynchronous Message block is allocated and returned either Synchronously or Asynchronously to a CFLF user during Read Subsystem Data CCW simulation.
AMSG Control Block Content
AMSG DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure AMSG Asynchronous Event Message 0000 0 Bitstring 0 AMSGHDR (0) Header record 0000 0 Address 4 AMSGNEXT Pointer to next AMSG block NOTE: must be at the same offset as IOCMNEXT in the HCPIOCM block. 0004 4 Character 4 AMSGBKID Identifies storage area as an AMSG block. NOTE: must be at the same offset as IOCMBKID in the HCPIOCM block. 0008 8 Signed 4 AMSGTLG Length of the entire message Block in BYTES = Header Length(AMSGHDRL) + Content Length. 000C 12 Signed 4 AMSGMGID Message ID 0010 16 Signed 2 AMSGLGH Length of the message NOTES : There is not a strict relationship between this status and DRM status. 0012 18 Bitstring 1 AMSGEVST Asynchronous Event status .... ...1 AMSGNOEV X'01' Event does not exist at device. .... ..1. AMSGPNEV X'02' Event pending completion in the device. .... .1.. AMSGCPEV X'04' Event completed at the device. 0013 19 Bitstring 1 AMSGSESS Session ID 0014 20 Character 4 * Reserved for future IBM use 00000018 AMSGHDRL *-AMSGNEXT Length of Header in bytes 0018 24 Bitstring 1 AMSGBUF (0) Message buffer contents - Variable length data. See HCPDMSG for an overlay of the AMSGBUF field. 0000021C AMSGMAXB 540 Maximum number of bytes of storage needed for the Asynchronous Message Buffer. Code defined for Setting/Testing AMSGBKID 00D4E2C7 AMSGID C'AMSG' Used to set block identifier
AMSG Storage Layout
*** AMSG - Asynchronous Event Message * * +---------------------------+---------------------------+ * 0 | AMSGNEXT | AMSGBKID | * +---------------------------+---------------------------+ * 8 | AMSGTLG | AMSGMGID | * +-------------+------+------+---------------------------+ * 10 | AMSGLGH |:GEVST|:GSESS|///////////////////////////| * +-------------+------+------+---------------------------+ * 18 | | * = AMSGBUF = * | | * +-------------------------------------------------------+ * *** AMSG - Asynchronous Event Message
AMSG Cross Reference
(contains links to field and bit definitions)Symbol Dspl Value -------------- ---- -----AMSGBKID 0004
AMSGBUF 0018
AMSGCPEV 0012 04
AMSGEVST 0012
AMSGHDR 0000
AMSGHDRL 0014 00000018
AMSGID 0018 00D4E2C7
AMSGLGH 0010
AMSGMAXB 0018 0000021C
AMSGMGID 000C
AMSGNEXT 0000
AMSGNOEV 0012 01
AMSGPNEV 0012 02
AMSGSESS 0013
AMSGTLG 0008
Last updated on 3 Aug 1999 at 11:39:45 EDT.
Copyright IBM Corporation, 1990, 1999