TS/MP 2.5 Pathsend and Server Programming Manual

If there is an outstanding I/O operation to a server process when a SERVERCLASS_DIALOG_BEGINL_
operation times out, the I/O operation is canceled.
For details about timeout for waited and nowait operations, see “Timeout Considerations for Pathsend
Programming” (page 111) later in this chapter.
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 is 0.
flags.<14> if set to 0, flags.<14> selects the one-transaction-per-dialog model. In this model,
the dialog records the transaction identifier that is current at the time of the
SERVERCLASS_DIALOG_BEGINL_ call. Subsequent
SERVERCLASS_DIALOG_SENDL_, SERVERCLASS_DIALOG_ABORT_, and
SERVERCLASS_DIALOG_END_ calls that use the returned dialog-id must
specify this transaction identifier, or the calls fail. ENDTRANSACTION fails
unless the dialog is ended (not aborted).
When this bit is set to 0, the TMF subsystem treats a dialog like an I/O operation:
the ENDTRANSACTION operation fails until the dialog has finished. The same
restriction applies to a nested server (a server that receives a request and then
becomes a requestor to other servers): if a server receives a message in a dialog
and then initiates a dialog with another server, it must complete the entire
initiated dialog before replying to the message from the received dialog.
A value of 1 selects the any-transaction-per-dialog model. In this model, all
server-class send operations within the dialog will contain the transaction
identifier that is current at the time of the send, and there are no restrictions on
ENDTRANSACTION other than those associated with calls to the WRITEREAD
procedure.
The default is 0.
flags.<0:13> must be 0.
outputscsend-op-num
INT:ref:EXT:1
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, and AWAITIOXL 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 for 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) later in this chapter.
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 AWAITIOXL 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 omitted. The default is 0F.
84 Pathsend Procedure Call Reference