APC Command Line Interface User Manual

Page of 39
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.