Chapter 17. Managing NetWare Server Connections

This chapter discusses NetWare server connections. You need to have a connection to a server to do most of the Enhanced Integration for NetWare functions. 

There are of two kinds of connections: 

  • A normal user login (this is the *USER connection) 

  • You need a *USER connection is to access NDS objects, files and directories on a server, and to perform various server administration tasks. Such tasks include creating volumes and submitting console commands. 

  • A connection to NetWare Storage Management Services (this is the *SAVRST connection).   
You specify the connection type using the CNNTYPE parameter on STRNTWCNN command. Or you can select the option from the Work with Network Server Status display and press F4. 

Establishing a connection is like logging into the server from a PC workstation. 

This chapter contains the following topics about NetWare connections: 


When is a Connection Needed?

When you establish a connection between the NetWare server and AS/400, you establish your authority to access file systems, print servers, and other Enhanced Integration for NetWare functions. 

Functions that require such a connection include the following: 

  • The QNetWare file system 
  • Administration 
  • Print support 
The Work with Network Server Status display, shown in Figure 17-1, allows you to start a connection to the server. The following options require a connection to the server: 
  • 5=Display details 
  • 7=Display users 
  • 11=Work with connections 
  • 16=Work with volumes 
Tip:
You can automate the connection process. When you do so, you do not need to use the STRNTWCNN command. To automate connections, create an authentication entry for the AS/400 administrators user IDs that will manage the NetWare servers. For information about how to automate connection startup, see Chapter 16. "NetWare Authentication Entries and Connections"

To start connections, AS/400 uses information stored in the user profile by the NetWare authentication entry commands or the user enrollment functions. A given AS/400 user and job can use its own connection to perform NetWare operations as if the NetWare operations were performed by that user from a PC workstation. AS/400 recognizes and controls authority and object ownership. To manually start connections, see "Starting a NetWare Connection"


Starting a NetWare Connection

To start an authenticated connection to a specified NetWare server: 

  • Use the Start NetWare Connection (STRNTWCNN) command, or 
  • Invoke the command by selecting 10=Start Connection on the Work with Network Server Status Display, shown in Figure 17-1
Use this command to start a connection: 
  • When there is no password in the authentication entry for the server (the password value is *STRNTWCNN or the Retain Server Security (QRETSVRSEC) system value is 0). 
  • To use authentication information different from that specified in the user profile authentication entry. 
  • To specify a preferred server for NetWare operations that may otherwise use a different server. 
  You can start a connection, either by using an authentication entry or the STRNTWCNN command. If the QRETSVRSEC system value is set to 0 to disable password storage, you must use the STRNTWCNN command. 

If you have an authentication entry, the authentication entry must identify the following: 

  • The server or NDS tree 
  • The user name for each server or NDS tree you want to access. 
  • Optionally, the password used to log in to the server or tree. 
You can take the required information from a NetWare authentication entry for the user profile. See Chapter 16. "NetWare Authentication Entries and Connections" for instructions. 

Figure 17-1. Work with Network Server Status Display--Enhanced Integration for NetWare
 
 

+--------------------------------------------------------------------------------+
|                   Work with Network Server Status                              |
|                                                             System:   SYSAS400 |
| Server type  . . . . . :   *NETWARE                                            |
|                                                                                |
| Type options, press Enter.                                                     |
|   5=Display details     7=Display users   8=Work with configuration status     |
|   10=Start connection   11=Work with connections   14=Restart server           |
|   15=Work with storage   16=Work with volumes                                  |
|                                                                                |
| Opt  Server            Status                Location                          |
|      NWHERMAN1         INACTIVE                *LCL                            |
|      PUBS              INACTIVE                *LCL                            |
|      ITSONTW           ACTIVE                  *RMT                            |
|      CHICAGO           ACTIVE                  *RMT                            |
|      DAKOTA            ACTIVE                  *RMT                            |
|      FINANCE           ACTIVE                  *LCL                            |
|      BACKUP            INACTIVE                *LCL                            |
|      MINNSVR           ACTIVE                  *LCL                            |
|                                                                      More...   |
| Parameters or command                                                          |
| ===>                                                                           |
| F3=Exit   F4=Prompt   F5=Refresh   F6=Print list   F9=Retrieve                 |
| F11=Display entire server names    F12=Cancel      F24=More keys               |
|                                                                                |
+--------------------------------------------------------------------------------+


