TS/MP 2.5 Pathsend and Server Programming Manual

returns the server-class send operation number. You can use the server-class send operation number
in place of the file-number parameter in calls to CANCEL, CANCELREQ, FILEINFO, and
FILE_AWAITIO64_ for nowait sends, and in calls to FILEINFO for waited 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 value is 0D.
Considerations
If the SERVERCLASS_DIALOG_BEGINL64_ procedure fails but does not return a valid dialog
identifier, the dialog was never created. In this case, there is no need to abort the dialog.
For additional considerations, see “Usage Considerations for Pathsend Procedures” (page 108).
SERVERCLASS_DIALOG_SENDL64_ Procedure
The SERVERCLASS_DIALOG_SENDL64_ procedure initiates a send within the specified dialog.
The completion of this processing that is, getting the final outcome (success or failure) and, if
successful, the reply data occurs in one of the two ways, depending on whether the send operation
is initiated as waited or nowait:
• The SERVERCLASS_DIALOG_SENDL64_ procedure performs initiation and completion for
waited send operations.
• The SERVERCLASS_DIALOG_SENDL64_ procedure performs initiation for nowait send
operations and completion is performed by calling the FILE_AWAITIO64_ procedure.
This procedure is similar to the context-free SERVERCLASS_SENDL64_ procedure, with a few
differences as described under “Considerations” (page 106).
NOTE: Messages greater than 32 KB in size are supported only on Expand-over-Servernet.
Syntax
The syntax of the SERVERCLASS_DIALOG_SENDL64_ procedure is:
error := SERVERCLASS_DIALOG_SENDL64_
! i
! i,o
( dialog-id
, message-buffer
! o, [ reply-buffer ]
! i, request-len
! o, maximum-reply-len
! i, [ actual-reply-len ]
! i, [ timeout ]
! o, [ flags ]
! i
! i
, [ scsend-op-num ]
, [ tag ] );
104 Pathsend Procedure Call Reference