SYSMANHELP.HLB  —  ALF
    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.
Close Help