SNAX/APN Application Programming Manual

The CRT Interface
SNAX/APN Application Programming Manual—420111-001
2-12
Setting Terminal Access Mode and File Access Type
(SETMODE Function 12)
Setting Terminal Access Mode and File Access Type
(SETMODE Function 12)
When a BREAK owner receives a break-on-device message, it places the terminal in
BREAK mode by using SETMODE function 12. SETMODE function 12 does two
things:
•
Establishes BREAK access to a terminal
•
Sets a terminal in BREAK mode
When the terminal is in BREAK mode, only the process that has established BREAK
access can communicate with the terminal. An application also establishes BREAK
access to a terminal by using SETMODE function 12.
param1
sets the terminal access mode.
0 Places the terminal in normal mode (any application that has the terminal open
can communicate with the terminal).
1 Places the terminal in BREAK mode (only the application that has established
BREAK access can communicate with the terminal).
param2
sets the file access type.
0 Establishes normal access to the terminal.
1 Establishes BREAK access to the terminal.
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.
CALL SETMODE ( filenum , 12 , param1 , param2 ) , ,
[ last-params ] ) ;