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

successfully initiated nowait send. This value is returned on every subsequent nowait send that is
initiated successfully. A value of -1 is returned for nowait sends that are not initiated successfully. A
value of -1 is always returned for waited sends.
For more information about the server-class send operation number, see “Server-Class Send Operation
Number” (page 105).
inputtag
INT(64):value
is used for nowait I/O only. The tag is stored by the system and then passed back to the application
by the FILE_AWAITIO64_ procedure when the nowait operation is completed. You can use the tag
parameter to identify multiple nowait I/O operations. For waited I/O, this parameter is not used
and can be omitted. The default is 0D.
Considerations
Refer to “Usage Considerations for Pathsend Procedures” (page 103) at the end of this section.
SERVERCLASS_SENDL_ Procedure
The SERVERCLASS_SENDL_ procedure initiates a context-free send operation to a server process
in the specified server class.
The completion of this processing—receiving the final outcome (success or failure) and, if successful,
the reply data—occurs in one of the following ways, depending on whether the send operation is
initiated as waited or nowait:
• For waited send operations, initiation and completion are performed by the
SERVERCLASS_SENDL_ procedure.
• For nowait send operations, initiation is performed by the SERVERCLASS_SENDL_ procedure,
and completion is performed by calling the AWAITIOXL procedure.
NOTE: The SERVERCLASS_SENDL_ procedure is supported by TS/MP 2.4 and is applicable
only on systems running J06.05 and later J-series RVUs and H06.16 and later H-series RVUs.
The SERVERCLASS_SENDL_ procedure supports data transmission of up to 2 MB. For this, the
server must be explicitly coded to handle Pathsend requests of message size more than 32 KB.
The server must call the READUPDATEXL procedure instead of the READUPDATEX procedure. If the
reply is more than 32 KB, the server needs to call REPLYXL instead of REPLYX. For information on
READUPDATEXL and REPLYXL, see the Guardian Procedure Calls Reference Manual.
NOTE: The messages greater than 32 KB in size is supported only on Expand-over-Servernet.
Syntax
The syntax of the SERVERCLASS_SENDL_ procedure is
( pathmon-process-name ! i
,pathmon-process-name-len ! i
error := SERVERCLASS_SENDL_
,server-class-name ! i
,server-class-name-len ! i
,message-buffer ! i,o
,[ reply-buffer ] ! o
,request-len ! i
,maximum-reply-len ! i
,[ actual-reply-len ] ! o
,[ timeout ] ! i
,[ flags ] ! i
,[ scsend-op-num ] ! o
,[ tag ] ); ! i
98 Pathsend Procedure Call Reference