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

Considerations

The SERVERCLASS_DIALOG_SEND64_ procedure is similar to the context-free

SERVERCLASS_SEND64_ procedure, with the following differences:

• The dialog identifier, obtained from the SERVERCLASS_DIALOG_BEGIN64_ call that started

the dialog, is used to identify the dialog, which is associated with a particular server class.

• The SERVERCLASS_DIALOG_SEND64_ call fails if the current transaction identifier does not

match the transaction identifier used for the SERVERCLASS_DIALOG_BEGIN64_ call, unless

this feature has been overridden by setting the flags.<14> bit to 1 in the call to

SERVERCLASS_DIALOG_BEGIN64_.

• 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 103).

SERVERCLASS_SEND_ Procedure

The SERVERCLASS_SEND_ procedure initiates a context-free send operation to a server process

in the specified server class.

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

• For nowait send operations, initiation is performed by the SERVERCLASS_SEND_ procedure,

and completion is performed by calling the AWAITIOX procedure.

Syntax

The syntax of the SERVERCLASS_SEND_ procedure is:

( pathmon-process-name ! i

,pathmon-process-name-len ! i

error := SERVERCLASS_SEND_

,server-class-name ! i

,server-class-name-len ! 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

returned valueerror

INT

returns an error word containing one of these values:

(FEOK) indicates that the call was successful.

92 Pathsend Procedure Call Reference