The Add NetWare Authentication Entry (ADDNTWAUTE) command adds authentication information for a server to a user profile. The information specifies how the user signs on to the server. This information is used to start authenticated connections to servers. An authenticated connection to a server is required to issue requests to the server. If an authenticated connection does not exist, the system attempts to start a connection using data stored in the authentication entries.

Parameters

Keyword	Description	Choices	Notes
SVRTYPE	Server type	*NDS	Required, Positional 1
NDSTREE	NDS tree	Character value	Optional
USRPRF	User profile	Name, *CURRENT	Optional
NDSCTX	NDS context	Character value	Optional
NTWUSER	NetWare user	Character value, *USRPRF	Optional
PASSWORD	Password	Character value, *NONE, *STRNTWCNN	Required, Positional 2

Top

Server type (SVRTYPE)

Specifies the server type of the authentication entry.

*NDS

The entry is for a NetWare Directory Services tree.

NDS tree (NDSTREE)

Specifies the NetWare Directory Services tree for which the authentication entry is to be added.

User profile (USRPRF)

Specifies the user profile to which the authentication entry is to be added.

*CURRENT

Use the current user profile.

name

Specify the name of the user profile. The user profile must be the current user profile, or the user must have *USE and *OBJMGT authority to the user profile, and *SECADM special authority.

NDS context (NDSCTX)

Specifies the NetWare Directory Services context in which the user name is defined. The NDS context and NetWare user name are combined to form the distinguished name for the user in the NDS tree.

NetWare user (NTWUSER)

Specifies the NetWare user name used to authenticate the user to the server.

*USRPRF

The NetWare user name is the same as the name of the user profile (USRPRF parameter) to which the entry is being added.

character-value

Specify the NetWare user name to be used.

Password (PASSWORD)

Specifies the password used to authenticate the user to the server.

*NONE

No password is needed to verify authority.

*STRNTWCNN

No password is stored as part of the authentication entry. The password must be provided as part of a Start NetWare Connection (STRNTWCNN) request prior to issuing any requests to the server.

character-value

Specify the password to be used.

Examples

ADDNTWAUTE   SVRTYPE(*NDS)  NDSTREE(IBMTREE)
             NDSCTX('OU=PROG.OU=ROCH.O=IBM')
             PASSWORD(*STRNTCNN)

This command adds an authentication entry for NDS tree IBMTREE to the current user profile. The user name is the same as the current user profile. The full distinguished name for the user (formed by combining the NDSCTX and NTWUSER parameters, and assuming the current user profile name is JOHN) is '.CN=JOHN.OU=PROG.OU=ROCH.O=IBM'. The Start NetWare Connection (STRNTWCNN) command must be used, with the correct password specified on the PASSWORD parameter, before requests can be sent to the server.

Error messages

*ESCAPE Messages

FPE0217

Authentication entry not added due to errors.