Pathway/iTS Management Programming Manual

Terminal Control Process (TCP) Commands
NonStop Pathway/iTS Management Programming Manual—426749-002
7-14
REFRESHCODE TCP
Tokens in Response Buffer
ZSPI-TKN-RETCODE
For REFRESHCODE TCP, a common error value for ZSPI-TKN-RETCODE is:
For descriptions of all error-token values and their associated error lists, see
Section 11, TCP Event Messages and Section 12, TCP Error Messages.
Considerations
•
The REFRESHCODE TCP command operates in conjunction with the
ZCHECKDIRECTORY field. When the ZCHECKDIRECTORY field has the value
ZPWY-VAL-OFF, the TCP reads the TCLPROG directory file during a SCREEN
COBOL CALL statement only if one of the following conditions exists:
•
The called program is not in the TCP code area.
•
The called program is in the TCP code area, but a REFRESHCODE TCP
command has been issued since the last time a call was made to the
referenced program unit.
•
If the ZCHECKDIRECTORY field has the value ZPWY-VAL-ON, the TCP always
checks the TCLPROG directory file for the latest program version when executing
a SCREEN COBOL CALL statement. Therefore, using the REFRESHCODE TCP
command when the ZCHECKDIRECTORY field is set to ZPWY-VAL-ON is a
redundant operation and the Pathway subsystem returns an error.
•
If a primary TCP fails and the ZCHECKDIRECTORY field has the value
ZPWY-VAL-OFF, the TCP automatically reads the TCLPROG directory file during
a SCREEN COBOL CALL statement before the backup TCP takes over. This
action occurs even if a REFRESHCODE TCP command is not issued.
Error
Number Error Token Description
1116 ZPWY-ERR-PM-
ALREADYREFRESHED
The ZCHECKDIRECTORY field in ZPWY-
MAP-DEF-TCP is set to ZPWY-VAL-ON.