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

Terminal Control Process (TCP) Commands
HP NonStop Pathway/iTS System Management Manual—426748-002
9-22
SET TCP Command
ON
directs the TCP to create one or more disk files and write the contents of its
data stack and its extended data segment to these files.
After creating 10 primary process and 10 backup process dump files, the TCP
stops performing memory dumps. This prevents writing over existing dump
files that may indicate the original cause of a problem, and prevents filling a
disk with dump files.
FILE file-name
specifies the name of the file that the TCP creates for its dump operation. The
format of the file name can be any of the following:
$volume.subvolume
$volume.subvolume.ZZ
$volume.subvolume.filename
For example, the following file name directs the TCP to create the appropriate
ZZTCPnnP or ZZTCPnnB file on volume $DATA using subvolume
TCP05DMP:
(FILE $DATA.TCP05DMP)
(FILE $DATA.TCP05DMP.ZZ)
The following unique name for file-name, directs the primary TCP to name
its dump file TCP05P and directs the backup TCP to name its dump file
TCP05B:
(FILE $DATA.PWAYDMPS.TCP05)
Both the primary and backup dump files are created on volume $DATA using
subvolume PWAYDMPS. The P (primary TCP dump) and B (backup TCP
dump) characters replace the last character of an eight-character name, or are
appended to the end of a shorter dump file name. If the dump file already
exists when the dump operation occurs, the TCPs reuse the existing file by
purging the file’s information and writing the latest memory dump.
If you do not specify a node name, the default node for file-name expansion
can be affected by several factors, including values you specify for the
NonStop TS/MP CMDVOL command and the NODEINDEPENDENT attribute
of the TS/MP SET PATHWAY command. For details, see Specifying Node
Independence on page 2-5.
If a file error interferes with creating a file that you specify, the TCP creates the
dump file on the same subvolume as its program object file and uses the form
ZZTCPnnx for the file name.
If you do not specify file-name, the TCP creates its dump file on the same
volume and subvolume as the PATHMON configuration file. The format of the
file names are ZZTCPnnP and ZZTCPnnB, where nn is a number from 01 to
10, and P and B indicate the primary or the backup process, respectively, that
the TCP dumped.