TS/MP 2.5 Pathsend and Server Programming Manual

SERVERCLASS_SENDL64_ Procedure
The SERVERCLASS_SENDL64_ procedure initiates a context-free send operation to a server process
in the specified server-class.
The completion of this processing receives the final outcome (success or failure). If successful, the
reply data occurs in one of the following ways, depending on whether the send operation is
initiated as waited or nowait:
• SERVERCLASS_SENDL64_ procedure performs initiation and completion for waited send
operations.
• SERVERCLASS_SENDL64_ procedure performs initiation for nowait send operations and the
completion is performed by calling the FILE_AWAITIO64_ procedure.
NOTE: This procedure is supported in TS/MP 2.5 and later versions and is applicable only on
systems running H06.22/J06.13 and later H-series/J-series RVUs.
The SERVERCLASS_SENDL64_ 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
size of the reply is more than 32 KB, the server needs to call REPLYXL instead of REPLYX. For more
information about READUPDATEXL and REPLYXL, see the Guardian Procedure Calls Reference
Manual.
NOTE: Messages greater than 32 KB in size are supported only on Expand-over-Servernet.
Syntax
The syntax of the SERVERCLASS_SENDL64_ procedure is
error := SERVERCLASS_SENDL64_
! i
! i
( pathmon-process-name
,pathmon-process-name-len
! i,server-class-name
! i,server-class-name-len
! i,o,message-buffer
! o,[ reply-buffer ]
! i,request-len
! i,maximum-reply-len
! o,[ actual-reply-len ]
! i,[ timeout ]
! i,[ flags ]
! o
! i
,[ scsend-op-num ]
,[ tag ] );
returned valueerror
INT returns a file system error number indicating the outcome of the operation.
inputpathmon-process-name
STRING:ref:EXT64:*
contains the external Guardian process name of the PATHMON process controlling the server-class
(for example, $PM or \AB.$PMN).
OR
is the pathway domain name, whose member PATHMON processes have the server-class configured
under them (for example, %DOM, %DOM1).
The process name portion can have up to five characters after the dollar sign ($), if it is a local
process name, and up to four characters after the $ sign if it is a process on a remote system. The
98 Pathsend Procedure Call Reference