EMS Manual

EMS Programs
EMS Manual—426909-005
13-13
EMSCCTRL—Control Collector Utility
LOGUSERID usergroup.username
specifies the user ID that the primary collector uses when it accesses its
log files.
The primary collector uses the super ID to access log files if you have
never changed its user ID. If you change the user ID of the primary
collector, use LOGUSERID to change the owner and/or security of the
ZZEVCONF and log files so the new user ID has read/write/purge access
to these files. If the new user ID does not have read/write/purge access to
these files, $0 reports error 48 the next time it needs to open these files,
and stops logging to disk. To fix this, use LOGUSERID or change the
owner and/or security of the log files.
The alternate collector does not support the EMSCCTRL LOGUSERID
option. If specified for the alternate collector, EMSCCTRL responds with
this error message:
Control Command Failed, RetCode Error = 1005,
Invalid token value
MAXFILE nnnn
limits the number of log files that can exist at one time in the volume and
subvolume specified by LOGSUBVOL. nnnn must be in the range 2 to
1000 (decimal); leading zeros are not required. The default maximum is 4 if
you omit the parameter value or the entire parameter.
NEXTLOGFILE
if present, tells the collector to close the current log file, create a new one,
and open it. The collector then generates a fileswitch event message
and resumes event-message logging with the new file.
Note. You can reset MAXFILE to a value less than the actual number of log files
existing when the MAXFILE command is issued. The primary and alternate
collectors use the new value of MAXFILE to determine the action taken when the
current log file fills or a NEXTLOGFILE command is issued. Both collectors
assume that only MAXFILE files exist, ignoring the older files.
For example, if ROTATEFILES is ON and a NEXTLOGFILE command is issued,
the primary collector purges a single file (currentfile + 1 - MAXFILE). It
then creates a new file (currentfile + 1). The remaining older files, if any,
remain in the system until you purge them. To illustrate, assume that MAXFILE is
reset to 2 and there are three existing log files; file4, file5, and file6. When
a NEXTLOGFILE command is issued, file5 is purged, and file7 is created
(assuming ROTATEFILES is ON). file4 remains untouched.