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

UPSUTIL for MPE/iX
UPSUTIL OVERVIEW
Chapter 32
233
UPSUTIL OVERVIEW
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 HP e3000
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” functions that ends UPSUTIL program execution.
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.
Security to prevent unauthorized access to the UPSUTIL program is provided by two factors:
1. UPSUTIL is a “Privileged Mode” program. This requires that, in order to run, it reside in a file
group.account that has the PM capability associated with both the group and the account.
2. UPSUTIL requires that its user have “System Manager” (SM) capability in order to be able to run the
UPSUTIL program. Users without SM capability can not run UPSUTIL.
To invoke UPSUTIL from an interactive session, type “run upsutil.mpexl.telesup” at the CI prompt, as
shown in the following example:
:run upsutil.mpexl.telesup