User manual

US 8,510,424 B2
21
must be used. To allow a user to use the SHOW command the
SET SHOW command must be used.
The ADD PORT command is used to allow a usemame to
access a port in the power manager Board chain. The speci?ed
port name gives access to both the power module and the
communications port referenced by the port name. The com
mand can be entered with no parameters, with a single param
eter (which is a usemame) or with two parameters (which are
usemame followed by the port name). If a parameter is not
speci?ed, a user is prompted ?rst for a user name with the
“Username:” message followed by a prompt for the port name
with the following prompt: “port Name:”. If a user does not
specify a valid usemame in response to the “Username:”
prompt, the command aborts with the following message:
“Sorry, a username a user has entered is NOT valid!”. A
non-blank port name must be entered after the “Port Name:”
or the command is aborted with the following message:
“Sorry, the port name a user has entered is NOT valid!”. The
same message is produced if the power manager does not
recognize the port name. If a user enters a single parameter,
the port name prompt occurs. If a user speci?es both a user
name and port name parameters there is no prompting. The
appropriate error messages are issued and the command
aborted if either a username or port name is invalid, regardless
if the value is speci?ed as a parameter on the command line or
is entered in response to a prompt. If the command completes
successfully, the following message is displayed: “Access to
PORTNAME is granted to USERNAME”. In this message
PORTNAME is replaced by the speci?ed port name and
USERNAME is replaced by the speci?ed username.
The PORTNAME speci?ed in this command can be an
absolute port name, a user created port name, or a group port
name.
The ADD SNAME command is used to add a new name to
a serial port in a power manager chain. The command can be
entered with no parameters, with a single parameter (which is
the serial port IDiidenti?es which port is to be named) or
with two parameters (which are the serial port ID followed by
the serial port name). If a parameter is not speci?ed, a user is
prompted ?rst for the serial port ID with the “Serial Port ID:”
message followed by a prompt for the serial port name with
the following prompt: “Name:”. If a user does not specify a
valid serial port name in response to the “Name:” prompt, the
command aborts with the following message: “The serial port
name a user has entered is NOT valid!”. Valid serial port
names are from 1 to 16 characters with blanks not allowed.
In response to the “Serial Port ID:” prompt, a user may
enter either a number from 1 to 16 (to specify one of the 16
possible ports connected at the end of the chain), or a two
character pass through port identi?er that begins with a letter
and is followed by a number from 1 to 4. The parameter is
veri?ed to ensure the serial port exists and that the serial port
is not already named. If the speci?ed serial port is already
named, it must ?rst be deleted using the DEL command and
then added.
Regarding “DEL {USERI PORTl SNAME}
[Usemamel Serial Port NAME] [Port Name]”, the DEL com
mand is used to delete usemames from the system, to delete
Serial Port Names, and to delete access to ports for a speci?c
usemame. The DEL command takes one required parameter
and up to two optional parameters.
The ?rst parameter is required and indicates whether a
usemame is to be deleted (DEL USER) or whetherport access
is to be removed from a user (DEL PORT), or whether a Serial
Port Name is to be deleted (DEL SNAME).
The DEL USER command is used to remove a usemame
from the system. The command can be entered with a single
20
25
30
35
40
45
50
55
60
65
22
parameter (which is a username to remove) or with no param
eters. If a parameter is not speci?ed, a user is prompted for a
usemame with the following prompt: “Usemame:”. A valid
system usemame must be entered at this prompt or the com
mand is aborted with the following message: “Sorry, a user
name a user has entered is NOT valid!”. This command can
not be used to remove any of the three default usernames (e. g.,
admn, genl, or gen2).
When the DEL USER command completes successfully, a
user receives “Username successfully deleted”. A successful
DEL USER command causes access to all ports for the speci
?ed user to be removed.
The DEL PORT command is used to remove access for a
usemame to a port in the power manager Board chain. The
command can be entered with no parameters, with a single
parameter (which is a usemame) or with two parameters
(which are username followed by the port name or by the
keyword “ALL” to indicate access to all ports should be
removed). If a parameter is not speci?ed, a user is prompted
?rst for a user name with the “Username:” message followed
by a prompt for the port name with the following prompt:
“Port Name:”. If a user does not specify a valid username in
response to the “Username:” prompt, the command aborts
with the following message: “Sorry, a usemame a user has
entered is NOT valid!”. A valid port name must be entered
after the “Port Name:” or the command is aborted with the
following message: “Sorry, the port name a user has entered
is NOT valid!”. A user may enter the keyword “ALL” in
response to the “Port Name:” prompt, in which case access to
all ports for this usemame is removed. If a user enters a single
parameter, the port name prompt occurs. If a user speci?es
both a usemame and port name parameters there is no
prompting. The appropriate error messages are issued and the
command aborted if either a username orport name is invalid,
regardless if the value is speci?ed as a parameter on the
command line or is entered in response to a prompt. If the
command completes successfully, the following message is
displayed: “Access to PORTNAME is denied to USER
NAME”. In this message PORTNAME is replaced by the
speci?ed port name (or the keyword “ALL”) and USER
NAME is replaced by the speci?ed username. Note that
access for the administrator cannot be removed.
The DEL SNAME command is used to remove a serial port
name. The command can be entered with no parameters, or
with a single parameter (which is the serial port name). If a
parameter is not speci?ed, a user is prompted ?rst for the
serial port name with the “Name:” message. If a user does not
specify a valid serial port name in response to the “Name:”
prompt, the command aborts with the following message:
“The serial port name a user has entered is NOT valid!”.
Regarding “LIST {USERIUSERSIPORTI
PORTSISNAME} [UsemamelPort Name]” the LIST com
mand is used to list the current usernames active in the power
manager system with their current SHOW command access
and the ports to which a usemame has access, to list the
current users allowed access to the system ports, and to list the
currently de?ned Serial Port Names.
The LIST command can be used to list all users in the
system (LIST USERS), to list a single user and all ports to
which the speci?ed user has access (LIST USER), to list all
ports in the power manager chain and all users with access to
all ports (LIST PORTS), and to list a single port and all users
with access to that port (LIST PORT).
The LIST USER command is used to display information
about a single user. This information includes a list of all ports
on the system to which a user has access and whether the