About Connections

Some things to keep in mind when working with NetWare connections are: 

  • A connection can only be used by jobs running under the specified AS/400 user profile (AUTUSR parameter). 
  • You can start a connection so that the connection can be used by: 
    1. The current job only (required for file system) 
    2. Any job running under the specified user profile (useful when starting connections for batch jobs, and also useful for limiting the number of active connections to a server). 
  • Connections that are limited to the current job are ended during end job processing. Ending connections requires communication with the server, so job termination will take longer (possibly several minutes, depending on the state of the server). 
  • When a connection is started to a NetWare 4.1 server, there are actually two connections started (Figure 9-4).     
    1. A connection is started to the NDS tree to validate the user name and password. 
    2. The second connection is started to the server for such server operations as file access, or working with volumes, for example. 
      The idle time value for system-started connections (CNNIDLTIME) defaults to 15 minutes. 

    You can authorize connections to be used: 

    • Only by the current job (AUTJOB(*)), 
    • By any job running under the specified user profile (AUTJOB(*ANY)), such as a batch job. 

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

    Each user profile can only have one connection per job open to a given server at a time. 

    Note:
    The NTWUSER, NDSCTX, and PASSWORD parameters have a special value, *AUTE. The *AUTE value specifies to use the value defined in the authentication entry. If no authentication entry exists, you must specify values for these parameters. Figure 17-2 shows the STRNTWCNN command prompt display when the SVRTYPE parameter is *SERVER. 

    Figure 17-2. Start NetWare Connection (STRNTWCNN) Prompt Display
     
     

+--------------------------------------------------------------------------------+
|                      Start NetWare Connection (STRNTWCNN)                      |
|                                                                                |
| Type choices, press Enter.                                                     |
|                                                                                |
| Server . . . . . . . . . . . . . SERVER       > SERVER01                       |
|                                                                                |
| Server type  . . . . . . . . . . SVRTYPE        *SERVER                        |
| NDS tree . . . . . . . . . . . . NDSTREE        *SERVER                        |
|                                                                                |
| Authorized user profile  . . . . AUTUSR         *CURRENT                       |
| NDS context  . . . . . . . . . . NDSCTX         *AUTE                          |
|                                                                                |
|                                                                                |
|                                                                                |
| NetWare user . . . . . . . . . . NTWUSER        *AUTE                          |
|                                                                                |
|                                                                                |
| Password . . . . . . . . . . . . PASSWORD                                      |
|                                                                                |
|                                                                                |
|                                                                      More...   |
| F3=Exit   F4=Prompt   F5=Refresh   F12=Cancel   F13=How to use this display    |
| F24=More keys                                                                  |
|                                                                                |
+--------------------------------------------------------------------------------+


