TS/MP 2.5 Pathsend and Server Programming Manual

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_BEGINL_ procedure.
• For nowait send operations, initiation is performed by the SERVERCLASS_DIALOG_BEGINL_
procedure, and completion is performed by calling the AWAITIOXL procedure.
The processing logic of SERVERCLASS_DIALOG_BEGINL_ is same as that of
SERVERCLASS_DIALOG_BEGIN_. The SERVERCLASS_ DIALOG_BEGINL_ 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.
Syntax
The syntax of the SERVERCLASS_DIALOG_BEGINL_ procedure is:
error := SERVERCLASS_DIALOG_BEGINL_
! o
! i:i
( dialog-id
,pathmon-process-name:length
! i:i,server-class-name:length
! i,o,message-buffer
! o,[reply-buffer]
! i,request-len
! i,maximum-reply-len
! o,[ actual-reply-len ]
! i,[ timeout ]
! i,[ flags ]
! o
! i
,[ scsend-op-num ]
,[ tag ] );
returned valueerror
INT returns an error word containing one of these values:
0 (FEOK) indicates that the call was successful and the server has ended the dialog.
70 (FEContinue) indicates that the call was successful and the server is ready for the next message in the dialog.
233 (FESCErr) indicates that an error occurred. You can call the SERVERCLASS_SEND_INFO_ procedure to get
detailed information about the error.
outputdialog-id
INT:ref:EXT(32):1
returns an identifier that can be used for subsequent operations on this dialog.
This is a mandatory parameter.
input:inputpathmon-process-name:length
contains the external Guardian process name of the PATHMON process controlling the server-class
(for example, $PM or \AB.$PMN).
OR
is the pathway domain name, whose member PATHMON processes have the server-class configured
under them (for example, %DOM, %DOM1).
82 Pathsend Procedure Call Reference