Pathway/iTS SCREEN COBOL Reference Manual (H06.10+, J06.03+)

Procedure Division
HP NonStop Pathway/iTS SCREEN COBOL Reference Manual—426750-003
6-97
SEND Statement
A SEND statement directed through an external PATHMON must specify a valid
network process name. The value specified for pathmon-name must begin with a
$ and can be followed by 1 to 4 alphanumeric characters.
If this parameter is omitted, the PATHMON that controls the server class is
assumed to have the same name as the PATHMON process that controls the
TCP.
system-name
is the name of the HP NonStop system on which the named PATHMON process is
running. The system-name can be a nonnumeric literal or a data item. The field
containing system-name can have up to 15 characters, but the TCP passes only
the first 8 characters in network communications.
The value specified for system-name must be a valid network system name that
begins with a \ and can be followed by 1 to 7 alphanumeric characters. If this
parameter is omitted, the NonStop system name of the PATHMON that controls
the server class is assumed to be the same as the system name of the PATHMON
that controls the TCP.
reply-code-value
is an integer literal or integer data item that specifies an expected reply code from
the server. The maximum number of reply code values associated with one
YIELDS clause is 255.
TERMINATION-STATUS can be used to identify the actual reply code received as
described later in this section.
VARYING
can be used to control error logging when variable-length replies are expected.
When the ON ERROR clause is present, the keyword VARYING suppresses the
logging of error 3115 (TRANSACTION REPLY SIZE INVALID) when the reply is
shorter than the YIELDS buffer. Error 3115 is still logged whenever the reply
length exceeds the length of the YIELDS buffer. The keyword VARYING has no
effect unless the ON ERROR clause is present.
identifier-2
is a data name into which a portion of the contents of the reply message is to be
placed.
CODE OTHER
is used to ensure that a match on the reply code will always occur, thus preventing
the logging of error 3112 (REPLY NUMBER NOT KNOWN TO PROGRAM) when
the actual reply code is not found in the list of expected reply codes. Note that the
CODE OTHER clause can appear by itself when no explicit reply codes are
expected.