+--------------------------------------------------------------------------------+
|                      Start NetWare Connection (STRNTWCNN)                      |
|                                                                                |
| Type choices, press Enter.                                                     |
|                                                                                |
| Authorized job . . . . . . . . . AUTJOB         *                              |
| Connection type  . . . . . . . . CNNTYPE        *USER                          |
|                                                                                |
| Connection idle time . . . . . . CNNIDLTIME     *NOMAX                         |
|                                                                                |
|                                                                                |
+--------------------------------------------------------------------------------+


        
    SERVER 
    Specify the name of the server to which the connection is to be established (target server). You can start connections to any server within an NDS tree by using the *ANY value. You can specify SERVER(*ALL) to start connections to all servers within the tree you specify on this command. If multiple connections exist, operations that do not require a specific server will be performed using the first connection that was started.     
    SVRTYPE 
    Specify *SERVER if you want AS/400 to determine the type of the target server. You cannot specify *SERVER if you used *ANY or *ALL for specified for the SERVER parameter. Optionally, specify 
    • *NETWARE3 if the server is a NetWare 3.12 server. 
    • *NDS if the server is in an NDS tree. 
    NDSTREE 
    For *NDS servers, specify the name of the NDS tree to which the connection is to be started. 


    The *SERVER value uses system information about the specified server to determine the NDS tree name. The *SERVER value cannot be used when *ANY or *ALL is specified for the SERVER parameter. 

    AUTUSR 
    Specify the AS/400 user profile that can use the connection. The AUTUSR parameter also specifies which AS/400 user profile to extract the *AUTE value from, if an authentication entry exists for this user profile. 
    NDSCTX 
    The default, *AUTE, uses the authentication entry for this user profile. If no authentication entry exists for this user profile, specify the context on the NetWare NDS tree for the user ID you are using for this connection. Context is not needed when starting a connection to a NetWare 3.12 server. For more information about contexts, see your NetWare documentation.     
    NTWUSR 
    Specify the user ID to be used on NetWare for this connection. The default uses the NetWare user ID specified in the authentication entry. 
    PASSWORD 
    Specify the password to verify the authority for the specified user. The possible values are: 
    • *AUTE, which uses the password in the authentication entry for this server or NDS tree in the user profile. 
    • *NONE, for which no password is used to verify authority. 
    • password allows you to specify a password for this NetWare user object. 
    For related information about passwords, see "QRETSVRSEC System Value"
    AUTJOB 
    Specifies which job can use a connection. The choices are: 
    • The current job only (*), 
    • any job (*ANY). 
    To access the file system, you must use the current job (*). 

    If a connection cannot be started using an authentication entry, printing to a NetWare print server requires a connection for any job (AUTJOB(*ANY)). 

    CNNTYPE 
    Specifies whether the connection is: 
    • A normal user login (a *USER connection). Specifying *USER for the connection type establishes a connection that is similar to logging in from a NetWare client. A *USER connection is needed to access NDS objects, files and directories on a server, and to perform various server administration tasks such as creating volumes or submitting submit console commands. 
    • A connection to the NetWare Storage Management Services (SMS) NLMs This connection is also called a *SAVRST connection. 
      A *SAVRST connection requires that the following NLMs be present on the server, either already loaded or in the server's search path:
    NetWare 3.12 -- SMDR.NLM, TSA312.NLM
    
    NetWare 4.1 -- SMDR.NLM, TSANDS.NLM, TSA410(or TSA411).NLM
    
    
    
    The *SAVRST connection must use the same user name and password used to start the *USER connection. 
    CNNIDLTIME 
    Specifies how long a connection can remain unused before AS/400 ends the connection. 


    You can use this to: 

    • Force a connection to remain active indefinitely, if AUTJOB(*ANY) is used, possibly for batch jobs that will run later. See "Using a Connection in a Batch Job" for more information about batch processing.   
    • Allow the system to automatically close connections that have not been used for a specified period of time, possibly to reduce the number of active connections. 
Examples

This topic contains a examples for setting up various connections. 

To change the user ID being used on NetWare

If you have been using a one user ID on NetWare and now need to use a different user ID, end the current connection, and start a new one. 

To perform operations under another NetWare user name:

  1. Make sure that all connections to the server for your AS/400 user profile have been stopped: 
    1. Enter WRKNTWCNN SERVER(name) CGY(*LOCAL) USRPRF(*CURRENT)
    2. Select option 4 to end connections. 
  2. Enter STRNTWCNN and press F4. 

  3. If you have an authentication entry for the user profile if the authentication entry for the desired NDS tree or NetWare 3.12 server has the correct NetWare user name and password, you can either: 

    • Start a connection using the STRNTWCNN command:
    •     STRNTWCNN SERVER(name)
      
      
      
    • Allow AS/400 to start a connection automatically and proceed to perform NetWare requests. 
    If you do not have an authentication entry for the user profile, you must enter all of the values as shown in Figure 17-3

    To start a connection for another user profile, you must have *USE authority to that user profile. 

This starts a new connection and all subsequent requests are performed over that connection. 

Figure 17-3. Starting a Connection for a Specific User When No Authentication Entry Exists
 
 

