Welcome To JR Sync...It's Free...It's Simple...It Works. 
Nov 10, 2006
No Guarantees are Expressed or Implied with the Use of This Application
October 27, 2007 V1.4
	Fixed Issue with file names containing invalid characters for Windows.
	File cannot be created on destination but a note will exist in the Log of this occurance.

For information on How to get the Source Code for this application please Email Admin@69swinger.com

Contents:
	Section 1 	Program Features
	Section 2	Setting Up Config File
	Section 3	How To Use The GUI
	Section 4	Command Line Options
	Section 5	Known Limitations And Bugs
End Contents


Section 1  Program Features

	JR Sync is a Visual Basic 6.0 Program that uses the file system object to scan folders and files.  File comparisons are based on last modified date. Folders and Files can easily be kept sychronized between source and destination with this utility. Either using the GUI or unattended mode VIA the command line JR Sync uses a configuration file that maps source and destination directories. After a successful Syncrhonization detailed results will be appended to Sync.log in the application directory.


Section 2 Setting Up Config File

	JR Sync uses a Config file whose parameters get loaded into memory. This configuration file details how the source and destination directories will be mapped together.  In addition provide whether or not Subdirectories should also be Sync'd. Comments in the file are preceeded with the # Character. The first character on each Mapping line should be a 1 or 0.  Zero specifies that Sub Dirs should NOT be Scanned. A One directs the program to scan all sub dirs under that base folder. The Following Two parameters are the source and destination directories which should be seperated by commas and enclosed in brackets.
EXAMPLE

1,[D:\Test\],[E:\Backup\Test\]

In that Mapping Line example Folders/Files in all subdirectories will be Sync'd between the source D:\Test
and the destination E:\Backup\Test.


Section 3 How To Use the GUI

	JR Sync uses a very simple GUI interface for instances of testing(to make sure the config file loads properly) and when Synchonizations are to be performed manually. This program looks for config.ini in the Application directory first, if it does exist it populates the text box with that file and it is ready to be Scanned for Consistancy.  If that is not the config file you want, or the default doesn't exist, press the browse button to locate an ini file of your choice.  When this is completed the Scan Config button should enable.  Press that button and the file will be scanned and parameters will be loaded into the display grid. The sync button will be enabled upon successful scan of the config file though, make sure everything is to your satisfaction first before continueing with that step. If you are ready press the Synchronize button. The Status box will display what is currently happening and the display grid will update letting you know which Sync Mapping it is currently working on.  When using the GUI error messages will display as popups on the screen and will also be written to Sync.Log in application directory.  The status message will say complete and all status lines of the grid should say 'In Sync' when the program finishes.  After it completes you may specify another config file to load and sync if nessisary.


Section 4 Command Line Options

	JR Sync may be executed from the command line if you want Sychronozations to happen behind the scences with Windows Task scheduler for Example. Two parameters are needed for this to complete succesfully. /A: and   /C: passed in that order. When the program sees a /A:True  it knows you want it to run in quiet mode.  The /C: tells it the location of the config file you want to use. No paths should be used as this file must exist in the same directory as the executable.
The entire command argument would look as follows:
Sync.exe /A:True /C:myconfig.ini


Section 5 Known Limitations

	JR Sync has a few limitations which may also be helpful to know.
	1) File names with special Characters such as  and 
		A) Windows should not let file names be created with these characters but it does occationally 		happen, especially when saving html documents with IE and dealing with other OS's such as Linux
	2) The config File can only contain a maximum of 200 Mapping Lines. If your file does have over 200 			this will not cause an error but Mapping lines after 200 will not be used.
	3) JR Sync was compiled with VB6 and can only be used with Windows2000/XP/Vista Based operating systems
	4) UNC Paths have not been fully tested, please only use drive letter designations.

Complaints and Bugs can be Submitted To Admin@69swinger.com  please include as much technical information as possible as this will help diagnose the root cause.

Thanks and Happy Synchonizing!
  
