Unexpected User Name

Problem: AcuServer establishes a connection with the client, but uses an unexpected user name (Local Username).

There are two common reasons for getting an unexpected Local Username on the server:

  1. The client machine/client user combination isn't matching the expected access record.
  2. The client machine/client user combination matches an access record that specifies an unexpected Local Username (perhaps the name of a group account, or an account with restricted privileges).

To investigate and correct this situation you must be familiar with AcuServer server access configuration, and have access to root or administrator privileges. Work with your AcuServer system administrator.

The diagnostic procedures include:

  1. Confirming your client user name
  2. Confirming your client machine name
  3. Looking up your client user name/client machine name combination in the server access file


  1. Confirm your client user name.
    • On UNIX clients:
      • Log onto the client system using the same user name and UNIX environment that resulted in the unexpected user name.
      • If the system is a UNIX system, enter who am I at the UNIX prompt.

        Is the user name returned the name you expected?

    • On Windows clients:

      If a user is logged into a Windows NT/2000 workgroup or domain, AcuServer will use the user's log-in name. Otherwise, it uses the user name value that is set by the environment variable USERNAME. If USERNAME is not set, the runtime uses the value that is set by the environment variable USER. (The values of these variables are case-sensitive.) If neither of these environment variables is set, the runtime uses the literal string USER.

      To confirm the presence (or absence) of the USERNAME environment variable, enter SET at the command prompt. SET will display the value of all environment variables.


      If USERNAME is defined, the value of USERNAME is the name passed to AcuServer. Otherwise, the variable USER is checked. (Both of these variables are case-sensitive.) If USER is not set, the literal string USER is passed.

  2. Confirm the name of the client system.
    • On UNIX clients, enter:


      uname -n

      The system will return its official network host name.

    • For Windows NT/2000 clients:
      1. Go to Start > Settings > Control Panel > Network > Protocols.
      2. Select TCP/IP.
      3. Choose Properties > DNS > Host Name.

      The name you specify for the Host Name entry is the one that the runtime uses.

  3. On the server, examine the server access file for the record that matches the client machine name/client user name combination. This process requires root privileges on a UNIX server, and administrator group privileges on a Windows NT, Windows 2000 to 2008 server. It should be done by the AcuServer system administrator.
    1. Run the server access file manager utility:
      acuserve -access
    2. Be sure to enter the name of the working server access file when prompted.
    3. Select menu item [4] - Display one/all security records.
    4. Respond N to the prompt: Display all records?
    5. To the next two prompts, provide the client machine name and client user name, respectively. The matching record will be displayed.

      The AcuServer system administrator should be able to determine whether this is the appropriate and expected access record for the client machine name/client user name combination and take any necessary steps to modify the record, or add a new one.