+--------------------------------------------------------------------------------+
|                      Start NetWare Connection (STRNTWCNN)                      |
|                                                                                |
| Type choices, press Enter.                                                     |
|                                                                                |
| Server . . . . . . . . . . . . . > RCHNW480N                                   |
|                                                                                |
| Server type  . . . . . . . . . .   *SERVER       *SERVER, *NETWARE3, *NDS      |
| NDS tree . . . . . . . . . . . .   *SERVER                                     |
| Authorized user profile  . . . .   lueke         Name, *CURRENT                |
| NDS context  . . . . . . . . . .   prog.roch.ibm                               |
|                                                                                |
|                                                                                |
|                                                                                |
| NetWare user . . . . . . . . . .   edith                                       |
|                                                                                |
|                                                                                |
| Password . . . . . . . . . . . .                                               |
|                                                                                |
|                                                                                |
| Authorized job . . . . . . . . .   *             *, *ANY                       |
|                                                                      More...   |
| F3=Exit   F4=Prompt   F5=Refresh   F12=Cancel   F13=How to use this display    |
| F24=More keys                                                                  |
+--------------------------------------------------------------------------------+


This connection will be used by AS/400 user profile LUEKE for the current job (*). The NetWare user name for this user is EDITH, and she is defined in the context prog.roch.ibm on the tree, which will be determined by the AS/400 system. The only time you would use a different authorized user profile from *CURRENT is if you are using an application that swaps user profiles. 

Figure 17-4 shows a connection for a batch job that will run under the current user profile name. In this specific case, the current user profile does not have an authentication entry. Therefore, the NDS context, NetWare user profile, and password have been specified. The authorized job is *ANY because this connection is for a batch job. 

Figure 17-4. Starting a Connection for the Current User When No Authentication Entry Exists
 
 

+--------------------------------------------------------------------------------+
|Type choices, press Enter.                                                      |
|                                                                                |
|Server . . . . . . . . . . . . . > RCHNW480N                                    |
|                                                                                |
|Server type  . . . . . . . . . .   *SERVER       *SERVER, *NETWARE3, *NDS       |
|NDS tree . . . . . . . . . . . .   *SERVER                                      |
|Authorized user profile  . . . .   *CURRENT      Name, *CURRENT                 |
|NDS context  . . . . . . . . . .   prog.roch.ibm                                |
|                                                                                |
|                                                                                |
|                                                                                |
|NetWare user . . . . . . . . . .   edith                                        |
|                                                                                |
|                                                                                |
|Password . . . . . . . . . . . .                                                |
|                                                                                |
|                                                                                |
|Authorized job . . . . . . . . .   *ANY          *, *ANY                        |
|                                                                      More...   |
|F3=Exit   F4=Prompt   F5=Refresh   F12=Cancel   F13=How to use this display     |
+--------------------------------------------------------------------------------+


Connecting to a Specific Server

Assuming you have an authentication entry for the user PUBS1, to start a connection to a specific server, enter: 

STRNTWCNN SERVER(PUBS1) SVRTYPE(*NDS)


Connecting to a All Servers in a Tree

Connect to all servers in a tree for example, when copying from one server in the tree to another, or copying between partitions of the NDS tree. To start a connection to all servers in a tree, enter: 

STRNTWCNN SVRTYPE(*NDS) NDSTREE(IBMTREE) SERVER(*ALL) PASSWORD(XXXX)


Connecting to Any Server Use *ANY for the server name to start a connection to be used to access NDS objects in a tree when there is no preference for the server to be used. 

Connection Error

If you run the STRNTWCNN command and the following error appears: 

 Could not find authentication entry for SERVER1.


Do one of the following: 
  • Specify the NetWare user name and password. 
  • Run ADDNTWAUTE to add an authentication entry for this user and then retry the command. 
Using a Connection in a Batch Job

You can use connections in a batch job or for printing. However, There are some special considerations involved. These considerations concern the following: 

  • Whether an authentication entry for the desired tree or server exists for the AS/400 user profile under which the job will run, 
  • Whether or not there is a password, and 
  • Whether or not QNetWare file system access is required. 
If an authentication entry exists for the AS/400 user profile under which the job will run, and the profile contains the correct NetWare user name and password, the system can start the necessary connections, and no special action is required. 

