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

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.
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: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 AWAITIOX 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.
See “Server-Class Send Operation Number” (page 105) later in this section for more information
about the server-class send operation number.
inputtag
INT(32):value
is used for nowait I/O only. The tag is stored by the system and then passed back to the application
by the AWAITIOX 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 0D.
Considerations
If the SERVERCLASS_DIALOG_BEGIN_ 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, refer to “Usage Considerations for Pathsend Procedures” (page 103)
at the end of this section.
SERVERCLASS_DIALOG_BEGIN64_ Procedure
NOTE: This procedure is applicable to TS/MP 2.0 only. It is not supported in TS/MP 2.1, 2.3,
and 2.4.
The SERVERCLASS_DIALOG_BEGIN64_ procedure initiates a dialog with a server process in a
server class and sends the first message in the dialog.
The procedure identifies the server class to the system and returns a dialog identifier for subsequent
dialog operations. A SERVERCLASS_DIALOG_BEGIN64_ call must be matched by a
SERVERCLASS_DIALOG_ABORT_ or SERVERCLASS_DIALOG_END_ call at the end of the 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 two ways, depending on whether the send operation
is initiated as waited or nowait:
• The SERVERCLASS_DIALOG_BEGIN64_ procedure performs initiation and completion for
waited send operations.
• The SERVERCLASS_DIALOG_BEGIN64_ procedure performs initiation for nowait send
operations and completion is performed by calling the FILE_AWAITIO64_ procedure.
82 Pathsend Procedure Call Reference