Creating user objects with the UIMPORT utility

The following list describes the prerequesites:

• A workstation logged in to the network, running DOS 3.30 or above or OS/2 v2.x, and using NetWare 4.1 client software

• A minimum of 512KB of memory available on the workstation

• The Create or Supervisor object right to the container object where the User objects will be created

• The Create or Supervisor filesystem right to the directory where user home directories will be created (if applicable)

1. Generate a data file within your database application.

   For general instructions, see ``Generating the data file''. For specific instructions, see the documentation accompanying your application.

2. Create an import control file.

   If you have enough disk space, save this file in the same directory in which you saved the data file. Otherwise, you will need to specify the path to both the data file and the import control file when you run UIMPORT.

3. Run UIMPORT from the directory in which you saved the data file and the import control file.

   At the DOS command line, type
   
   UIMPORT control_file data_file /C

   Replace control_file with the name of the import control file you created. Replace data_file with the name of the data file you generated from your database application. Use /C to run UIMPORT with continuous output.

   If you do not run UIMPORT from a directory that contains both the import control file and the data file, you must specify the path to each file.

   Importing hundreds or thousands of users may take several hours. Therefore, you might want to run UIMPORT at night.

4. (Optional) Route import errors to a file.

   If errors occur during the import process, messages appear on your workstation screen. If you want the messages sent to a file, add the DOS "> filename" option to the command.

   For example, to route the messages to a file called UIMPORT.LOG in your home directory, use a command similar to the following:
   
   UIMPORT control_file data_file >HOME\PAUL\UIMPORT.LOG

   ---

   NOTE: When importing large groups of users, the performance of your server might begin to slow down. The reduction in performance is related to the amount of disk space available for NDS and TTS to use with UIMPORT's numerous transactions and is also related to the size of UIMPORT batches and the amount of available server memory.

   If you will be importing large groups of users or experience decreased server performance while running UIMPORT, you can add server memory, process smaller batches of users, or process UIMPORT batches during periods of low server utilization.

   ---