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

UPSUTIL for MPE/iX
UPSUTIL Commands
Chapter 32
262
RESETPFAIL Command
The RESETPFAIL command is for the purpose of clearing-out from the UPS Monitor’s status display the
information pertaining to past completions of the “Powerfail Grace Period Timer” and “Powerfail Command
File”.
When there has been a UPS AC power failure signaled, and the user has configured the Powerfail Grace
Period time, and the power failure has lasted longer than the grace period time, then the STATUS display will
show that the state of the Grace Period Timer is “Completed”, and will also show the date and time of
completion.
Similarly, if the user has configured a Powerfail Command File, and there has been a UPS power failure
exceeding the grace period time, then the powerfail command file will have been executed. The STATUS
display will then show the state of the Powerfail Command File as “Completed”, and will also show the
completion date and time.
The “Completed” states and the completion dates and times for both the Powerfail Grace Period timer and the
Powerfail Command File will be retained in UPS Monitor status until either:
1. The UPS Monitor is re-started, or
2. The RESETPFAIL command of UPSUTIL is used to clear this information.
The RESETPFAIL command will cause the state displays for Powerfail Grace Period timer and Powerfail
Command File to revert from “Completed” to “Not Running”, and will erase the completion dates and times
for the Powerfail Grace Period timer and Powerfail Command File.
The example below shows an observation of UPS Monitor status following a UPS power failure that caused
expiration of the Grace Period Timer and an execution of the Powerfail Command File, followed by a usage of
the RESETPFAIL command, and then another status display. You can see from this example how the
powerfail status information gets cleared by the RESETPFAIL command.
Syntax
resetpfail
Example
--------------------------------------------------------------------
UPSUTIL: Command > status
----------------------------------------------------------------------------
Begin display of UPS Monitor status.
UPS MONITOR PROCESS STATUS:
UPS Monitor Operating State : Running (PIN = 196)
UPS Monitor Version Number : 9 3 UPS Devices Configured
System Power State : Power is normal. 3 UPS Devices Monitored
Powerfail Recovery Messages : All terminals. 3 UPS Devices Allocated
Configuration File Name : UPSCNFIG.PUB.SYS (Config File Ok)
Powerfail Command File Name : MYPFAIL.PUB.MYACCT (Pfail Cmd File Ok)
Powerfail Command File Parms: [inventory_data_set orders_data_set]
Powerfail Grace Period (secs: 300