June 1997 (Release 1.0.0)
----------------------------

THE SOFT:

The main funcionality that SYNC.NLM has is to replicate or syncronize files
and directories betwen diferent servers in a WAN. The servers
can be 3.x or 4.x.
This NLM will be loaded only in the source server, that is to say,
the  server which has the files or directories to replicate.
The replicating process can be done to different servers or to source server
itself.

This zip contains the latest versions SYNC.NLM developed by Ariel Derenovsky.
All have been carefully designed to minimise memory usage, disk I/O and
server utilization. This program is Shareware.
  
If you like any of these programs and want to receive full program
(this include version with 40 jobs,not 2) and support ,free updates
and information about this NLM please send e-mail to "adere@hotmail.com"
with your name, e-mail,address.
And a reasonable donation of $ (dolars) not less $10,
plus to cover postage, handling and your gratitude to....
  
   Ariel Derenovsky
   Franz schubert 1513 
   Cordoba, cp(5000) , Argentina. 
   Telephone 0054-51-651941
  
Bug reports, suggestions for enhancements or new programs most welcome.

whith this , dont forgent to send e-mail to adere@hotmail.com



HOW  SYNC.NLM WORKS:

When you load SYNC.NLM , it ask you for a login, which has to have rights to
read and write in each target directory for all jobs submited.
(is better supervisor equivalent). This login and password will be used to
authenticate to all servers the jobs referred to, using the NDS.
In case there is  any 3.x server or a server belonging to another tree
(in the NDS), you will be asked for a bindery login name and password  for
each one.
After that, the message "job xxx submited" will appear on the screen.
This means that the jobs were succesfully submited.


The SYNC.NLM syncronize or replicate from source Server\vol\directory to
target Setver\vol\directory. Files will be copied only in case of differences
in date/time, size, or existence.


BEFORE LOADING IT:

Before loading it , you must make the configuration file. By default this
file is in sys:system\sync.cfg, but you can customize it, and tell NLM to
search it in other place, with the -CFfilename option.

e.g. :  load sync.nlm -Cfsys:personal\my_config.txt

You can make another file, used to list all users you want to be noticed when
some error has ocurred with any job, by broadcasting an alarm. This will
remember those users to verify the log file for errors.
You can tell to NLM to use this file with the option -Ufilename.

e.g. : load sync.nlm -Usys:users\list.txt

example of list.txt

type list.txt 

ctiad.infmgmt.us
john.marketin.sp
mike.hhrr.tmp.us



CONFIG FILENAME:

This file is used to submit jobs (maximum 2 in sharewar version, 40 when you
register it).
Each line is a schedule job, or a comment line , if is preceded by ';'.

The way to schedule a job is the follow:

day  time  target_server  source_files  target_directory   [option]

where

day = Monday,Tuesday, Wednesday, Thursday, Friday , Saturday , Sunday

         if you want to schedule a job for more than one consecutive day, you                     
        can put this: Monday-Friday , or Friday-Sunday. 
         if you want to schedule a job for days Monday, Wednesday and Saturday 
         you will have to schedules 3 diferent jobs.

time = The time you want the job begin (24 hours)  .  e.g. : 22:30

target_server = The server you want to replicate to.

source_files = fully path with files name (or * and ? simbols).

target_directory = directory in the target server in which files will be
            		syncronized

option = -NS meaning that you dont want to replicate subdirectories. By
  	    default, subdirectories are replicated. This is optional.


Schedule job example: 

Monday-Friday   14:30   california_fs1   sys:system\*.nlm   sys:system  -NS

Saturday   9:30  achaval_test   vol1:users\docs\*.*  sys:\users\LA\docs

Tuesday-Sunday   0:30  backup   sys:users\john\jobs.xls sys:\john\docs


SOME CONSIDERATIONS


- SYNC.NLM will syncronize up to 500 files per directory, by default. If you
 will need more files per directory , you can use -MFn option when you load
 it, where n means the maximum number of files per directory.

e.g. : load SYNC.NLM  -MF900     (allow you up to 900 files per directory).

- You have to take care to include the name of files(s) to syncronize
( or *.*) in the source_files parameter. If you forget this , you could have
some problems.

- SYNC.NLM make a log file in sys:system\logsync.txt with the information you
need to know what happen with each job. In case of errors , the log will
register them, and the user administrator, or those users that you have
configed in the user list (with -Ufilename option) will receive a broadcast
message.


HOW TO LOAD SYNC.NLM:

load SYNC.NLM  [-CFfilename] [-MFn]  [-Ufilename]

where:

-CFfilename -->  the fully path where config file is.


-MFn     -->  n is the maximum number of files per directory up to you can 			syncronize.

-Ufilename --> fully path where user list is located, used to send broadcast 			     messages. The names of users have to be distinguish names.


HOW TO UNLOAD SYNC.NLM:

unload SYNC.NLM will finish the program. Take care to unload it when no job is
running. This can cause some memory error (bad free memory)
Each time you unload SYNC.NLM , the log is cleared.





