TS/MP 2.5 Pathsend and Server Programming Manual

returns a count of the number of bytes returned by the server process reply. This parameter is for
waited I/O only and can be excluded for nowait I/O. The return value of this parameter is 0 if
nowait I/O is used. For nowait I/O, the actual reply length is returned by FILE_AWAITIO64_.
inputtimeout
INT(32):value
specifies the maximum amount of time, in hundredths of a second, the ACS subsystem ROUT process
waits for completion of this send. This value must be either -1D or a value greater than 0D. The
default is -1D (wait indefinitely).
If there is an outstanding I/O operation to a server process when a SERVERCLASS_SENDL64_
operation times out, the I/O operation is canceled.
For information about timeout for waited and nowait operations, see “Timeout Considerations for
Pathsend Programming” (page 111).
For more information about Pathsend error 904 and file-system error 40, see “Server Timeout”
(page 111).
inputflags
INT:value
flags.<15> indicates that this operation must be performed using nowait with a value of 1.
A value of 0 indicates that this operation must be performed waited. The default
value is 0.
flags.<0:14> value must be 0.
NOTE: For information on setting flag 9 for TS/MP 2.5 and later versions, see “Bridging Pathsend
API into Pathway Domain” (page 113).
outputscsend-op-num
INT:ref:EXT64:1
returns the server-class send operation number. Use the server-class send operation number in place
of the file number parameter in calls to CANCEL, CANCELREQL, FILEINFO, and FILE_AWAITIO64_
for nowait sends, and in calls to FILEINFO for waited sends, to indicate that the calls refer to the
server-class send operations. The value of scsend-op-num is determined on the first successfully
initiated nowait send. This value is returned on every subsequent nowait send that is initiated
successfully. A value of -1 is returned for nowait sends that are not initiated successfully. A value of
-1 is always returned for waited sends.
For more information about the server-class send operation number, see “Server-Class Send Operation
Number” (page 110).
inputtag
INT(64):value
is used for nowait I/O only. The tag is stored by the system and then passed back to the application
by the FILE_AWAITIO64_ procedure when the nowait operation is completed. Use the tag parameter
to identify multiple nowait I/O operations. For waited I/O, this parameter is not used and can be
excluded. The default value is 0F.
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_DIALOG_BEGINL64_ Procedure
The SERVERCLASS_DIALOG_BEGINL64_ procedure initiates a dialog with a server process in a
server-class and sends the first message in the dialog.
100 Pathsend Procedure Call Reference