There are several ALF subcommands. Select the one you want from
the choices below.
1 – ADD
Adds a new record to the automatic login facility (ALF) database.
You can also create records for proxy accounts.
Requires read (R) and write (W) access to the SYSALF database
(SYS$SYSTEM:SYSALF.DAT by default).
Format
ALF ADD device user
1.1 – Parameters
device
Specifies the terminal name or port name that you want to assign
to a user name. The parameter device must be a terminal name
if you do not specify qualifiers on the command line, and can
be either a logical name or an abbreviated device name. This
parameter accepts a maximum of 63 characters, including devices
for proxy accounts.
user
Specifies the user name of the account that you want to assign to
a particular terminal or port.
1.2 – Qualifiers
1.2.1 /TERMINAL
/TERMINAL (default)
Checks whether the device name you specified is a terminal on the
target system. The parameter device can be a logical name or an
abbreviated device name, which SYSMAN translates to a full device
name.
1.2.2 /PORT
Checks whether the device name you specified is a valid port. If
the port name contains special characters, such as a slash (/),
or if it contains lowercase letters that you want to preserve,
you must enclose the port name within quotation marks (" ").
Be aware that anything within quotation marks is written
literally to the ALF database file. For example, if the
actual port name contains uppercase letters as well as special
characters, be sure to specify uppercase letters within the
quotation marks. Otherwise, a mismatch will occur between the
actual port name and what is specified in the SYSALF.DAT file.
1.2.3 /PROXY
Checks that the device name is in the NODE::USERNAME format.
1.2.4 /LOG
Displays the device names and user names as they are added to the
ALF database.
1.3 – Description
You can use the ALF ADD command to associate a terminal or port
with a particular user name. This will enable certain users to
log in to certain terminals or ports without specifying a user
name.
The ALF ADD command adds a new record to the ALF database.
1.4 – Examples
1.SYSMAN> ALF ADD TTA3 JBERGERON
SYSMAN> ALF ADD "MN34C3/LC-1-2" FMARTIN /PORT
In this example, the first command assigns terminal TTA3 to
user JBERGERON. The second command assigns port MN34C3/LC-1-2
to user FMARTIN.
2.SYSMAN> ALF ADD VMS:.ZKO.VMSORG.SYSMAN.CLIENT1::SYSTEM FOOBAR
In this example, VMS:.ZKO.VMSORG.SYSMAN.CLIENT1::SYSTEM is the
value for the device parameter, which is assigned to FOOBAR.
2 – REMOVE
Removes one or more records from the ALF database.
Requires read (R) and write (W) access to the SYSALF database
(SYS$SYSTEM:SYSALF.DAT).
Format
ALF REMOVE device
2.1 – Parameter
device
Specifies the terminal name or port name whose record you want
to remove from ALF. The device name is required, even if you use
qualifiers with the ALF REMOVE command.
You can use wildcard characters in the terminal name or port
name. For example, if you specify the device TTA*, the system
removes all records that start with the string TTA. The system
does not, however, remove any records that start with the string
<nodename>$TTA (where <nodename> is the system's SCSNODE name).
To remove records starting with $, you would have to specify
$TTA* or use two wildcards: *TTA*.
If you omit wildcard characters and enter a REMOVE command,
SYSMAN attempts to match the device name exactly. If more
than one record matches the criteria, SYSMAN displays an error
message.
2.2 – Qualifiers
2.2.1 /USERNAME
/USERNAME=user
Enables you to remove a record in ALF for a specific user
associated with a device. You must also enter the device when
you use the /USERNAME qualifier. You can use wildcard characters
with the /USERNAME qualifier.
2.2.2 /CONFIRM
Displays a message asking you to verify that you want to remove
the record.
2.2.3 /LOG
Displays each device name and user name after it has been removed
from the ALF database.
2.3 – Description
The ALF REMOVE command removes one or more records from the ALF
database.
NOTE
VSI recommends that you use caution when issuing REMOVE
commands from Version 6.1 or lower SYSMAN clients to Version
6.2 or higher systems.
3 – SHOW
Displays one or more records from the ALF database.
Requires read (R) and write (W) access to the SYSALF database
(SYS$SYSTEM:SYSALF.DAT).
Format
ALF SHOW [device]
3.1 – Parameter
[device]
Specifies the terminal name or port name whose record you want
to display. You can use wildcard characters in the terminal name
or port name. Certain restrictions in wildcard matching of ALF
records exist, as shown in the examples section.
3.2 – Qualifiers
3.2.1 /USERNAME
/USERNAME=user
Displays the records held by the specified user. You can use
wildcard characters with this qualifier.
3.2.2 /OUTPUT
/OUTPUT[=filespec]
Directs the output of the command to a file. If you do not
include a file specification with this qualifier, SYSMAN writes
the output to the file SYSMAN.LIS in your default directory.
3.3 – Description
The ALF SHOW command displays one or more records in the ALF
database.
3.4 – Examples
1.SYSMAN> ALF SHOW TTA* /USERNAME=MANESS /OUTPUT=ALF.TXT
In this example, the records for all terminals named TTAx that
are assigned to user MANESS are selected and directed to the
file ALF.TXT.
2.SYSMAN> ALF SHOW TTA*
This command displays only those records that start with the
string TTA.
3.SYSMAN> ALF SHOW TTA
This command displays only those records that start with the
string <nodename>$TTA.
4.SYSMAN> ALF SHOW *TTA
This command displays records that have device names ending
with TTA.
5.SYSMAN> ALF SHOW *TTA*
This command displays all records that contain the string TTA.