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

UPSUTIL for MPE/iX
UPSUTIL Commands
Chapter 32
240
to any user terminals. This configuration option is called the “powerfail message routing” option. In the
future, more configuration options may be added to the UPS Monitor configuration file facility, as the need
arises.
Revision of December 2001: Version 9: Additional Configuration Commands
The UPS Monitor has been enhanced to include more configuration options. The new configuration commands
pertain to establishing the UPS Monitor’s behavior in response to a UPS device’s signaling of an AC power
failure. The new commands allow the user (system manager) to specify his own custom MPE/iX Command
File to be executed a certain time (also user configurable) following a UPS power failure signal. In addition,
the UPS Monitor’s behavior in response to a UPS’s “low battery charge” signal is now configurable by the
user. (Prior to this enhancement, the UPS Monitor always performed an intentional “system abort” to protect
disk data in case of a UPS “low battery” signal.)
The new configuration commands are:
• powerfail_command_file = <filename>
• powerfail_grace_period = <number of seconds>
• powerfail_low_battery = <option>
where <option> is either “system_abort” or “keep_running”.
Syntax
newconfig
When you type in the NEWCONFIG command in response to the UPSUTIL > command prompt, UPSUTIL
will then prompt you to enter the name of your UPS Monitor configuration file that you want to activate.
UPS Monitor configuration files are discussed next.
Requirements for UPS Monitor Configuration Files
UPS Monitor configuration files handled by the NEWCONFIG command must adhere to the following
requirements of structure and placement:
1. ASCII text files of standard file structure (MPE file type STD).
These are simple, line-by-line, flat ASCII text files, of the most basic kind, as created by any of the HP
e3000 text editors.
2. The file resides in the standard MPE/iX file system, and hence the file’s name is of the form
“file.group.account”, according to standard file system naming rules.
POSIX-style HFS (hierarchical file system) files are NOT allowed.
3. Record size (line length) from 32 bytes to 128 bytes long.
Any record size within these limits is acceptable. EDITOR-style line numbered files are acceptable.
4. The first line (record) of the file must consist solely of the file’s file name.
This is a simple means of verifying that a file specified in a NEWCONFIG command is, in fact, a UPS
Monitor configuration file. It protects against accidentally using an incorrect file.
5. Subsequent lines (records) in the file contain UPS Monitor configuration information settings, and are of
the general form:
<configuration parameter name> = <configuration parameter value>