Guardian Procedure Calls Reference Manual

last-param-max
input
INT:value
is the maximum number of bytes that can be placed in last-param-array . The default is
256.
nowait-tag
input
INT(32):value
if present and not -1D, specifies that the operation is to be performed in a nowait manner and
specifies the value to be returned in the tag parameter of AWAITIO[X] at completion. If
nowait-tag is omitted, or is -1D, or the file has a nowait depth of 0, the operation is waited
and is complete when the procedure returns. See Considerations.
Condition Code Settings
indicates that an error occurred (call FILE_GETINFO_ or FILEINFO).< (CCL)
indicates that the SETPARAM is successful.= (CCE)
indicates that the SETPARAM function is not allowed for this device type.> (CCG)
Considerations
• For SETPARAM function 3, param-array and last-param-array are integer arrays of
the following form:
disable BREAK (default setting)0equivalent to parameter
1 of SETMODE function
11
word[0]
enable BREAK and take ownership
value from last-param-array[1], return BREAK ownership to previous
owner
1
normal mode (any file-type access is permitted)0equivalent to parameter
2 of SETMODE function
11
word[1]
break mode (only break-type file access permitted)1
[2:3] are the two words of the 32-bit tag, which 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].) For details, see the descriptions of the
break-on-device messages in the Guardian Procedure Errors and
Messages Manual.
most significant word of
the break tag
word[2]
least significant word of
the break tag
word[3]
• Processes
SETPARAM 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). For the format of this message, see the Guardian
Procedure Errors and Messages Manual.
• 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
SETPARAM Procedure 1351