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

Procedure Division
HP NonStop Pathway/iTS SCREEN COBOL Reference Manual—426750-003
6-42
DIALOG-BEGIN
Unspecified Reply Codes
These cases may be considered.
•
Case 1: If the application does not handle the reply codes received from the server
and there is no ON ERROR clause, then TCP causes the terminal to be
suspended.
•
Case 2: If a reply code is received but the reply length received does not match the
length of the selected data item holding the reply, then also TCP suspends the
terminal, provided there is no ON ERROR clause specified by the program.
However, there is a difference between PATHTCP3 and PATHTCP4. After suspending
the terminal, PATHTCP3 logs an error message to the owning Pathmon of the server
class. In the first case, the log error is 3112 (REPLY NUMBER NOT KNOWN TO
PROGRAM) and in the second case the log error is 3115 (TRANSACTION REPLY
SIZE INVALID). These errors are server-class errors that always appear against a
STATUS SERVER command. PATHTCP4, being a Pathsend requester, cannot
directly link to the server class. Therefore, any server-class error cannot be reported to
the concerned PATHMON process. Errors 3112 and 3115 are changed to TERMINAL
errors in PATHTCP4 and are reported in response to the STATUS TERM command.
Occasionally, an application may choose not to specify all reply codes. However, it is
still able to suppress error 3112. SCOBOL supports this by specifying the REPLY
CODE OTHER clause. For more information, see Unspecified Reply Codes on
page 6-101 under SEND statement.
Server reply shorter than
YIELDS buffer
TERMINATION-SUBSTATUS equals server reply
length.
Server reply length equals
YIELDS buffer length
TERMINATION-SUBSTATUS is undefined. This
case does not cause the TCP to invoke the ON
ERROR clause.
Server reply longer than
YIELDS buffer but shorter
than Pathsend buffer
TERMINATION-SUBSTATUS equals server reply
length.
Server reply longer than
YIELDS buffer but equals
Pathsend buffer length
TERMINATION-SUBSTATUS equals server reply
length.
Server reply longer than
YIELDS buffer and longer
than Pathsend buffer
TERMINATION-SUBSTATUS equals Pathsend
buffer length.