TS/MP Pathsend and Server Programming Manual (G06.24+, H06.03+)

Pathsend Procedure Call Reference
NonStop TS/MP Pathsend and Server Programming Manual–132500
5-7
SERVERCLASS_DIALOG_BEGIN_ Procedure
SERVERCLASS_DIALOG_BEGIN_ Procedure
The SERVERCLASS_DIALOG_BEGIN_ 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_BEGIN_ 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:
•
For waited send operations, initiation and completion are both performed by the
SERVERCLASS_DIALOG_BEGIN_ procedure.
•
For nowait send operations, initiation is performed by the
SERVERCLASS_DIALOG_BEGIN_ procedure, and completion is performed by
calling the AWAITIOX procedure.
Syntax
The syntax of the SERVERCLASS_DIALOG_BEGIN_ procedure is:
error returned value
INT
error := SERVERCLASS_DIALOG_BEGIN_
( dialog-id ! o
,pathmon-process-name:length !
i:i
,server-class-name:length !
i:i
,message-buffer !
i,o
,request-len ! i
,maximum-reply-len ! i
,[ actual-reply-len ] ! o
,[ timeout ] ! i
,[ flags ] ! i
,[ scsend-op-num ] ! o
,[ tag ] ); ! i