If no authentication entry exists, or there is no password in the authentication entry, you must start a connection manually in one authentication entry. To start this connection manually, you have two options: 

  1. From an interactive job, use the STRNTWCNN command, specifying the batch job's AS/400 user profile and an authorized job value of *ANY. For example:
  2. STRNTWCNN SERVER(X) AUTUSR(batch-usrprf) AUTJOB(*ANY)
              PASSWORD(XXX)
    
    
    
    - or -
    STRNTWCNN SERVER(X) AUTUSR(batch-usrprf) AUTJOB(*ANY)
              NDSCTX(XXX) NTWUSER(XXX) PASSWORD(XXX)
    
    
    
  3. Have the batch job start the connection, but specifying AUTUSR(*CURRENT) and AUTJOB(*) (these are the command defaults). For example:
  4. STRNTWCNN SERVER(X) NTWUSER(XXX) PASSWORD(XXX)
    
    
    
    Attention:
    Care must be taken when doing this because you may be exposing the password. 
The QNetWare file system requires a connection for the current job (AUTJOB(*)). This means that to access the QNetWare file system from a batch job, one of the following must be done: 
  • You need an authentication entry in the batch user profile that contains the proper password. By implication, you must set the QRETSVRSEC system value 1. 
  • The batch job must start the connection, specifying AUTJOB(*) as described above. 

Working with NetWare Connections

Once a connection is established to a NetWare server, you can work with the connections to that server. Use the WRKNTWCNN command to see the Work with Connections display. 

From this display, you can: 

  • End a connection to a server. This is the equivalent to CLEAR STATION in NetWare. 
  • Display connection information. This is the same as using the DSPNTWCNN command.         
  • Print the connection information that appears on the Display NetWare Connection screen. 
  • Work with the AS/400 job associated with the connection. 
The Work with NetWare Connections display can show: 
  • All connections between this AS/400 system and a NetWare server 
  • All connections on the NetWare server 

  • In Figure 17-5 the local connections from AS/400 to a NetWare server are displayed. The QNETWARE user profile and user LUEKE have connections to the server PUBS1.   You can also access this display by specifying CGY(*LOCAL) on the WRKNTWCNN command. 

    Figure 17-5. Work with NetWare Connections Display
     
     

+--------------------------------------------------------------------------------+
|                         Work with NetWare Connections                          |
|                                                             System:   SYSAS400 |
| Category . . . . . . . :   *LOCAL                                              |
| User profile . . . . . :   *ALL                                                |
|                                                                                |
| Type options, press Enter.                                                     |
|   4=End   5=Display   6=Print   8=Work with job                                |
|                                                                                |
|      Connection                                                                |
| Opt  number      Server        User        -------------Job--------------      |
|        2         PUBS1         QNETWARE    QNETWARE    QSYS        011446      |
|        9         PUBS1         LUEKE       *ANY                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                      Bottom    |
| Parameters or command                                                          |
| ===>                                                                           |
| F3=Exit      F4=Prompt   F5=Refresh   F6=Print list   F9=Retrieve   F10=Start  |
| F12=Cancel   F17=Position to                                                   |
+--------------------------------------------------------------------------------+


     

Working with Server Connections

Work with server connections by selecting option 11, from the WRKNWSSTS display, then pressing F4. Specify *SERVER. Optionally, work with server connections by specifying CGY(*SERVER) on the WRKNTWCNN command. Figure 17-7 displays all connections to the server (including the local AS/400 connections). 

If you usually want to work with *SERVER category connections rather than with local connections, change the command default.   Use the CHGCMDDFT command to change the CGY default. 

 CHGCMDDFT CMD(WRKNTWCNN) NEWDFT('CGY(*SERVER)')


  The object name displayed on the *SERVER panel is relative to the current context of the job (which is set by the CHGNDSCTX command or permanently by CHGNWSA or CHGNWSUSRA commands). For more information about user context, see Chapter 21. "Managing User Enrollment"

