Start NetWare Connection (STRNTWCNN)

The Start NetWare Connection (STRNTWCNN) command starts an authenticated connection to the specified server. This command is used to:

Start a connection when there is no password in the authentication entry for the server (the password value is *STRNTWCNN).
Start a connection using authentication information different from that specified in the user profile authentication entry.
To specify a preferred server for NetWare operations that might otherwise use a different server.

If a password is stored in the authentication entry, this command is not needed; the system will start and end connections as necessary.

Connections can be authorized to be used only by the current job (AUTJOB(*)), or can be authorized to be used by any job running under the specified user profile (AUTJOB(*ANY)), for example, a batch job. Each user profile can only have one connection per job open to a given server at a time.

For NetWare Directory Services trees, connections may be started to each server within the tree. The special value *ALL may be used to start connections to all servers. This could be used, for example, when copying from one server in the tree to another, or copying between partitions of the NDS tree. If multiple connections exist, operations that do not require a specific server will be performed using the first connection started.

The NetWare backup services require that each user perform a separate authentication in addition to a normal login. The connection type (CNNTYPE) parameter allows you to specify that a *SAVRST authentication be performed for this purpose.

Restrictions: To start a connection for another user profile (specified in AUTUSR parameter), you need to have *USE authority to that user profile.

Parameters

Keyword	Description	Choices	Notes
SERVER	Server	Character value, ALL, ANY	Required, Positional 1
SVRTYPE	Server type	SERVER, NDS	Optional
NDSTREE	NDS tree	Character value, *SERVER	Optional
AUTUSR	Authorized user profile	Name, *CURRENT	Optional
NDSCTX	NDS context	Character value, AUTE, USRPRF	Optional
NTWUSER	NetWare user	Character value, AUTE, USRPRF	Optional
PASSWORD	Password	Character value, NONE, AUTE	Optional
AUTJOB	Authorized job	, ANY	Optional
CNNTYPE	Connection type	Single values: ALL Other values (up to 2 repetitions): USER, *SAVRST	Optional
CNNIDLTIME	Connection idle time	1-9999, *NOMAX	Optional

Top

Server (SERVER)

Specify the server to which the connection is to be started.

*ANY: For *NDS servers, start a connection to any server within the NDS tree.
*ALL: For *NDS servers, start connections to all servers within the NDS tree.
character-value: Specify the name of the server to which the connection is to be started.

Server type (SVRTYPE)

Specifies the type of server.

*SERVER: Use system information about the specified server to determine the server type. This value cannot be used when *ANY or *ALL is specified for the Server (SERVER) parameter.
*NDS: The server is in a NetWare Directory Services tree.

NDS tree (NDSTREE)

For *NDS servers, specifies the name of the NetWare Directory Services (NDS) tree to which the connection is to be started.

*SERVER: Use system information about the specified server to determine the NDS tree name. This value cannot be used when *ANY or *ALL is specified for the SERVER parameter.
character-value: Specify the name of NDS tree.

Authorized user profile (AUTUSR)

Specifies the user profile authorized to use the connection.

*CURRENT: The connection can only be used by jobs running under the current user profile.
name: Specify the name of the user profile. The connection can only be used by jobs running under the specified user profile.

NDS context (NDSCTX)

Specifies, for *NDS servers, the NetWare Directory Services context in which the NetWare user name is defined.

*AUTE: Use the authentication entry for this tree in the user profile to determine the NDS directory context.
*USRPRF: Use the authorized user profile name as the NDS directory context name.
character-value: Specify the name of NDS directory context.

NetWare user (NTWUSER)

Specifies the NetWare user name used to authenticate the user.

*AUTE: Use the authentication entry for the specified server or NDS tree in the user profile to determine the NetWare user name.
*USRPRF: Use the authorized user profile name as the NetWare user name.
character-value: Specify the NetWare user name.

Password (PASSWORD)

Specifies the password to be used to verify the authority for the specified user.

*AUTE: Use the password in the authentication entry for this server or NDS tree in the user profile.
*NONE: No password is used to verify authority.
character-value: Specify the password to be used.

Authorized job (AUTJOB)

Specifies the job authorized to use the connection. The connection can be used either by the current job, or by any job running under the specified user profile name.

*

The connection can only be used by the current job. The connection will be closed when the job ends.

*ANY

The connection can be used by any job running under the specified user profile. The connection must be ended by an End NetWare Connection (ENDNTWCNN) request.

Notes:

The QNETWARE file system requires a connection for the current job (AUTJOB(*)).
If a connection cannot be started using an authentication entry, printing to a NetWare print server requires a connection for any job (AUTJOB(*ANY)).
Connections for AUTJOB(*) are also ended if the QFPZAUT activation group is reclaimed (RCLACTGRP command).

Connection type (CNNTYPE)

Specifies the types of authentication to be performed. NetWare backup services require a separate authentication in addition to a normal user login.

Single values

*ALL: Both *USER and *SAVRST authentications will be performed.

Other values (up to 2 repetitions)

*USER: A normal user authentication will be done. This will allow the user to use administration and file system services other than save and restore.
*SAVRST: Authentication to NetWare backup services will be performed. This option requires that the appropriate NetWare backup NLMs (TSAxxx) be loaded on the server.

Connection idle time (CNNIDLTIME)

Specifies the idle time after which the connection will be closed. The idle time is the time since the most recent request to the server.

*NOMAX: No idle time limit is specified. The connection will remain open until ended by an End NetWare Connection (ENDNTWCNN) request, or until the job is ended, whichever is sooner.
1-9999: Specify the number of minutes of allowed idle time.

Error messages

*ESCAPE Messages

FPE0226: Connection not started to server &1.