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

UPSUTIL for MPE/iX
UPSUTIL Commands
Chapter 32
243
The Default UPS Monitor Configuration File
You can still control the UPS Monitor with a configuration file even if you never use UPSUTIL’s
NEWCONFIG command. This is because the UPS Monitor (Version 8 of March 2000, or later version)
automatically attempts to open and read a default UPS Monitor configuration file, named
UPSCNFIG.PUB.SYS, at each system startup (each system boot).
Therefore, after installing Version 8 (or later) of the UPS Monitor software on your system, you need only use
your favorite editor to create a UPSCNFIG.PUB.SYS text file and then re-boot the system. From this point on,
the file UPSCNFIG.PUB.SYS will govern your system’s UPS Monitor’s configurable behavior. The file
UPSCNFIG.PUB.SYS will be read by and acted upon by the UPS Monitor during every system startup, and also
(should you choose to use this facility) every time the UPS Monitor is started by using the UPSUTIL START
command.
NOTE The UPSUTIL START command causes a fresh-from-scratch startup of the UPS Monitor
(when it is not already running). Hence, a START will cause UPS Monitor to read the default
configuration file UPSCNFIG.PUB.SYS.
The UPSUTIL RESTART command causes a re-initializing restart of the UPS Monitor, when it
is already running. In this case, UPS Monitor will remember the file name of the most recently
active configuration file, and will re-process that same file during the restart.
Here are some examples of valid UPSCNFIG.PUB.SYS configuration files for use by the UPS Monitor:
(a) To send ** RECOVERY FROM POWERFAIL ** messages to the system console and to all logged-on user
terminals, which is the traditional method:
upscnfig.pub.sys
powerfail_message_routing = all_terminals
(b) to send the recovery messages ONLY to the system console:
upscnfig.pub.sys
powerfail_message_routing = console_only
(c) to send the recovery messages only to the system console, and to cause the user-defined command file
MYPFAIL.PUB.MYACCT to be executed starting 10 minutes (600 seconds) after a UPS signals “power failure”,
and to cause the UPS Monitor to perform its intentional system abort in case a UPS device signals a “low
battery” condition:
upscnfig.pub.sys
powerfail_message_routing = console_only
powerfail_command_file = mypfail.pub.myacct
powerfail_grace_period = 600
powerfail_low_battery = system_abort
If No UPSCNFIG.PUB.SYS File Exists
UPSCNFIG.PUB.SYS is the default UPS Monitor configuration file, to be used unless/until you use UPSUTIL’s
NEWCONFIG command to choose a different configuration file.
The UPS Monitor’s final default, in case there is no UPSCNFIG.PUB.SYS default configuration file on the
system, is to assume case (a) above: The powerfail messages routing option will be assumed to be “to all
terminals”, the same as it has been in the past. Also, there will be no “powerfail command file” configured