UPS Utility Manual

3.4 NEWCONFIG Command
The NEWCONFIG command causes UPSUTIL to instruct the UPS Monitor subsystem to begin
using a new UPS Monitor
configuration file, specified by the user in the NEWCONFIG command. (The NEWCONFIG command executor
prompts
the user to enter the file name of the desired new UPS Monitor configuration file.)
A UPS Monitor configuration file is a simple ASCII line-oriented text file that the user can create with a text editor.
The file
contains a set of UPS Monitor configuration commands which establish various operating characteristics or op- tions in the
UPS Monitor. In its first implementation
(March 2000) the NEWCONFIG configuration file permits only one kind of
UPS Monitor configuration option to be set: namely, the option to have the UPS Monitor's "** RECOVERY FROM
POWERFAIL **" messages either routed to the system console and to all logged-on user terminals,
or to have those
messages sent only to the system console, and not 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 disc 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.
Page
17
of
48
UPS Utility
7/18/2008
http://jazz.external.hp.com/papers/upsutil.htm