Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (S)
Guardian Procedure Calls Reference Manual—522629-013
14-113
SETPARAM Procedure
[1] equivalent to parameter 2 of SETMODE 11
[2] most significant word of the break tag
[3] least significant word of the break tag
where:
[0] 0, disable BREAK (default setting)
1, enable BREAK and take ownership
value from
last-param-array[1], return BREAK
ownership to previous owner
[1] Terminal access mode after BREAK is typed.
0, normal mode (any file-type access is permitted)
1, break mode (only break-type file access permitted)
[2:3] are the two words of the 32-bit tag. This is saved by the I/O
process handling the terminal. Whenever the I/O process
detects that BREAK has been typed, a break-on-device
message is sent to the owner of the BREAK for that terminal.
(The owner of BREAK is specified by the parameter in
buf[0].) See the descriptions of the break-on-device
messages in the Guardian Procedure Errors and Messages
Manual for details.
•
Processes
The SETPARAM procedure can be called on an opened process if the receiving
process has indicated (by the system messages flag of the FILE_OPEN_ or OPEN
call and by setmode 80) that it is willing to accept messages for such calls. The
system message that is delivered and used for reply is the process SETPARAM
message (-37). See the
Guardian Procedure Errors and Messages Manual for the
format of this message.
•
SETPARAM in a nowait manner
When the SETPARAM operation is performed in a nowait manner (a value other
than -1D is supplied for the
nowait-tag parameter), it must be completed by a
call to AWAITIO[X]. The
buffer-addr parameter of AWAITIO[X] is set to the
address of the
last-param-array parameter of SETPARAM; the count-
transferred parameter of AWAITIO[X] returns the number of bytes returned in
last-param-array.