SNAX/APN Application Programming Manual

The CRT Interface
SNAX/APN Application Programming Manual—420111-001
2-13
Obtaining SNA Sense Codes
(SETMODE Function 53)
Obtaining SNA Sense Codes (SETMODE Function 53)
In an SNA environment, error status from a device is passed to an application process in
the form of a 4-byte sense code. In a Tandem SNAX/APN environment, an application
process that uses the CRT interface receives a file-system error instead. To obtain the
SNA sense code that caused the file-system error, the application issues the SETMODE
procedure call as follows:
params
returns a 4-byte SNA sense code in the array.
last-params
allows you to view the most recent option setting. Because the option can also be
set using SCF or SPI, the returned value indicates the setting before this call takes
effect.
For a list of SNA sense codes and the file-system errors they generate in the SNAX/APN
environment, see Appendix B.
Placing a Session in the Between Brackets State
(SETMODE Function 112)
You can use SETMODE function 112 to place an LU-LU session in the between
brackets (BETB) state so that either the first speaker or the bidder can bid to open a new
bracket. SETMODE function 112 has the following syntax:
param
0 Disables BETB.
1 Enables BETB.
The next write operation (after SETMODE 112 with param 1) causes SNAX/APN
to set the end bracket indicator in the request/response header of the function
management data request unit sent to the device LU.
If the session is already in the BETB state when param 1 is called, the next write
operation (after SETMODE 112 with param 1) causes SNAX/APN to set both the
begin bracket indicator (BBI) and end bracket indicator in the response header; a
bracket is opened and closed for the single RU sent to the device LU.
CALL SETMODE ( filenum , 53 , , , params ) , ,
[ last-params ] ) ;
CALL SETMODE ( filenum , 112 , param ) , ,
[ last-params ] ) ;