~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
UPSUTIL for
MPE/iX
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
User's Manual
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
HP
Commercial Systems Division
Location Code: 47-3448
Project Number: 1.0
February 19, 2002
Bob Berliner
Copyright @ 2002 HEWLETT-PACKARD
1 INTRODUCTION........................... 5
1.1 Intended Users............ 5
1.2 Product Environment 6
1.2.1 Hardware
Environment.................. 6
1.2.2 Software
Environment.................. 6
1.3 Product Structure...... 6
2 UPSUTIL OVERVIEW...... 7
2.1 Functional Overview...... 7
2.2 Product Invocation
and Security........ 7
2.3 Use of Files.............. 9
2.4 Product Restrictions
& Limitations... 9
2.4.1 Batch Mode
Limitations 9
2.4.2 Language
Localization Limitation 10
2.5 UPSUTIL User
Interface..................... 11
2.5.1 Type of User
Interface 11
2.5.2 UPSUTIL Commands
Summary 11
2.5.3 General Command
Parser Errors................ 11
3 UPSUTIL Commands..... 13
3.1 HELP Command... 14
3.2 EXIT Command... 15
3.3 CONFIG Command... 16
3.4 NEWCONFIG Command... 18
3.4.1 Requirements for UPS
Monitor Configuration Files.... 19
3.4.2 UPS Monitor
Configuration Options 20
3.4.2.1 Powerfail Message
Routing 20
3.4.2.2 Powerfail Command
File..... 20
3.4.2.3 Powerfail Grace
Period 21
3.4.2.4 Powerfail Low
Battery 21
3.4.3 The Default UPS
Monitor Configuration File...... 22
3.4.4 If No
UPSCNFIG.PUB.SYS File Exists...... 23
3.4.5 Observing Results of
NEWCONFIG Command................ 23
3.5 STATUS Command... 27
3.5.1 The Status Display.. 28
3.5.2 UPS Monitor Process
Status Display.. 28
3.5.2.1 UPS Monitor
Operating State... 28
3.5.2.2 UPS Monitor
Version Number 28
3.5.2.3 System Power State... 29
3.5.2.4 Powerfail Recovery
Messages............ 29
3.5.2.5 Configuration File
Name.. 29
3.5.2.6 Powerfail Command
File Name............ 30
3.5.2.7 Powerfail Command
File Parms............ 30
3.5.2.8 Powerfail Grace
Period 30
3.5.2.9 Powerfail Grace
Timer.. 30
3.5.2.10 Powerfail Command
File..... 31
3.5.2.11 Action on UPS Low
Battery 31
3.5.2.12 Pin...... 32
3.5.2.13 UPS Devices
Configured......... 32
3.5.2.14 UPS Devices
Monitored......... 32
3.5.2.15 UPS Devices
Allocated............ 32
3.5.3 UPS Devices Status
Display.. 33
3.5.3.1 UPS #. 33
3.5.3.2 LDEV # 33
3.5.3.3 Alloc (Allocated
Indicator)............ 33
3.5.3.4 Init (Initialized
Indicator)............ 33
3.5.3.5 State... 34
3.5.3.6 Power. 34
3.5.3.7 Hardware Status