APC Command Line Interface - Manual (Page 7)

Command Line Interface (CLI) User’s Guide 3
Using the Commands
How to Enter CLI Commands
Capitalization in commands and arguments
Commands are valid in lowercase, uppercase, or
mixed case, but arguments are case-sensitive
unless specified otherwise.
Editing in the CLI
The B ACK S PACE
key deletes the most recently
entered character of the current command string.
No other editing function is available during
command entry.
The CLI does not retain a command history. You
cannot retrieve previously entered commands.
The Space character as command delimiter
The CLI uses one Space character (ASCII 0x20) as
the delimiter between commands and arguments;
extra Space characters are ignored.
Quotation marks and the reverse slant
Use quotation marks (ASCII 0x22) and the reverse
slant (\: decimal code 92) as follows:
• For both input and output, enclose in quotation
marks any string value that begins or ends with
spaces or contain commas or semicolons.
• Do not use traditional escape sequences (the
reverse slant followed by a lowercase
alphabetic character or by one or more
numeric characters) preceding special
characters within strings. The CLI does not
recognize such escape sequences, and the
resulting error causes the entire keyword and
value pair to be ignored.
• If an argument value contains a quotation mark
or reverse slant, it must be preceded by a
reverse slant only as its escape character. For
example, this command adds the user
"John
Doe"
to the local database:
adduser \"John Doe"
• If an input string contains a quotation mark or
reverse slant, enclose the string in quotation
marks. For example, this command adds the
user
pdu\\device
to the local database:
adduser "pdu\\device user"
• Optionally, you can use quotation marks to
enclose any argument value.