Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (R)
Guardian Procedure Calls Reference Manual—522629-013
13-60
REPLY[X] Procedures
error-return input
INT:value (Use with REPLY and REPLYX)
is an error indication that is returned, when the originator’s I/O operation
completes, to the originator associated with this reply. This indication appears to
the originator as a normal file-system error return. The originator’s condition code
is set according to the relative value of
error-return.
(Error numbers 300-511 are reserved for user applications; errors numbers 10-255
and 512-32767 are HP errors.)
The
error-return value is returned in the last-error parameter of
FILE_GETINFO_, or in the
error parameter of FILEINFO, when the originator
calls one of these procedures for the associated completion.
If
error-return is omitted, a value of 0 (no error) is returned to the message
originator.
Condition Code Settings
< (CCL) indicates that an error occurred (call FILE_GETINFO_ or FILEINFO).
= (CCE) indicates the REPLY[X] is successful.
> (CCG) does not return from REPLY[X].
Considerations
•
Replying to queued messages
Several interprocess messages can be read and queued by the application
process before a reply must be made. The maximum number of messages that
the application process expects to read before a corresponding reply must be
specified in the
receive-depth parameter to the FILE_OPEN_ or OPEN
procedure.
If $RECEIVE is opened with
receive-depth = 0, only READ[X] can be called;
READUPDATE[X] and REPLY[X] fail with error 2 (“operation not allowed on this
type of file”).
File System Error Condition Code Setting
10-32767 CCL (error)
0 CCE (no error)
1-9 CCG (warning)