%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
                README FOR IMAGE FILE COPY UTILITY

The following files are included with this utility:

          IMGCOPY.NLM v1.10    4,775    9-03-91   2:08p
          READ.ME              (this file)

IMGCOPY.NLM is a NetWare Loadable Module that is used to copy a coredump image 
file residing on the file server's local drive to a network drive while the 
server is running. Normally, the image file will have been created using HDUMP,
a coredump image file generating utility. IMGCOPY reduces file server down time
by copying the image file to a network drive as a background process, allowing 
the server to be used for normal activities.

In order to use IMGCOPY, place the IMGCOPY.NLM file in the same directory as 
the other NLMs (DOS partition or SYS:\SYSTEM directory). After an image file 
has been generated and the server brought back up, type the following at the 
file server console screen:

 LOAD IMGCOPY <<S=source path> <D=destination path> <P=priority>>

where: 

     source path    Full path (including file name) of the image file which 
                    resides on the local hard drive. If no source path is 
                    specified, the default is C:\COREDUMP.IMG. If no 
                    parameters were specified with HDUMP when it was loaded, 
                    the default source path will be correct and need not be 
                    specified at the command line.

destination path    The location on the network drive where the image file 
                    should be copied. This must be a complete NetWare path 
                    specification, including volume and file names. The 
                    default destination path is SYS:COREDUMP\COREDUMP.IMG. 
                    If the destination path does not already exist, IMGCOPY 
                    will attempt to create that directory on the network 
                    drive. If the file specified already exists, it will be
                    overwritten without any warning to the user.

        priority    This parameter specifies what priority level is to be used 
                    when copying the image file. The valid options are LOW, 
                    MEDIUM, and HIGH. If no priority is given, MEDIUM is 
                    assumed. When running at LOW priority, IMGCOPY allows the 
                    file server to service user requests for longer intervals. 
                    LOW priority will exhibit the least amount of server 
                    degradation, but it will take much longer to complete the 
                    file transfer. At MEDIUM priority, there is no degradation 
                    of server functionality, although the transfer time is
                    reduced considerably. At HIGH priority, the server will 
                    almost exclusively be processing transfer requests, thereby 
                    making it nearly impossible for the file server to perform 
                    other duties until the file has been transferred. This is 
                    the fastest transfer priority available.

Note that all the above parameters are optional, and may be specified in any 
order.

Once loaded, IMGCOPY will immediately begin to transfer the image file from 
the server's local DOS partition, to the network drive. A status screen will 
be displayed, showing the selected source and destination files, as well as 
the priority level. Also, a counter indicating the number of bytes successfully 
transferred will be display. The user can toggle out of the IMGCOPY screen by 
typing Alt + Esc. 

When the image file has been successfully transferred, IMGCOPY will display a 
message to the file server console and automatically unload itself. File server 
activity will then resume at normal operating levels. It is possible to abort 
the file transfer by unloading IMGCOPY while the transfer is taking place. 

A note about Real and Protected mode:
During normal operation, the file server runs in protected mode. However, in 
order to access the local DOS partition to read the image file, the file 
server must switch to real mode each time a read request is processed. While 
in real mode, all normal file server activity ceases. Due to this frequent 
state switching, users may experience loss of keystrokes at the file server 
console if a key was pressed while the server was in real mode. These 
keystrokes are stored in a real mode buffer and will not be seen at the file 
server console. The higher the priority level, the more apparent this will 
become.  At the MEDIUM and HIGH priority settings, users may not be able to 
toggle between screens easily or type anything at the server console.  This
condition will disappear as soon as the file has been transferred and IMGCOPY 
has been unloaded.

***************************************************************************** 
                                 DISCLAIMER  
  
Novell, Inc. makes no representations or warranties with respect to any NetWare
software, and specifically disclaims any express or implied warranties of
merchantability, title, or fitness for a particular purpose.  

Distribution of any NetWare software is forbidden without the express written
consent of Novell, Inc.  Further, Novell reserves the right to discontinue
distribution of any NetWare software.

Novell is not responsible for lost profits or revenue, loss of use of the 
software, loss of data, costs of re-creating lost data, the cost of any 
substitute equipment or program, or claims by any party other than you.  
Novell strongly recommends a backup be made before any software is installed.   
Technical support for this software may be provided at the discretion of 
Novell.
*****************************************************************************