The three connections of type *FILESRV in Figure 17-7 show that the objects that are connected are file servers. The possible objects that can show connections are: 

  • *UNKNOWN - Object type is unknown. 
  • *USER - The object is a user. 
  • *GROUP - The object is a group. 
  • *PRTQ - The object is a print queue. 
  • *FILESRV - The object is a file server. 
  • *JOBSRV - The object is a job server. 
  • *GATEWAY - The object is a gateway. 
  • *PRTSRV - The object is a print server. 

Displaying Connections

Use option 5 from the 'Work with NetWare Connections' display to display the NetWare connection. Press Enter to see additional information about the connection. Figure 17-6 shows a connection by user LUEKE to the server PUBS1. 

Figure 17-6. Display NetWare Connection Display
 
 

+--------------------------------------------------------------------------------+
|                           Display NetWare Connection                           |
|                                                             System:   SYSAS400 |
| Server name . . . . . . . . . . . :   PUBS1                                    |
|                                                                                |
| Current context . . . . . . . . . :   PUBS.ROCH.IBM                            |
| Object name . . . . . . . . . . . :   LUEKE                                    |
| Object type . . . . . . . . . . . :   *USER                                    |
| Connection number . . . . . . . . :   9                                        |
| Option  . . . . . . . . . . . . . :   *SERVER                                  |
|                                                                                |
| Network address . . . . . . . . . :   30318C01                                 |
| Node address  . . . . . . . . . . :   000000000001                             |
| Time of last login  . . . . . . . :   08/20/96  14:31:12                       |
| Expiration time . . . . . . . . . :   *NOMAX                                   |
| Connection in use . . . . . . . . :   No                                       |
| NetWare connection class  . . . . :   *NLM                                     |
| Requests  . . . . . . . . . . . . :   0                                        |
| Kilobytes read  . . . . . . . . . :   0                                        |
| Kilobytes written . . . . . . . . :   0                                        |
|                                                                      More...   |
| Press Enter to continue.                                                       |
|                                                                                |
| F3=Exit   F6=Print   F12=Cancel                                                |
|                                                                                |
+--------------------------------------------------------------------------------+


+--------------------------------------------------------------------------------+
|                           Display NetWare Connection                           |
|                                                             System:   SYSAS400 |
| Files locked  . . . . . . . . . . :   0                                        |
| Records locked  . . . . . . . . . :   0                                        |
| Semaphores  . . . . . . . . . . . :   0                                        |
|                                                                                |
| Status  . . . . . . . . . . . . . :   Logged in                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
+--------------------------------------------------------------------------------+



Ending NetWare Connections

You can use this display to end connections. Or you can use the ENDNTWCNN command. 

Attention:
Ending a connection while in the middle of a transaction or file update can cause incorrect data to be saved. 

Figure 17-7. Work with NetWare Connections--Category Server
 
 

+--------------------------------------------------------------------------------+
|                         Work with NetWare Connections                          |
|                                                             System:   SYSAS400 |
| Server . . . . . . . . :   PUBS1                                               |
| Current context  . . . :   PUBS.ROCH.IBM                                       |
| Category . . . . . . . :   *SERVER                                             |
|                                                                                |
| Type options, press Enter.                                                     |
|   4=End   5=Display   6=Print                                                  |
|                                                                                |
|                              Connection        Object                          |
| Opt    Object name           number             type     Time of last login    |
|        LUEKE                   5                *USER    08/30/96  19:57:20    |
|        LUEKE                   6                *USER    08/30/96  19:57:32    |
|        QNETWARE                4                *USER    08/29/96  13:54:31    |
|        PUBS2                   3             *FILESRV    08/22/96  12:50:39    |
|        PUBS1.PUBS              1             *FILESRV    08/22/96  12:49:40    |
|        SPRINGF1.FSIOP          2             *FILESRV    08/30/96  16:10:23    |
|                                                                                |
|                                                                         Bott   |
| Parameters or command                                                          |
| ===>                                                                           |
| F3=Exit   F4=Prompt   F5=Refresh   F6=Print list   F9=Retrieve   F12=Cancel    |
| F17=Position to                                                                |
+--------------------------------------------------------------------------------+



[ Top of Page | Previous Page | Next Page | Table of Contents | Index