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

Considerations

If the SERVERCLASS_DIALOG_BEGIN64_ 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, see “Usage Considerations for Pathsend Procedures” (page 103).

SERVERCLASS_DIALOG_END_ Procedure

The SERVERCLASS_DIALOG_END_ procedure cleans up resources for the specified

dialog after the server has ended it.

A call to SERVERCLASS_DIALOG_BEGIN_ must be matched by a call to

SERVERCLASS_DIALOG_ABORT_ or SERVERCLASS_DIALOG_END_ at the end of

the dialog. For the SERVERCLASS_DIALOG_END_ procedure to work correctly, the

server must previously have ended the dialog by replying with an error value other

than FEContinue (70).

This procedure does not perform any I/O operations.

Syntax

The syntax of the SERVERCLASS_DIALOG_END_ procedure is:

! i

error := SERVERCLASS_DIALOG_END_ (

dialog-id );

returned valueerror

INT

returns an error word containing one of these values:

(FEOK) indicates that the call was successful.

23, 3

(FESCErr) indicates that an error occurred. You can call the SERVERCLASS_SEND_INFO_

procedure to get more detailed information about the error.

inputdialog-id

INT(32):value

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

the dialog.

This parameter is required.

Considerations

None.

SERVERCLASS_DIALOG_SEND_ Procedure

The SERVERCLASS_DIALOG_SEND_ 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 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_SEND_ procedure.

• For nowait send operations, initiation is performed by the SERVERCLASS_DIALOG_SEND_

procedure, and completion is performed by the AWAITIOX procedure.

86 Pathsend Procedure Call Reference