UPS Utility Manual
2 UPSUTIL OVERVIEW
2.1 Functional Overview
Through a very simple "command keyword" user interface, the UPSUTIL program provides the
following functions
pertaining to the management of UPS devices and the UPS Monitor/iX subsystem on
HP3000 systems running MPE/iX
Release 5.0 "Push" or later releases:
1) A configuration query function that obtains and displays the list of UPS Ldevs (logical devices) that are in
the I/O configuration of the system that is running.
2) A status query function that obtains and displays the current status of the UPS Monitor/iX subsystem
process (running or not running; power normal or power failed; number of UPS devices being monitored)
and of each of the configured UPS devices (Ldev number, allocated/not allocated, initialized/not initialized,
operational state, power condition, and UPS hardware status).
3) A control function that halts the UPS Monitor/iX subsystem process, if it is currently running.
4) A control function that starts the UPS Monitor/iX subsystem process, if it is not currently running.
5) A control function that restarts (stops, then immediately starts) the UPS Monitor/iX subsystem process, if it
is currently running.
6) A configuration function that selects a new user-defined configuration file to be used by the UPS Monitor
subsystem.
7)
A control function that resets (clears) the UPS Monitor's information pertaining to the previous execution
(if any) of a UPS powerfail "grace period" timeout and a UPS powerfail "user command file".
In addition, UPSUTIL has two other functions that pertain to the operation of UPSUTIL itself:
1) A "help" function that displays the menu of UPSUTIL's commands.
2)
An "exit" function that ends UPSUTIL program execution.
2.2 Product Invocation and Security
Like any MPE/iX program, UPSUTIL is activated by being ":run" from the Command Interpreter in a job or in a session.
However, because the user of UPSUTIL can affect the operation of the system's UPS Monitor Process, there are security
restrictions on running the UPSUTIL program.
UPSUTIL should not be accessible to ordinary system users because of UPSUTIL's ability to affect
execution of the
system's UPS Monitor Process. Therefore UPSUTIL has been implemented as a Privileged-
Mode Program, and is limited in
accessibility to privileged system users, such as System Managers and HP Service Personnel.
Page
6
of
48
UPS Utility
7/18/2008
http://jazz.external.hp.com/papers/upsutil.htm