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

is the dialog identifier previously returned from the SERVERCLASS_DIALOG_BEGIN_ call that began the dialog.

This parameter is required.

Considerations

These considerations apply to the SERVERCLASS_DIALOG_ABORT_ procedure:

• If the server has opened $RECEIVE for system message handling and is using the Common

Run-Time Environment (CRE), aborting the dialog will cause the server to receive a system

message -121, PATHSEND DIALOG ABORT.

• SERVERCLASS_DIALOG_SEND_ operations in progress within this dialog at the time of the

call to SERVERCLASS_DIALOG_ABORT_ are canceled.

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 := SERVERCLASS_DIALOG_BEGIN_

! o

( dialog-id

,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 ]

,[ tag ] ); ! o

! i

returned valueerror

INT

returns an error word containing one of

these values:

(FEOK) indicates that the call was successful and the server has ended the dialog.

SERVERCLASS_DIALOG_BEGIN_ Procedure 79