NOVELL TECHNICAL INFORMATION DOCUMENT

TITLE:  COPYNLM1.EXE; COPY.NLM Server Utility
README FOR:  COPYNLM1.EXE

NOVELL PRODUCTS and VERSIONS:
IntranetWare
NetWare 4.1
NetWare 4.11

ABSTRACT:

COPY.NLM is a server utility to copy files between servers (without involving
any clients).

 NOTE: This utility helps system administrators.  It is provided free of charge
as a courtesy, and therefore, is not a Novell supported product.  Problems or
questions regarding this product can be reported via e-mail to
NTSUTIL@NOVELL.COM.



 -----------------------------------------------------------------
 DISCLAIMER
 THE ORIGIN OF THIS INFORMATION MAY BE INTERNAL OR EXTERNAL TO NOVELL.  NOVELL
MAKES EVERY EFFORT WITHIN ITS MEANS TO VERIFY THIS INFORMATION.  HOWEVER, THE
INFORMATION PROVIDED IN THIS DOCUMENT IS FOR YOUR INFORMATION ONLY.  NOVELL
MAKES NO EXPLICIT OR IMPLIED CLAIMS TO THE VALIDITY OF THIS INFORMATION.
 -----------------------------------------------------------------


ISSUE: 

========================================
 Installation Instructions:
 _____________________________________________

 Copy COPY.NLM to the SYS:\SYSTEM directory on your server.


 ========================================
 Usage:
 _____________________________________________

 load copy SourceSpec DestPath [Username Password]


 ========================================
 Description:
 _____________________________________________

 The COPY NLM is used to copy files on the local server, on a remote server, or
between the local and remote servers.
     
 It is not designed to copy files between two remote servers.


 Copy SYNTAX:
     
 SourceSpec = [servername/]vol:path/filespec
      Specifies the source file(s) to copy.  Must include volume.
       
      Examples:
           silicon/sys:system/*.nlm
           vol1:*.dat
           vol1:temp/myfile.txt          
     
 DestPath = [servername/]vol:path/[file]
      Specifies the destination directory or file.  It MUST be a
      full path including volume name (server name is optional.)
      No wilcards are accepted.
          
      If a directory is specified (ending in "\" or "/"), all
      files in SourceSpec will be copied to that directory. If a
      directory name is specified but is not followed by a "/" or
      "\", a file open error will be returned. If the directory
      specified does not already exist,  an error will be
      returned.
            
      Examples:
           silicon/sys:system/
           vol1:/ 
          
      If a file is specified, the file in SourceSpec will be
      copied to the destination file.
     
      Example:
           silicon/sys:system/testapp.nlm    
     
     
 Username = User for authentication to remote server
      This optional parameter specifies the bindery username for
      authentication to the remote server, if specified.

 Password = Password for above user
      This optional parameter specifies the password for the user.
      If the user has no password, this parameter should contain
      empty double quotes.  i.e. ""

 EXAMPLES:
      Copy all .EXE files from sys:public to vol1:savepublic/ on
      the local server.
          
      >load copy sys:public/*.exe vol1:savepublic/
          
      Copy one file (tmp.log) from a remote server (borg) to the
      local server and rename the file in the process.
     
      >load copy borg/sys:etc/tmp.log sys:etc/borgtmp.log admin yo
          
      Copy all .log files from one volume to another on a remote
      server. In this case, the admin user has no password.

      >load copy borg/sys:*.log borg/vol1:/ admin ""


Self-Extracting File Name: copynlm1.exe

Files Included     Size     Date      Time

..\
    COPYNLM1.TXT     (This file)
        COPY.NLM            5441         8-14-97      4:19:14 pm


Installation Instructions:

========================================
 Known Issues:
 _____________________________________________

 Issue 1:  If files already exist in the Destination path, they will be
overwritten without warning.
     
 Issue 2:  SourceSpec and DestPath must use 8.3 DOS names.

 Issue 3:  Copy does NOT copy to the server's DOS partition.

 Issue 4:  Copy will not create directories.

 ========================================
 Frequently Asked Questions:
 ________________________________________
 Q: Why is my destination file 0 length?

 A: Copy returns immediately to the console prompt because it is a background
process.  When it's done, it displays a done message on the console prompt.

 Q: When I try to make a backup of a directory, I get messages like "Unable to
create the destination file SYS:/SYSTEM2/AFP".

 A: Copy couldn't create the file because it couldn't create the directory to
put the file (Known Issue 4 above).



 -----------------------------------------------------------------
 Any trademarks referenced in this document are the property of their
respective owners.  Consult your product manuals for complete trademark
information.
 -----------------------------------------------------------------