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

UPSUTIL for MPE/iX
UPSUTIL Commands
Chapter 32
241
For example, the first implemented UPS Monitor configuration command establishes the setting of how to
route ** RECOVERY FROM POWERFAIL ** messages, and it appears as follows in a UPS Monitor
configuration file:
powerfail_message_routing = all_terminals
-or-
powerfail_message_routing = console_only
6. Configuration parameter names and non-numeric configuration parameter values are alphanumeric
symbols, using the underscore character (_) to connect the parts of a multi-part name or value.
7. Configuration file contents are NOT case sensitive. Use upper and/or lower case text as you wish.
UPS Monitor Configuration Options
Here are the available configuration options (configuration “commands”) for UPS Monitor configuration files.
Powerfail Message Routing The powerfail message routing configuration option allows you to choose how
the UPS Monitor will handle its issuance of the HP e3000 system’s ** RECOVERY FROM POWERFAIL **
message, which is issued at the end of every power failure event — when AC power has returned to all UPSs
— to notify the system operator and (optionally) system users of the completion of a power failure cycle.
parameter name: powerfail_message_routing
parameter values:
(a) all_terminals
To send the notification message to the system console and to all user terminals.
(b) console_only
To send the notification message only to the system console. No notification messages are sent to any user
terminals.
Powerfail Command File The powerfail command file configuration option allows you to specify your own
MPE/iX Command File to be executed at a certain time (established by the powerfail grace period
configuration command, see below) following the UPS Monitor’s detection of a UPS AC power failure signal.
This configuration command is optional, and need not be included in the UPS Configuration file. If it is not
included, then no powerfail command file will be used by the UPS Monitor. In that case, the UPS Monitor will
only report UPS power fail occurrences to the system console and system log file, and will take no other
actions due to UPS power fail detection.
parameter name: powerfail_command_file
parameter values:
(a) file.group.account [; <parm1> <parm2> ... <parmN> ]
To cause UPS Monitor to utilize the named file (file.group.account) as an MPE/iX CI command file, to be
executed at powerfail grace period time following any UPS’s report of an incoming AC power failure.
The file name may optionally be followed by a semicolon and a list of parameters for the execution of the CI
command file. If the parameters are supplied in the “powerfail_command_file = xxx” configuration
command, then the parameters will be passed as-is to the MPE/iX CI at the time when the powerfail
command file is executed.
(b) $null
To specify that no powerfail command file is to be used.