Datasheet

US 7,099,934 B1
21
parameter (which is the new username) or with no param
eters. If a parameter is not speci?ed, a user is prompted for
a usemame with the following prompt: “Username:”. A
non-blank usemame that contains no more than 16 charac
ters, and does not contain the colon “:” character, must be
entered at this prompt or the command is aborted with the
following message: “Sorry, a usemame a user has entered is
NOT valid!”. A usemame is not case sensitive.
Once a username is speci?ed, a user is prompted for a
password via the “Password:” message. A user is prompted
for a veri?cation of the newly entered password after enter
ing the password. The veri?cation password must match the
?rst password entered or the command is aborted with the
following message: “Sorry, the password a user has entered
is NOT valid!”. The “*” character is echoed in response to
the characters typed for the password and the password
veri?cation strings. The password value entered at this
prompt and successfully veri?ed is stored as the password
for this username and is used to validate this usemame
during normal power manager logon processing. The pass
word can not contain more than 16 characters or the com
mand is aborted with the following message: “Sorry, the
password a user has entered is NOT valid!”. The password
is case sensitive.
Once the information has been entered, a user receives the
following message: “Username successfully added”. Note
that a value in a username is required in this command.
Blank or empty responses to the password prompt and the
password veri?cation prompt are accepted as valid.
By default, a new user does not have access to any
resources on the power manager Board, and cannot use the
SHOW command. To allow a user to access a power module
or a communications connection, the ADD PORT command
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 command can be entered with no parameters, with a
single parameter (which is a usemame) or with two param
eters (which are username 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
“Usemame:” prompt, the command aborts with the follow
ing message: “Sorry, a usemame 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 usemame 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 USER
NAME”. 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.
20
25
30
35
40
45
50
55
60
65
22
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 follow
ing 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:” a 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 {USERIPORTISNAME}
[UsemamelSerial Port NAME] [Port Name]”, the DEL com
mand is used to delete usernames 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 whether port
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
parameter (which is a usemame to remove) or with no
parameters. If a parameter is not speci?ed, a user is
prompted for a usemame with the following prompt: “User
name:”. A valid system usemame must be entered at this
prompt or the command is aborted with the following
message: “Sorry, a usemame a user has entered is NOT
valid!”. This command cannot 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 “Usemame successfully deleted”. A success
ful 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 “Usemame:” 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