TS/MP Pathsend and Server Programming Manual (G06.24+, H06.03+)

NonStop TS/MP Pathsend and Server Programming Manual–132500
6-1
6
Pathsend Errors
This section describes the error codes that can be returned by the Pathsend procedure
calls. These errors can be returned by processes that call the Pathsend procedures
directly and also by software that uses these procedures internally, such as the NonStop
TUXEDO system.
Types of Errors Returned by the
Pathsend Procedures
Three errors are associated with each call to a Pathsend procedure (except
SERVERCLASS_SEND_INFO_):
•
A return error
•
A Pathsend error
•
A file-system error
The return error is the error returned by the Pathsend procedure or by AWAITIOX. For
details about the return errors for a particular procedure call, see the error parameter
in the syntax description for that call in Section 5, Pathsend Procedure Call Reference
.
For waited send operations, the return error is returned from the Pathsend procedure call.
For nowait send operations, the return error is returned from the Pathsend procedure call
if it is a send-initiation error. For errors other than send-initiation errors, the return error
is returned by the AWAITIOX procedure and can be retrieved by calling the FILEINFO
procedure.
If the return error is error 233 (FEScError), you can call
SERVERCLASS_SEND_INFO_ to retrieve the Pathsend error and the file-system error.
(If the return error is 0 (FEOK), both the Pathsend error and the file-system error are
always 0, so you do not need to call SERVERCLASS_SEND_INFO_.)
The Pathsend errors are described in this section. The file-system errors are described in
the Guardian Procedures Errors and Messages Manual; however, specific Pathsend
considerations for some of the file-system errors are given in this section in the
descriptions of the associated Pathsend errors.
Descriptions of Pathsend Errors
The Pathsend error codes are described in numeric order on the following pages.
Each description includes the following:
•
The error number and corresponding error literal
•
The cause of the error
•
Typical file-system errors that can be encountered with the Pathsend error
•
The effect of the error