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

UPSUTIL for MPE/iX
UPSUTIL Commands
Chapter 32
249
The Status Display
The status display produced by the STATUS command’s execution is shown in the above example and in
several additional examples that follow this explanation of the parts of the status display.
The status display has two main sections, titled UPS MONITOR PROCESS STATUS and UPS DEVICES
STATUS. The former section gives information about the UPS Monitor Subsystem Process, while the latter
gives information about each UPS device configured on the system.
The next subsections describe the component parts of the status display, explaining their purposes and
meanings. Refer to the examples as references while reading the following subsections, which first describe
the parts of UPS MONITOR PROCESS STATUS and then the parts of UPS DEVICES STATUS.
UPS Monitor Process Status Display
UPS Monitor Operating State This field of the status display shows the current operational state of the
UPS Monitor Process.
Possible values of this field are:
• Starting-Up — The UPS Monitor Process has been launched, and is in the process of acquiring the system
resources that it needs in order to run.
• Running — The UPS Monitor Process has started-up successfully, and is now running.
• Shutting-Down — The UPS Monitor Process is performing its shutdown processing in preparation for
process termination. The UPS Monitor Process shuts down for any of the following reasons: (a) A system
shutdown (“Control-A shutdown”) is occurring. (b) A user of UPSUTIL has commanded the UPS Monitor
to stop operation (via the STOP command) or to stop and then restart operation (via the RESTART
command). (c) The UPS Monitor process has detected a serious problem in its operation, and is either
shutting-down or restarting to try to correct the problem, or (in cases of “fatal error”) is just
shutting-down.
• Undefined — This state value is defined within the UPS Monitor Process, and it represents a
“pre-startup” state in which even the most basic data structures are not yet initialized. It should not ever
be possible to observe this operating state through the use of UPSUTIL’s STATUS command. The reason
for this is when the UPS Monitor Process is in this early “pre-start” state; it is not possible for UPSUTIL
to communicate with the UPS Monitor Process, to query it for its status.
UPS Monitor Version Number This field of the status display presents the “version number” of the UPS
Monitor Process that is executing. This is simply a software version identification number, to identify the
particular revision of the UPS Monitor software present on the system.
System Power State The System Power State status field shows the current condition of overall system
power as most recently observed by the UPS Monitor Process.
The following values are possible:
• Power is normal — As of the most recent observation, incoming AC power was detected as “normal” at
every UPS device being monitored. Overall, the system is in a “normal power” state.
• Power has failed — As of the most recent observation, incoming AC power was detected as “absent” or
“out of tolerance” at one or more of the UPS devices being monitored. Hence, one or more of the UPS
devices is/are providing “battery backup power” to the system (unless power has been absent for so long
that the UPS battery has been drained completely).