TS/MP Pathsend and Server Programming Manual (H06.05+, J06.03+)

For more information on timeout for waited and nowait operations, see “Timeout Considerations for
Pathsend Programming” (page 106).
For more information on Pathsend error 904 and file system error 40, see “Server Timeout” (page 106).
inputflags
INT:value
flags.<15>
indicates that this operation is to be performed nowait with a value of 1. A value of 0 indicates
that this operation is to be performed waited. The default is 0.
flags.<14>
selects the one-transaction-per-dialog model if the value is set to 0. In this model, the dialog
records the transaction identifier that is present at the time of the
SERVERCLASS_DIALOG_BEGIN64_ call. Subsequent SERVERCLASS_DIALOG_SEND64_,
SERVERCLASS_DIALOG_ABORT_, and SERVERCLASS_DIALOG_END_ calls that use the returned
dialog-id must specify this transaction identifier, or the calls will fail. ENDTRANSACTION will
fail unless the dialog has 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 requester 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 contains the transaction identifier that is present 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 value is 0.
flags.<0:13>
The value must be 0.
NOTE: For information on setting flag 9 for TS/MP 2.3 and later versions, see “Bridging Pathsend
API into Pathway Domain” (page 108).
outputscsend-op-num
INT:ref:EXT64:*
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 105).
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.
SERVERCLASS_DIALOG_BEGIN64_ Procedure 85