EMS Manual

Configuring EMS
EMS Manual—426909-005
12-8
Log Files
by the collector. For instance, if MAXFILE is 4 (the default), the files at a given time
might be ZZEV0007, ZZEV0008, ZZEV0009, and ZZEV0010. File ZZEV0010 would be
the active file.
Allowable values for MAXFILE are 2 through 1000. This attribute value is saved in
ZZEVCONF. To change the value of this attribute, issue the SPI CONTROL command
or run the EMSCCTRL program.
Under certain conditions, the number of log files in the log subvolume might appear in
the output of the FILEINFO command, at MAXFILES + 1. Conditions causing
MAXFILES + 1 start with the no log switch delay feature, in which the steps associated
with purging the old log file and preallocating the next are executed as low priority
subtasks within the primary collector, scheduled when there is no event activity (no
events to be logged). When a log switch occurs, the collector schedules a task to
purge the old log file and then preallocate the next. If you execute a FILEINFO
command in the log subvolume you see one extra file: the old log waiting to be purged,
or the next log that has been preallocated (depending on the timing). At this point, the
number of files in the log subvolume has increased by one to MAXFILES + 1.
NEXTLOGFILE
When you use the CONTROL command to set the value of this attribute to TRUE, the
collector immediately closes its current log file, creates the next sequential log file,
opens that file, sends a message to the log file indicating that the log switch has
occurred, and then continues logging to the new file. The collector then sets the value
of NEXTLOGFILE to FALSE. If setting NEXTLOGFILE to TRUE causes MAXFILE to
be exceeded, the value of ROTATEFILES determines the action taken. (For more
information about the MAXFILE-exceeded condition, see ROTATEFILES on
page 12-9.) To change the value of this attribute, issue the SPI CONTROL command
or run the EMSCCTRL program.
POOLPAGES (Alternate Collector only)
This attribute determines the number of memory pages (1 page = 2048 bytes) the
alternate collector uses for event buffering. Values in the range 20 through 128 are
allowed. This attribute is not saved in the ZZEVCONF file. If POOLPAGES is not
specified as a RUN command parameter, 64 pages is used. The POOLPAGES
attribute cannot be changed once the collector is running.
PRIMARYEXTENT
This attribute establishes the value for the primary extent size (number of pages) used
when a primary or alternate collector creates a log file. Even-numbered values in the
range 2 through 65534 are allowed. This attribute setting is saved in the ZZEVCONF
file. This attribute has a default value of 20. To change the value of this attribute, issue
the SPI CONTROL command or run the EMSCCTRL program.