TS/MP 2.5 Pathsend and Server Programming Manual

returns a count of the number of bytes returned in 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, that the ACS subsystem ROUT
process waits for the 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 the
SERVERCLASS_DIALOG_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 is to be performed nowait if the value is 1. A value
of 0 indicates that this operation is to be performed waited. The default value
is 0.
flags.<0:14> The value must be 0.
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, CANCELREQ, and FILE_AWAITIO64_ for nowait
sends, and in calls to FILEINFO for waited and nowait sends, to indicate that the calls refer to
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. You can 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 is 0D.
Considerations
The SERVERCLASS_DIALOG_SENDL64_ procedure is similar to the context-free
SERVERCLASS_SENDL64_ procedure, with the following differences:
• The dialog identifier, obtained from the SERVERCLASS_DIALOG_BEGINL64_ call that started
the dialog, is used to identify the dialog, which is associated with a particular server-class.
• The SERVERCLASS_DIALOG_SENDL64_ call fails if the current transaction identifier does not
match the transaction identifier used for the SERVERCLASS_DIALOG_BEGINL64_ call, unless
106 Pathsend Procedure Call Reference