dump_events command line utility to extract events from the PEM log, convert them into ASCII format, and write them to a text file.
The dump_events utility does not access the PEM cache and thus does not extract the most recent events.
Every dumped event displays the following information by default:
The following example is an extract of
When you use dump_events, keep in mind the following limitations and guidelines:
circular-file-name.lock) in the
/$<PATROL_HOME>/logdirectory for UNIX and
<PATROL_HOME>\logdirectory for Windows.
The following table shows the directories used by the dump_events utility:
The dump_events utility directory structure
|UNIX||PATROL_HOME/log||The default location of the lock file, which must be non-NFS mounted.|
|UNIX||HOME/patrol||The default location of the ASCII file |
The PATROL environment must be set up prior to running dump_events. You must set the PATROL_HOME environment variable. The following table describes how to define this variable for UNIX and Windows:
PATROL_HOME environment variable
|Environment variable||For UNIX, run...|
|For Windows 2000 or later, select...|
|Start > Settings > Control Panel > System > Environment; type the variable name (PATROL_HOME), the value (the path), then click Set.|
|Start > Settings > Control Panel > System > Advance, and click Environment Variables. Click New and type the variable name (PATROL_HOME), the value (the path), then, click OK.|
To run dump_events, type the following command at the command line prompt and press Enter:
The dump_events utility has the following format:
The following table lists and defines the options for the dump_events command line utility:
Options for the dump_events command-line utility
This option provides the full name of the event log file (circular file) if different than the default.
This option provides the full name of the ASCII dump file if different than the default. The default is HOME/patrol/PEM_<host>_3181.txt. If you do not provide a directory, the default directory is used.
This option provides the directory name of the circular file lock. The default is PATROL_HOME/log for UNIX and PATROL_HOME\log for Windows. If you do not provide a directory, the default directory is used.
This option enables the event-dumping and can be used if a previous dump_events program was stopped.
This option provides a user-defined format for event dump. By default, the event manager uses the print format string equivalent to
Displays version information.
dump_events -m '%8$s %7$s %6$s %5$s %4$s %4$s %3$s %2$s %1$s\n'
Note the single quotes around the string format. This command dumps event fields in reverse order to the default, as follows:
dump_events -m '\t%s \t%s \t%s \t%s \t%s \t%s \t%s \t%s\n\n\n'
This command dumps fields in the default order, separated by tabs. Three new lines separate events.
If the dump_events utility fails, check the following items: