MPE/iX System Utilities Reference Manual (32650-90908)

UPSUTIL for MPE/iX
UPSUTIL Commands
Chapter 32
250
Powerfail Recovery Messages This field shows the current setting of the UPS Monitor’s configuration
option for handling ** RECOVERY FROM POWERFAIL ** messages. This setting is established when the UPS
Monitor processes its configuration file, either during system startup (using UPSCNFIG.PUB.SYS) or, when the
system is up, via the NEWCONFIG command of the UPSUTIL program.
Possible values of this field are:
• All terminals — ** RECOVERY FROM POWERFAIL ** messages will be sent to the system console and to all
logged-on user terminals. (This is the traditional behavior for HP e3000 systems.)
• Console only — Recovery messages will be sent ONLY to the system console; no powerfail messages will
be sent to user terminals.
Configuration File Name This field shows the file name of the currently active UPS Monitor configuration
file, and is followed by a status indication field that reads either (Config File OK) or (** Config File Has
Error **).
Note that this field always shows the file name of the most recent UPS Monitor configuration file to have been
processed by the UPS Monitor, regardless of whether that processing was successful (no errors in
configuration file) or not (configuration file has some error(s)).
If a configuration file does contain some error(s) and then the UPS Monitor reports the error to the system
console, then ignores the configuration file record containing the error. This means that whatever
configuration attribute (e.g., powerfail_message_routing) was supposedly being set in that configuration
file record will not be set to a new value. Instead, UPS Monitor will simply retain the original value of the
configuration attribute. Therefore, if the status display shows (** Config File Has Error **), then the
actual values of configuration attributes that are shown in the status display do not “belong” to that
configuration file. Instead, they are the prior values, being retained by UPS Monitor.
Powerfail Command File Name This field shows the file name of the currently active UPS Monitor
powerfail command file, if any, and is followed by a status indication field that reads either (Pfail Cmd File
OK) or (** Command File Has Error **).
Note that this field always shows the file name of the most recent UPS Monitor powerfail command file to
have been set up by the UPS Monitor, regardless of whether that command file was set up correctly or not.
The UPS Monitor attempts to “set up” (or establish) a powerfail command file when it encounters a
“powerfail_command_file = <filename>” configuration command while processing a UPS Monitor
configuration file. When it does so, the UPS Monitor performs only a very basic error check on the powerfail
command file: it simply checks to determine if the named file exists and can be opened for reading. If so, then
the UPS Monitor establishes that file to be the powerfail command file, with no errors indicated. If not, then
the UPS Monitor will flag the named powerfail command file as “has errors”, and will NOT attempt to
execute that file in case of a UPS power failure that exceeds the “grace period” time.
Powerfail Command File Parms This field shows the parameters, if there were any, specified for use by
the powerfail command file. These parameters may be specified in the “powerfail_command_file =
filename; parameters...” configuration command in the UPS configuration file.
Powerfail Grace Period This field shows the current “powerfail grace period”, in seconds, as established by
the most recent processing of the UPS configuration file.
The powerfail grace period is the amount of time, in seconds, that must elapse following the UPS Monitor’s
detection of a “power fail” signal from a UPS device before the UPS Monitor will commence the execution of
the user's specified “powerfail command file”.
Thus, the grace period gives a chance of a certain amount of time in which the incoming AC power may come
back on and restore normal system operation (a recovery from the power failure), so that the UPS Monitor
will not begin to execute the user’s power failure command file.