TS/MP 2.5 Pathsend and Server Programming Manual

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) later in this chapter.
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
The SERVERCLASS_DIALOG_SEND_ procedure is similar to the context-free SERVERCLASS_SEND_
procedure, with these differences:
• The dialog identifier, obtained from the SERVERCLASS_DIALOG_BEGIN_ call that started the
dialog, is used to identify the dialog, which is associated with a particular server-class.
• The SERVERCLASS_DIALOG_SEND_ call fails if the current transaction identifier does not
match the transaction identifier used for the SERVERCLASS_DIALOG_BEGIN_ call, unless this
feature has been overridden by setting the flags.<14> bit to 1 in the call to
SERVERCLASS_DIALOG_BEGIN_.
• The send fails if there is already an outstanding send in the dialog from a previous nowait
call to this procedure.
For additional considerations, see “Usage Considerations for Pathsend Procedures” (page 108) at
the end of this chapter.
SERVERCLASS_DIALOG_SENDL_ Procedure
The SERVERCLASS_DIALOG_SENDL_ 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:
• For waited send operations, initiation and completion are both performed by the
SERVERCLASS_DIALOG_SENDL_ procedure.
• For nowait send operations, initiation is performed by the SERVERCLASS_DIALOG_SENDL_
procedure, and completion is performed by the AWAITIOXL procedure.
The processing logic of SERVERCLASS_DIALOG_SENDL_ is same as that of
SERVERCLASS_DIALOG_SEND_. The SERVERCLASS_ DIALOG_SENDL_ procedure supports data
transmission up to 2 MB. This requires the server to be explicitly coded to handle Pathsend requests
of messages larger than 32 KB. The server must call the READUPDATEXL procedure instead of the
READUPDATEX procedure. If the reply is more than 32 KB, the server must call REPLYXL procedure
instead of REPLYX. You must use the FILE_GETRECEIVEINFOL_ instead of FILE_GETRECEIVEINFO_.
For more information about READUPDATEXL, FILE_GETRECEIVEINFOL_, and REPLYXL, see the
Guardian Procedure Calls Reference Manual.
NOTE: Messages greater than 32 KB in size are supported only on Expand-over-Servernet.
88 Pathsend Procedure Call Reference