User`s guide
cxxxvi Contents
The application must correct the situation if one of the following return codes is specified:
WHLLTRANCANCL Is returned if the first Read Structured Fields (126) or Write
Structured Fields (127) is requested after an outbound
transmission from the host is canceled.
WHLLHOSTCLOST Which requires the application to disconnect from the
communications subsystem and reconnect to establish
communications with the host again.
WHLLOKDISABLED Which is returned if the host is inbound disabled.
When the call to Read Structured Fields (126) is complete, the Read Buffer, whose address was
specified in positions 5-8 of the data string, will contain the structured fields received from the host
application.
The format of the Read Buffer is as follows:
Position Meaning
Bytes 0-1 A 16-bit value - 0x0000.
Bytes 2-3 A 16-bit value which contains the Message length (m), which is the
number of bytes of data in the message not including the 8-byte message
header. This value is returned by the subsystem.
Bytes 4-5 A 16-bit value which contains the Buffer Size (n), which is the supplied
length of the data buffer not including the 8-byte message header.
Bytes 6-7 A 16-bit value - 0xC000
Bytes 8-9 A 16-bit value which contains the Length of the first or only structured
field message (not byte-reversed).
Byte 10 First non-length byte of the structured field message.
Byte m Last byte in the structured field message.
Bytes 0-7 are the buffer header, which is passed to and used by the communications subsystem. The
application must prepare the buffer header before using it in the structured fields call. The word at
position 0 must be set to a value of zero. The length of the buffer, requested with the Allocate
Communications Buffer (123) function, must be in the word at position 4. The word at position 6 must
be set to 0xC000.
Remarks