Snacfg User

In addition, snacfg user allows you to add users to the list recognized by SNA Server. However, it is recommended that you use SNA Server Manager, not snacfg user, when adding users.

Important   If you add user names by using the /add option with snacfg user, these names must match existing user account names in the Windows NT domain or a nonfunctioning configuration may result. To protect against errors with snacfg user, use SNA Server Manager, instead.

Before assigning LUs or LU pools to users, you must first configure the LUs or LU pools. For more information, see "Task Order" earlier in this chapter.

Note   Configuration settings specified with snacfg user correspond to user or group settings configured with SNA Server Manager. Syntax snacfg [#configpath] user /list
snacfg [#configpath] user username
snacfg [#configpath] user username /add [options]
snacfg [#configpath] user /validate
snacfg [#configpath] user username [options]
snacfg [#configpath] user username /delete

where
 

#configpath

Specifies the path of the configuration file to view or change. If the configuration path is omitted, SNA Server will attempt to access the configuration file on the local system, using the path \SNAServerRoot\SYSTEM\CONFIG\COM.CFG, where SNAServerRoot is the SNA Server root directory.

/list

Generates a list of the 3270 users recognized by SNA Server.

domain/username

Specifies the domain and name of the user to add, view, change settings for, or delete.

For adding 3270 users, the recommended method is to use SNA Server Manager, not snacfg user. If you are adding or removing a user, username must match the name in the user’s account on the Windows NT domain specified by domain.

/add

Adds a user called username to the list of 3270 users recognized by SNA Server. The user must already have an account on the Windows NT domain or on the local system.

For adding 3270 users, the recommended method is to use SNA Server Manager, not snacfg user.

/validate

Attempts to fill in any SIDs that are missing from user or group listings in the SNA Server configuration file. If the SIDs can be obtained from user accounts in the Windows NT domain for each user, the SIDs will be added to the listings in the SNA Server configuration.

Run snacfg user /validate after working offline and adding users to the configuration so that the user listings in SNA Server will be functional.

/delete

Deletes username.

options

Are as shown in the following list.

/insert:luname[luname,...]

Assigns the specified 3270 or LUA LUs or pools to the user. Separate multiple names with commas.

/remove:luname[luname,...]

Deletes the assignment of 3270 or LUA LUs or pools to the user. Separate multiple names with commas.

/insertrlu:rluname[,rluname,...]

Assigns APPC Remote LUs to the user. Separate multiple names with commas. The name rluname can be either the RLU alias or its fully-qualified name of the form "netname.luname".

/removerlu:rluname[,rluname,...]

Deletes the assignment of APPC Remote LUs to the user. Separate multiple names with commas. The name rluname can be either the RLU alias or its fully-qualified name of the form "netname.luname".

/domain:domainname

Specifies the Windows NT domain in which the user account is found. For all actions involving the domain name associated with a user account, the recommended method is to use SNA Server Manager, not snacfg user. If an incorrect domain name is specified with snacfg user, a nonfunctioning configuration may result.

/comment:"text"

Adds an optional comment for the specified user. The comment can contain as many as 25 characters.

/defloclu:LUalias

Specifies the default local APPC LU for this user or group. Both the user (or group) name and the LU alias must already be configured in SNA Server. If /defloclu: is typed without LUalias, the user or group record is cleared of any default local LU.

/defremlu:LUalias

Specifies the default remote APPC LU for this user or group. Both the user (or group) name and the LU alias must already be configured in SNA Server. If /defremlu: is typed without LUalias, the user or group record is cleared of any default remote LU.