Communicator e3000 MPE/iX Release 7.5 (Software Release C.75.00) (30216-90336)

Chapter 5
Technical Articles
UPS Monitor/iX and UPSUTIL Enhancements
114
New UPS Monitor Configuration Options
The following new configuration options are made available by this enhancement. Each option requires one
new line in the UPS Monitor’s configuration file, either the default UPSCNFIG.PUB.SYS configuration file, or
another UPS Monitor configuration file that you have established via UPSUTIL’s Newconfig command.
Powerfail Command File
This option allows you to establish your own MPE/iX command file to be launched into execution by the UPS
Monitor whenever there is a UPS-device-detected AC power failure whose duration exceeds the time specified
as the “powerfail grace period” time.
The powerfail command file can be any valid MPE/iX CI command file within the “standard” MPE/iX file
system — i.e., it is a file with a file name of the form myfile.mygroup.myacct. Its content is not known to
and not restricted by the UPS Monitor/iX subsystem. UPS Monitor/iX simply passes this command file by
name to the MPE/iX CI (as a subordinate process of UPS Monitor/iX) whenever conditions for command file
execution are met.
The syntax for the powerfail command file option is:
powerfail_command_file = file.group.account [; parm1 parm2 … parmN]
or
powerfail_command_file = $null
The first format above specifies a particular file to be the powerfail command file. Parameters (parm1..
parmN) are optional; if they are specified, then they are passed to the MPE/iX CI “as is” at the time at which
the powerfail command file is launched into execution.
The second format simply states explicitly that no powerfail command file is to be used by UPS Monitor, and
is no different in its effect from not having any “powerfail_command_file = xxx” command in the UPS
Monitor configuration file at all.
Powerfail Grace Period Delay Time
This option establishes the amount of time (in seconds) that a UPS-detected AC power failure must endure
before the UPS Monitor begins to execute the user’s “powerfail command file”. The grace period allows an
amount of time to pass, to give AC power a chance to return, before causing any “powerfail command file”
actions to take place, so that short-duration power failures does not cause system shut downs (and/or
whatever other actions, such as aborting jobs and sessions, closing volume sets, etc., may be specified within
the user’s “powerfail command file”).
The permissible range of times for the “grace period” is from zero seconds (no time at all; begin to execute the
user’s “powerfail command file” immediately upon AC power failure detection) through a maximum of 1800
seconds (30 minutes), and is based on the nominal 15-minutes at full power load reserve capacity of the UPS
device’s battery pack.
The syntax for the powerfail grace period option is:
powerfail_grace_period = nnnn
where nnnn is the desired integer number of seconds of “grace period”, from 0 through 1800.
While it doesn’t really make sense to specify this configuration option unless there is a companion
specification of the “powerfail command file” option, there is no harm in doing so. If there is a configuration of
the “grace period time” but no specification of a powerfail command file, then the UPS Monitor takes no
action following the expiration of the “grace period” time … it may as well never have been specified.