Pathway/iTS System Management Manual (G06.24+)

Terminal Control Process (TCP) Commands
HP NonStop Pathway/iTS System Management Manual—426748-002
9-15
REFRESH-CODE TCP Command
TCP *
modifies the directory-checking operations of all TCPs running in this PATHMON
environment. If STATE is specified, modifies all TCPs meeting the criteria
specified.
STATE state-type
specifies the state of multiple TCPs. Possible values are:
PENDING NOT PENDING
RUNNING NOT RUNNING
STOPPED NOT STOPPED
This command modifies directory-checking operations only for those TCPs in the
RUNNING state. If you specify any other state, the system redisplays the
command prompt; it does not display any output or generate an error message.
You can substitute SEL for STATE.
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 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 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
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, having the TCP always check the TCLPROG directory file is good
practice.
In a production system, it is recommended for performance reasons that you set
CHECK–DIRECTORY to OFF and use the REFRESH–CODE TCP command
when SCREEN COBOL programs have changed.
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.