Datasheet

US 7,099,934 B1
23
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 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
(USERIUSERSIPORTIPORTSISNAME} [UsemamelPort
Name]” the LIST command is used to list the current
usemames active in the poWer manager system With their
current SHOW command access and the ports to Which a
username 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 SHOW command is enabled or disabled for a user. The
command can be entered With a single parameter (Which is
a username to list) or With no parameters. If a parameter is
not speci?ed, a user is prompted for a username With the
folloWing prompt: “Username:”. A valid system username
must be entered at this prompt or the command is aborted
With the folloWing message: “Sorry, a username a user has
entered is NOT valid!”.
If a valid username is speci?ed the folloWing message is
displayed: Active Port List for Usemame XXXXXX ShoW
command enabled/disabled.
In the above message XXXXXX is replaced by a user
name and either enabled or disabled is displayed depending
on the status of the SHOW command for this username.
After the header message is displayed, a list of all ports to
Which a username has access is displayed. The absolute port
name is displayed, folloWed by a user de?ned port name (if
there is one) folloWed by the group name (if there is one).
If the list of ports ?lls a screen, a user is prompted to press
“N” for additional names or “Q” to end the list. The
folloWing is an example of the screen display,
.Al PortAl GroupAl
.A2 PortAZ GroupAl
.Z4 PortZ4 GroupAl
Press: “N”)ext, “Q”)uit
20
25
30
35
40
45
50
55
60
65
24
All ports Will have at least the absolute port name dis
played; hoWever a user assigned port name and the group
name may or may not be present based on the con?guration
of the port.
The LIST USERS command is used to display a list of all
the valid users on the system along With a display of Whether
the SHOW command is enabled or disabled for a user. If a
username list ?lls the screen, a user is prompted to press “N”
for additional names or “Q” to end the list. The folloWing is
an example of the LIST USERS display,
admn Show command enabled
genl Show command enabled
gen2 Show command enabled
sentryl Show command disabled
Press: “N”)ext, “Q”)uit
When all users have been listed, the folloWing message is
displayed: “Usemame List Complete”.
The LIST PORT command is used to display a list of all
users With access to a speci?c port on the system. The
command can be entered With a single parameter (Which is
the port name to list) or With no parameters. If a parameter
is not speci?ed, a user is prompted for the port name With the
folloWing prompt: “Port Name:”
After a port name is speci?ed, a list of usemames With
access to the port is displayed on the screen. The port name
being listed is displayed folloWed by a list of usernames. The
port name is displayed as the absolute port name folloWed by
a user created port name (if there is one) folloWed by the
group port name (if there is one). The folloWing example
illustrates the ?rst group of a speci?c port name display,
.C4 USERPORTI GROUPPORTI
usemames:
admn genl gen2
sentryl sentryZ sentry3
sentry4 sentry5 sentry6
sentry7 sentry8 sentry9
sentrylO sentryll sentrylZ
sentryl3 sentryl4 sentryl5
sentryl 6 sentryl7 sentryl 8
sentryl 9 sentryZO sentryZl
sentry22 sentry23 sentry24
sentry25 sentryZ 6 sentry27
Press: “N”)ext, “Q”)uit
When all users for a speci?c port have been displayed the
folloWing message is displayed: “Usemame List for PORTl
Complete”.
A LIST PORTS command is used to display a list of all
ports on the system With all users With access to each port
on the system. The display is the same as for a single port
name list as illustrated in the LIST PORT command above,
except the “N”)ext, “Q”)uit prompt is displayed after the
“Usemame List for PORTl Complete” message is displayed
rather than returning to the poWer manager prompt. Ports are
displayed in port order starting With absolute port .Al and
ending With the forth port on the last board in the chain
(unless a user speci?es ‘“‘Q’”’ before the last port is listed).
When all users for all ports have been listed, the folloWing
message is displayed: “Port List Complete”.
The LIST SNAM command is used to display the current
serial port names and the port associated With the serial port