EMS Manual

Collector Event Messages
EMS Manual—426909-005
20-13
514: ZEMS-EVT-FILESWITCH
ZEMS-TKN-LCT-LOGTIME (nonshared) (G-series RVUs only)
contains the LCT (local civil time) logtime of the event.
Conditional Tokens
ZEMS-TKN-ACTION-NEEDED (nonshared)
tells whether some action is required (in this case, because the collector stopped
logging). The token value is FALSE because logging already resumed with a log-
file switch.
ZEMS-TKN-ACTION-ID (nonshared)
has the value 0. This token has the same value in the corresponding action-
attention message, ZEMS-EVT-LOGGING-STOPPED (521).
Cause. A log-file switch, either preplanned (through the ROTATEFILES option) or as
needed, was made by an operator or a management application.
The usual cause of this event is that the previous file was filled. Another cause might
be that the system operator requested a switch to a new log file or subvolume. These
causes are considered normal. No exceptional action is required of the operator,
except normal procedures to ensure that adequate disk capacity is available for
continued logging.
A third possible reason for this event is that the disk log file in use has become
inaccessible due to a disk I/O error, causing logging to be switched to the default log
subvolume. After the disk problem has been corrected, you can use the LOGSUBVOL
command of the EMSCCTRL program to return to the normal log subvolume.
Effect. None. The log-file switch has occurred. This message can be an action-
completion message for the event message ZEMS-EVT-LOGGING-STOPPED (521).
Recovery. This event message is an informative message only; no corrective action is
necessary.
Event Notes

The collector saves this event message as the only record in the ZZEVCONF files
and as the first record of each ZZEVnnnn file. This mechanism provides backward
links to all currently active log files. That is, ZZEVCONF points to log file x (the
current log file), the first record of log file x points to log file y (the previous log file),
and so forth.

When present, the ACTION-NEEDED and ACTION-ID tokens mean that this
FILESWITCH event message was the action-completion response to a LOGGING-
STOPPED message. These tokens were in the LOGGING-STOPPED message.
When the operator responded, logging resumed with a file switch, and the tokens
were passed to the FILESWITCH message.