UPS Utility Manual

When it does so, the UPS Monitor performs only a very basic error check on the powerfail command file:
it simply checks
to determine if the named file exists and can be opened for reading. If so, then the UPS Monitor establishes
that file to be
the powerfail command file, with no errors indicated. If not, then the UPS Monitor will flag
the named powerfail command
file as "has errors", and will NOT attempt to execute that file in case of a
UPS power failure that exceeds the "grace
period" time.
3.5.2.7 Powerfail Command File Parms
This field shows the parameters, if there were any, specified for use by the powerfail command file. These parameters
may be specified in the "powerfail_command_file = filename; parameters ..."
configuration command in the UPS
configuration file.
3.5.2.8 Powerfail Grace Period
This field shows the current "powerfail grace period",
in seconds, as established by the most recent processing of the UPS
configuration file.
The powerfail grace period is the amount of time, in seconds, that must elapse following the UPS Monitor's detection
of a
"power fail" signal from a UPS device before the UPS Monitor will commence the execution
of the user's specified
"powerfail command file".
Thus, the grace period gives a chance of a certain amount of time in which the incoming AC power may come
back on
and restore
normal system operation (a recovery from the power failure), so that the UPS Monitor will not begin to execute
the user's power failure command file.
3.5.2.9 Powerfail Grace Timer
This field shows the current state of the UPS Monitor's "powerfail grace period timer", which measures the amount of time
(powerfail grace period) from the time
of the onset of a UPS device power failure until the time when the power fail
command file begins to be executed.
Possible values of this field are:
o
Not Running
- The grace period timer is dormant.
There is no UPS power failure in progress, so no grace period time is
being measured.
o Running
- The grace period timer is active, measuring out the grace period time for an in-progress UPS power failure.
o
Completed
- The grace period timer has run to completion. If the UPS AC power failure is still in progress (power has
not returned to the UPS device), and a user-defined "powerfail command file" has been established, then that
command file
will have started its execution. (It could have completed its execution by the time this status display has
been
observed.)
If the timer state is "Completed", then date and time of the timer completion
will be shown in the status display to the right
of this field. The state of "Completed" and the completion
date and time will be maintained in the status display until either
the UPS Monitor is re-started, or until the user invokes UPSUTIL's RESETPFAIL command to clear-
out the information
regarding the powerfail grace period timer completion.
When UPS Monitor is restarted, or when the RESETPFAIL command is given in UPSUTIL, then the
powerfail grace
timer field of the status display reverts back to "Not Running", and the date and
time of the last timer completion are
erased.
Page
29
of
48
UPS Utility
7/18/2008
http://jazz.external.hp.com/papers/upsutil.htm