NOVELL TECHNICAL INFORMATION DOCUMENT
TITLE: COPYNLM3.EXE; COPY.NLM Server Utility
README FOR: COPYNLM3.EXE
NOVELL PRODUCTS and VERSIONS:
IntranetWare
NetWare 4.11
NetWare 3.12
NetWare 4.1
ABSTRACT:
COPY.NLM is a server utility to copy files between servers
(without involving any clients).
NOTE: The functionality of this utility has been rolled into ToolBox.nlm.
Therefore, no more enhancements or fixes will be made to this utility.
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:
n/a
Self-Extracting File Name: copynlm3.exe
Files Included Size Date Time
..\
COPYNLM3.TXT (This file)
COPY.NLM 11595 10-31-97 11:29:46 am
COPYNLM3.TXT 8242 10-31-97 1:19:48 pm
Installation Instructions:
COPY.NLM
version 1.7a (NetWare v3.12, v4.x, and IntranetWare)
Copyright (C) 1997 Novell, Inc.
All Rights Reserved
________________________________________
CONTENTS
________________________________________
I. Abstract
II. Installation Instructions
III. Usage
IV. Product Description
V. Enhancements/Bug Fixes
VI. Known Issues
VII. Frequently Asked Questions
________________________________________
I. ABSTRACT
________________________________________
COPY.NLM is a server utility to copy files between servers
(without involving any clients).
*************************************************************
NOTE: The functionality of this utility has been rolled into
ToolBox.nlm. Therefore, no more enhancements or fixes
will be made to this utility.
*************************************************************
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.
________________________________________
II. INSTALLATION INSTRUCTIONS
________________________________________
Copy COPY.NLM to the SYS:\SYSTEM directory on your server.
________________________________________
III. USAGE
________________________________________
load copy SourceSpec DestPath [Username Password] [Options]
________________________________________
IV. PRODUCT 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:
load copy SourceSpec DestPath [Username Password] [Options]
SourceSpec = [servername/]vol:path/filespec
Specifies the source file(s) to copy. Must include volume.
Wildcards may be used. Can specify a DOS drive letter.
Examples:
silicon/sys:system/*.nlm
vol1:*.dat
vol1:temp/myfile.txt
c:\nwserver\sta*.*
DestPath = [servername/]vol:path/[file]
Destination directory or file. Can specify a DOS drive letter.
If the directory does not already exist, an error will be
returned. Wildcards are not allowed in the destination filespec.
Examples:
silicon/sys:system/
silicon/sys:system
vol1:/
silicon/sys:system/testapp.nlm
a:
c:\nwserver
Username = User for authentication to remote server
Since copy needs to authenticate to both the source and remote
servers, the username and password must be valid for both
servers.
NDS and bindery authentication cannot be used concurrently
Password = Password for user
If the user has no password, this parameter should contain
empty double quotes. i.e. ""
Options = All options should be separated by spaces
/b - Force bindery authentication
This option will bypass NDS authentication attempts.
This is useful when you need to copy between a 3.x
and 4.x server and the Username/Password is the same
for both servers.
/a - This option supresses copying of Dos and NetWare
attributes.
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 ""
Copy one file (tmp.log) to a remote 3.x server, or a remote
4.x server not in the local tree.
>load copy sys:tmp.log sr71/sys: joe bananas /b /a
________________________________________
V. ENHANCEMENTS/BUG FIXES
________________________________________
Enhancements to version 1.7
- Added wildcard support in the source filespec.
- Allowed the copy to go in any direction between servers.
- Added NDS authentication. Enhanced the help screen.
- Will load on 3.x and 4.x.
- Added ability to copy to the DOS partition.
- Will now copy the date/time and attributes of source file.
- Added switch to disable copying of DOS and NetWare attributes.
Enhancements to version 1.7a
- Fixed accidental logout if NDS symbols weren't imported.
- Fixed abend if password was not specified.
________________________________________
VI. 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. Only DOS
name spaces are used.
Issue 3: Copy will not create directories.
Issue 4: Will not copy subdirectories (no recursive copying).
Issue 5: Will not copy to the DOS partitions on remote servers.
Issue 6: Extended attributes and trustees are not copied.
Issue 7: Files copied to the DOS partition will not preserve dates and
attributes.
Issue 8: Copy is NOT reentrant, thus it cannot be run successively from an
NCF file.
________________________________________
VII. 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).
A: How can I call copy multiple times?
Q: Since Copy is not reentrant you will need to use a task scheduler
such as Cron.nlm to schedule multiple copies.
-----------------------------------------------------------------
Any trademarks referenced in this document are the property of their
respective owners. Consult your product manuals for complete trademark
information.
-----------------------------------------------------------------
