TS/MP 2.5 Pathsend and Server Programming Manual

Considerations
See “Usage Considerations for Pathsend Procedures” (page 108). If both the read-write buffers used
in the call are 2MB in size, you might be able to do only 7 concurrent no-waited calls, instead of
255. For more information, see “Retaining Concurrent Sends Limit” (page 114)
SERVERCLASS_SEND_INFO_ Procedure
The SERVERCLASS_SEND_INFO_ procedure retrieves error information about the last
SERVERCLASS_SEND_, SERVERCLASS_DIALOG_BEGIN_, SERVERCLASS_DIALOG_SEND_,
SERVERCLASS_DIALOG_END_, or SERVERCLASS_DIALOG_ABORT_ operation that was initiated
or completed with return error 233 (FEScError) or 0 (FEOK).
If the return error from the previous Pathsend call is 0 (FEOK), both the Pathsend error and the
file-system error will always be 0, so you do not need to call SERVERCLASS_SEND_INFO_.
Syntax
The syntax of the SERVERCLASS_SEND_INFO_ procedure is:
( pathsend-error ! o
,file-system-error ); ! o
error := SERVERCLASS_SEND_INFO_
returned valueerror
INT
returns an error word. This error is associated with the call to SERVERCLASS_SEND_INFO_ and not
with the previous Pathsend call. The error word contains one of these file-system errors:
0 (FEOK) indicates that no errors occurred in the call to SERVERCLASS_SEND_INFO_.
2 (FEInvalOp) is returned if the caller has an invalid segment in use. Error 2 is also returned if the caller has no
extended data segment in use and one of the reference parameters is an extended address.
2, 2 (FEBoundsErr) is returned if a reference parameter is out of bounds.
2 9 (FEMissParam) is returned if a required parameter is missing.
These errors are programming errors.
outputpathsend-error
INT:ref:1
returns the Pathsend error. See chapter 6, “Pathsend Errors” (page 115), for descriptions of Pathsend
errors.
outputfile-system-error
INT:ref:1
returns the file-system error. See the Guardian Procedure Errors and Messages Manual for descriptions
of file-system errors.
Considerations
These considerations apply to the SERVERCLASS_SEND_INFO_ procedure:
• The condition code setting has no meaning following a call to SERVERCLASS_SEND_INFO_.
• A call to SERVERCLASS_SEND_INFO_ before a call is ever made to SERVERCLASS_SEND_
or SERVERCLASS_DIALOG_BEGIN_ results in return error 0 (FEOK), Pathsend error 906
(FEScNoSendEverCalled), and file-system error 0 (FEOK).
SERVERCLASS_SEND_INFO_ Procedure 97