ACC Utilities Reference Guide

ZSCAN - Display ZCOM Tables & Buffers
Running ZSCAN
Chapter 5132
Usage: zscan [options] [-m mfile] [-i ifile] [-k kfile]
Options:
-c Memory image file is a system core file
mfile Message text file (standard default)
ifile Memory image file (default: /dev/zmon - running system)
kfile Kernel file: required if -c specified (default:
/stand/vmunix)
Normal use of ZSCAN is with no parameters on the runstring, so it
defaults to the running system, default message file
(/opt/acc/msg/default.msg) and non-core file mode. You would not
normally need to specify the -m parameter, but it may be useful for
certain testing.
The ifile parameter is the memory image file which ZSCAN reads to
display the table information. It defaults to /dev/zmon, which is the
device file to access the running system. ZSCAN can use a snapshot of
the system, by copying /dev/zmon to a regular file and running ZSCAN
with the snapshot file as ifile. You can also specify a core file as ifile,
together with the -c option. If you are running against a core file, ZSCAN
needs to get some information (such as the location of the zcom kernel
memory tables) out of the kernel file.
When -c option is used, the -k option is used to specified the HP-UX
kernel file. If you don’t specify the kfile, ZSCAN uses a default value,
depending on the OS (/hp-ux for 9.xx, /stand/vmunix for 10.xx or later).
Note that ZSCAN does not accept a command file as runstring input. But
if you wanted command input from a file, you should use:
zscan options <commands_file>
The file used must have “ex” as the last command.
Some examples of running ZSCAN:
To run interactively against the running system:
% zscan
To get a snapshot and run zscan with it:
% cp /dev/zmon /tmp/zcom.memory
% zscan -i /tmp/zcom.memory