Pathway/XM System Management Manual

PXMCOM Commands
Compaq NonStop™ Pathway/XM System Management Manual—426761-001
11-47
REFRESH-CODE TCP
Considerations
•
In production systems, use the REFRESH–CODE TCP command to add a new
version of a SCREEN COBOL program to the application.
•
The REFRESH-CODE TCP command operates in conjunction with the TCP
CHECK-DIRECTORY attribute. When the attribute is set to OFF, the TCP process
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 process code area.
•
The called program is in the TCP process code area, but a REFRESH-CODE
TCP command has been issued since the last time a call was made to the
referenced program unit.
•
If the TCP CHECK-DIRECTORY attribute is set to ON (ON is the default), the
TCP process always checks the TCLPROG directory file for the latest program
version when executing a SCREEN COBOL CALL statement.
In a development environment where the SCREEN COBOL programs are often
changed, you should set CHECK–DIRECTORY to ON.
In a production system, you should set CHECK–DIRECTORY to OFF and use the
REFRESH–CODE TCP command when SCREEN COBOL programs have
changed.
•
If a TCP primary process fails and the CHECK-DIRECTORY attribute for that TCP
is set to OFF, the TCP automatically reads the TCLPROG directory file during a
SCREEN COBOL CALL statement before the TCP backup process takes over. This
action occurs even if a REFRESH-CODE TCP command is not issued.
Examples
The following command modifies directory checking for the TCP process that manages
the terminal named TERM1:
REFRESH-CODE TCP TERM1
The following command modifies directory checking for all TCP processes in the
system:
REFRESH-CODE TCP *
The following command modifies directory checking for all TCP processes in the
RUNNING state:
REFRESH-CODE TCP *, STATE RUNNING
Note. The CHECK-DIRECTORY attribute affects the TCLPROG file at the TCP level
only; it has no effect on any TCLPROG file at the TERMINAL or PROGRAM level. In
other words, when this attribute is set to OFF, any TCLPROG file at the TERMINAL or
PROGRAM level is still checked.