Pathway/iTS TCP and Terminal Programming Guide

Handling Errors
Compaq NonStop™ Pathway/iTS TCP and Terminal Programming Guide—426751-001
10-4
Responding to SEND Errors
These errors indicate that the SERVERPOOL (7) or MAXREPLY (8) parameter
supplied in the PATHCOM SET TCP command at configuration time is smaller than
that required by one of the message or reply definitions declared in the requester.
No message is sent and no reply data is available.
Upon detecting either of these error conditions, your ON ERROR code should send a
message to the terminal telling the operator what is happening (such as FATAL
CONFIGURATION ERROR, TERMINATING EXECUTION), log an error record to
an appropriate server, and then perform a STOP RUN statement.
The code in Table 10-1
indicates that the reply message received from the server was
either longer or shorter than the reply format defined within the requester.
If the received reply message is shorter than the working-storage structure defined for it,
the message is available in the target working-storage data structure. The actual length
of the received message is placed in the TERMINATION-SUBSTATUS special
register.
If the received reply message is longer than the working-storage structure defined for it,
the message is available in the target working-storage data structure; however, it is
truncated to the length of the working-storage structure. In this case, TERMINATION-
SUBSTATUS contains a value greater than the length of the working-storage structure.
You can design your program to use a value of 11 for the TERMINATION-STATUS
special register to process variable-length replies, as described in the section that follows
this table. If you design your program to reject variable length replies, your ON
ERROR code should send a message to the terminal telling the operator what is
happening (such as BAD MESSAGE LENGTH, TERMINATING EXECUTION), and
then log an error record to an appropriate server and perform a STOP RUN statement.
The code in Table 10-1
indicates that the requester program is operating in transaction
mode (that is, within the bounds of a BEGIN-TRANSACTION and END-
TRANSACTION statement pair), but the server to which it is attempting to send data is
not configured for Compaq Transaction Management Facility (TMF) operation
(TMF OFF was specified in the applicable PATHCOM SET SERVER command).
Table 10-3. Requester SEND Errors for Configuration Problems
Numeric Value Meaning
7 Message too large
8 Maximum reply too large
Table 10-4. Requester SEND Error for Invalid Reply Length
Numeric Value Meaning
11 Invalid reply length