AM3270/TR3271 Reference Manual

Details of the CRT Protocol
AM3270 Subdevice Protocols
4–14 086705 Tandem Computers Incorporated
The format is:
CALL SETMODE (filenumber, 53, param1, param2, lastparams);
filenumber
INT:value, the file number for the subdevice as returned by the OPEN.
53
INT:value, the SETMODE value for receiving 3270 status.
param1
INT:value, 0 disable status receive.
1 enable status receive.
param2
INT:value, the response ID. This 16-bit quantity is provided as identification by
the requesting process. This ID is returned in the buffer along with the device
status sent by a subdevice. The purpose of this ID is to provide a tag for the
application. Generation and subsequent usage of the tag is the responsibility of
the application.
lastparams
INT:ref:2, if provided, returns the current param1 and param2.
Possible Errors Returned
0 operation completed without error
2 operation not allowed on this file type
181 the subdevice is currently enabled for receiving status
$RECEIVE System Message
When an application has enabled status receipt, any status messages appear through
$RECEIVE as system message -21. The format of the message is:
sysmsg[0] -21 (3270 device status received.)
sysmsg[1] the response ID.
sysmsg[2] the actual controller status bytes, in which the status byte = <0:7>and
the sense byte = <8:15>.
sysmsg[3] a translation of device status to status bits. Note that the application may
pass this word directly to TR3271 using SETMODE 51 (see Section 9,
“CRT Protocol—TR3271”) in order to post status on a TR3271 subdevice.