TS/MP 2.5 System Management Manual

CONTROL PATHMON Command
Use the CONTROL PATHMON command to change specific attributes of the PATHMON process
while it is running and to record the changes in the PATHMON configuration file.
CONTROL PATHMON , pathmon-attribute [ , pathmon-attribute
]...
pathmon-attribute is:
BACKUPCPU number
DUMP { ON [ ( FILE file-name ) ] | OFF }
DUMPMEMORY (FILE file-name )
SPREBALANCECPU number
BACKUPCPU number
specifies the processor where the PATHMON backup process runs. The PATHMON process stops
the existing backup process and creates a new backup process in the processor that you specify.
DUMP {ON | OFF}
specifies whether the PATHMON process writes the data stack information to a file if it encounters
an internal error.
The default value is OFF.
ON
directs PATHMON to write the information in the data stack to a file and then to set this option to
OFF.
ON is the HP recommended setting. (The only reason not to set this attribute to ON is because of
the disk space required if large number of dumps occur.)
FILE file-name
specifies the name of the file that the PATHMON process creates for its dump operation.
If the NODEINDEPENDENT attribute of the SET PATHWAY command is set to ON and you do not
specify the node portion of file-name, the node name defaults to a generic node name, \*, that
designates whatever node the PATHMON process is running on after cool start.
If the NODEINDEPENDENT attribute of the SET PATHWAY command is set to OFF and you do not
specify the node portion of file-name, the node name defaults to the node the PATHMON process
is running on when you issue the CONTROL command
If you do not specify the volume and subvolume portions of file-name, the PATHMON process
creates a dump file on the same subvolume as the PATHMON configuration file.
The format of the file name is ZZPMnnn, where nnn is a 3-digit number. The file code is 130.
NOTE: file-name specifies a file that already exists and the PATHMON process attempts to dump
to this file, a dump is not performed and error *1123* PATHMON, MEMORY DUMP NOT TAKEN
is generated.
OFF
directs the PATHMON process not to write data stack to a file when it encounters an internal error.
DUMPMEMORY (FILE file-name)
Forces the PATHMON process to write the information in its data stack to a file.
Note that the DUMPMEMORY option is not a substitute for setting the DUMP option to ON. DUMPMEMORY
is primarily useful in a controlled troubleshooting situation where you need to take a snapshot of the
internal state of the PATHMON process at a particular time—before it encounters a fatal error. You
must force a dump only if your representative specifically requests it.
FILE file-name
specifies the name of the file that the PATHMON process creates for its dump operation.
If you do not specify file-name, the PATHMON process creates a dump file on the same subvolume
as the PATHMON configuration file. The format of the file name is ZZPMnnn, where nnn is a 3-digit
number. The file code is 130.
SPREBALANCECPU number
CONTROL PATHMON Command 151