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
Prolog
Control Block Contents
AMSG DSECT
Storage Layout
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
This information is
based on VM/ESA 2.4.0.
Last updated on 3 Aug 1999 at 11:39:45 EDT.
Copyright IBM Corporation, 1990, 1999
|
