TS/MP 2.5 Pathsend and Server Programming Manual

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
name cannot include an optional first or second name qualifier. The name must be left justified in
the buffer, and can contain trailing blanks.
The domain name portion can have minimum two and a maximum of eight characters. It must begin
with a ‘%’ sign and can contain alphanumeric characters. Also, special characters, ‘-‘ and ‘_’ are
allowed. Since Pathway domain is a logical entity, it cannot be qualified by the node name.
This is a mandatory parameter.
input:inputserver-class-name:length
STRING:ref:EXT64:*, INT:value
contains the name of the server-class (for example, EMP-SERVER). This name must conform to the
Pathway server-class naming rules, must be left justified in the buffer, and can contain trailing blanks.
This server-class name, along with the pathmon-process-name uniquely identifies a server-class.
The integer value is the byte length of the server-class-name string. This value can range from
1 through 15.
This is a mandatory parameter.
input, outputmessage-buffer
STRING:ref:EXT64:*
contains the message to send to the server-class. On successful completion of the send operation,
message-buffer contains the reply from the server-class.
This is a mandatory parameter.
inputreply-buffer
STRING.EXT64:ref.*
contains the reply from the server-class on successful completion of the send operation.
inputrequest-len
INT:value
is the byte length of the data contained in message-buffer. The range of acceptable values is 0
through 2097152.
This is a mandatory parameter.
inputmaximum-reply-len
INT:value
is the maximum number of bytes that the reply message from the server-class can contain. The range
of acceptable values is 0 through 2097152.
No more than maximum-reply-len bytes of the actual reply are placed into message-buffer upon
successful completion of a send operation.
It is not an error if the server replies with a byte count not equal to the maximum-reply-len value
specified by the requestor in the call to this procedure. If the server replies with a byte count greater
than the maximum-reply-len value, the actual bytes transferred are truncated to maximum-reply-len.
102 Pathsend Procedure Call Reference