UPS Utility Manual

2.5 UPSUTIL User Interface
2.5.1 Type of User Interface
The UPSUTIL user interface is a simple "line mode" command and response interface, suitable for use on direct-connected
user terminals and dial-up modem-connected remote user terminals with no
special hardware features required in the
terminal (e.g. no graphics capability is needed).
UPSUTIL sequentially prompts the user for the next command (using the UPSUTIL command prompt shown
at the
bottom of Figure 2-1), reads the user's command from the Input file, executes the
command, and displays the command's
results (including warning or error messages, if any) on the Output file.
2.5.2 UPSUTIL Commands Summary
The UPSUTIL commands are syntactically very simple: each command consists only of a single command-name keyword,
such as "start".
The UPSUTIL command set is summarized in the following table (Table 2-1).
Subsequent sections of this document explain
the commands in detail.
2.5.3 General Command Parser Errors
Since the UPSUTIL user interface for entering commands is very simple, there are only a few error conditions associated
with entering commands.
First, if a command keyword is simply mis-typed (misspelled), then UPSUTIL outputs the error message:
** ERROR: This command is not known to the UPSUTIL program, command ignored.
Second, if a command keyword contains an invalid character, such as a numeric digit or special punctuation character, then
UPSUTIL outputs the error message:
** ERROR: This command name is not legal, command ignored.
Third, if a command keyword is just too long to be valid, then UPSUTIL outputs the error message:
** ERROR: This command name is too long, command ignored.
Page
10
of
48
UPS Utility
7/18/2008
http://jazz.external.hp.com/papers/upsutil.htm