TS/MP 2.5 Pathsend and Server Programming Manual

parameter to identify multiple nowait I/O operations. For waited I/O, this parameter is not used

and can be omitted. The default is 0F.

Considerations

• HP recommends that no-waited IOs initiated by SERVERCLASS_DIALOG_SENDL_ must be

completed by a call to AWAITIOXL. If the message size is less than or equal to 32KB,

AWAITIOX can also be used.

• If both the read-write buffers used in the call are 2MB in size, you might be able to do only

7 concurrent no-waited calls, instead of 255. For more information, see “Retaining Concurrent

Sends Limit” (page 114)

• If the SERVERCLASS_DIALOG_SENDL_ 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 108) at

the end of this chapter.

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 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_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:

0 (FEOK) indicates that the call was successful.

SERVERCLASS_SEND_ Procedure 91