I'm Sync'g 2.2a

Table Of Contents

About I'm Sync'g
Installation
Packages Window
Maintenance Window
Create/Edit Window
Settings Window
Un Attended Processing
Scheduled Processing
Schedule Window
Known Bugs
Updates
Registration
About ShareWare


! Striving for harmony in your files!


	About I'm Sync'g
Version 2.2a

I'm Sync'g is a Win95 shareware application that is designed to provide you with a simple method for keeping your files synchronized between directories and computers.
Using I'm Sync'g is simple.  Create a package, process the package.  During the package processing, you will be shown the process status for each file in the package.

For processing you have several options:

1	The Automate Processing Option is set for default to "Off"
2	The Verify Every file in the package Option is set to "Yes" or "No"  by you for every package to be processed.
3	You will also be asked to verify any directory creation during processing.
4	There is now a scheduling piece, which will allow you to pre schedule "On Startup, On Shutdown, Daily, Weekly, or Monthly (at the time of your choosing)" synchronization of your packages.

	There are other system settings available in the Settings Window.  Here you'll have the ability to turn "On" or "Off" system functionality.  Pieces of this functionality include the PopUp Help, application Registration, Sound, and Verify Exit.

	Installation

1	Copy the "ImSync22.zip" file into a temporary directory.
2	Unzip the "ImSync22.zip" into this temporary directory.
3	The files included should be:
	1	Iss.exe
	2	ImSyncg.exe
	3	ImSyncgSchedular.exe
	4	ImSyncg.hlp
	5	ImSyncg1.wav
	6	ImSyncg2.wav
	7	ImSyncg3.wav
	8	wilx32.dll
	9	witzsrch.dll
	10 wsrch32i.dll
	11 setup.exe
4	Run the setup.exe file and follow the on screen instructions.

NOTE:  If anything happens to any of the .dll files or any of the .ini files the ImSyncg.exe application will automatically re-create them.

	Packages Window

This window will allow you to process any or all of the packages that you have established.  In the packages window you'll see a list of the packages that you have built.  If this is the first time that you have run the I'm Sync'g application, there will be a "Demo Project" in the packages window.  The bracketed item at to the right of the package name is the package status.

The status' are as follows:

<Demo Project> - This is only for the Demo Project.
<New Project> - States that you have not processed this package since creation.
<Edited Project> - States that you have not processed this package since an edit.
<Last Successful Process Date and Time> - States that the last process was successful, and the date on which it was accomplished.

Buttons and their Functions:

Process Button - Begin processing the selected packages.
Maintenance Button - Change to the Maintenance Window.
Settings Button - Change to the Settings Window.
Exit Button - Exit the application.

	Maintenance Window

This window will allow you to perform changes on any of the packages that you have established.  In the maintenance window you'll see a list of the packages that you have built.  If this is the first time that you have run the I'm Sync'g application, there will be a "Demo Project" in the packages window.  The bracketed items to the right of the package name are the package Source One drive letter, the package Source Two drive letter, and the Subs setting.

Buttons and their Functions:

Create Button - Change to the Create/Edit Window to create a new package.
Edit Button - Change to the Create/Edit Window to edit the currently selected package.
Delete Button - Delete the currently selected package.
Options are Yes, No or Cancel
Cancel Button - Change to the Packages Window.

	Create/Edit Window


If you selected the Create Button in the Maintenance Window you will have a blank window here to fill in.  If you selected a package and then the Edit Button while in the Maintenance Window you will have this window pre filled with all of the data from the selected package.

Boxes, Buttons and their Functions:

Package Name Box - Enter the name of the package as you wish to see it in the Packages Window, and the Maintenance Window.  This name can be anything that you choose.  You can NOT have duplicate package names.
Source One Box - Enter the drive, and directory, (and filename if necessary) of the first area that you wish to have synchronized.  NOTE:  The directory name MUST end in a trailing slash.
Source Two  Box - Enter the drive, and directory, (and filename if necessary) of the second area that you wish to have synchronized.  NOTE:  The directory name MUST end in a trailing slash.
File Spec - The file spec is where you will enter the file name or extensions that you wish to have synchronized. example
Process Sub Dirs? - If you want the synchronization to recurs sub directories then place a check in the check box to indicate Yes.  A blank check box indicates No.
Look Button - Use the Look button to change to the directory browse window so that you may find the desired directory and/or file name.  There is a separate Look Button for each of the Source boxes.
Create/Edit Button - Once the data is entered for a new package, or changed for an existing package, use this button to record the specified changes.
Cancel Button - Change to the Maintenance Window.

	Settings Window


Buttons and their Functions:

Automate Processing - Removes all of the user prompts while processing any or all of the packages.  Options are Yes (checked) No (not checked)
Verify Exit - If you like being asked if you really want to quit set this to Yes.  Options are Yes (checked) No (not checked)
PopUp Help - The PopUp Help windows will be visible during the entire session if you so choose.  These small and brief help statements are designed to give you simple reminders regarding the functionality of the application.  Options are On (checked) Off (not checked)
Sounds - The system sounds are designed to provide you with audio notification of system events.  These sounds may be changed by replacing the sound files in the applications directory (see installation instructions) with others that you may have.  If the system does not find these files, it WILL NOT provide you with an error, the sounds just wont work.  Options are On (checked) Off (not checked)
	ImSyncg1.wav - package processing complete
	ImSyncg2.wav - application shut down
	ImSyncg3.wav - application start up
Registration ID - Once you have registered this application, you'll come here to the Registration ID box, enter the registration id provided, and you will then be asked to enter the registration number.  Once you have successfully entered the two components your application will be registered.
Record Button - Once you have the application options set the way that you like, Record them.
Cancel Button - Change to the Maintenance Window.

	Known Bugs

There are always bugs in every application, we are not above this rule.  We will try to make every effort to get you, the user, as much information as possible.

1.	There seems to be a refresh problem with the Window contents in the Maintenance Window.  When you Create a new package or Delete a package, the contents of the window do not always update.  One simple fix is to manually refresh this window by clicking the Cancel Button to return to the Packages Windowat this point the window contents will be refreshed.  If need be simply return to the Maintenance Window and continue your work.
2.	Related to the above problem, you'll find that when you Delete a package the application dies.  This does not effect the delete.  If you restart the application everything will be fine.
3.	The "On Shutdown" portion of the I'm Sync'g's Scheduler is not functioning, as of this release.

Please contact the author with any other bug reports that you may find.

	Updates

1.	There is a line limit in the array values that are being used to produce the package names and data for the Packages Window and the Maintenance Window.  This is not much of a problem unless you have more than 5 or 6 packages listed in these windows. Fixed in v1.5

2.	The Files Spec will now accept wild cards, in any format. ie:  filename.*, file*.ini, *.ini , *.* (required if all files is used) or a single file name, etc.  You can also use a combination of file extensions ie: *.old,*.bak,*.ini etc.

3.	I added the ability for Un-Attended Processing.  You may now create a shortcut to the executable file of the application and in the target line add the numbers of the packages that you wish to have Sync'd.  (Available ONLY to registered users)

4.	I added a button on the Verify File Box that will allow you to "Update From Most Current" with out having to manually compare the dates, and sizes of the files.  In the Verify File Box you still have the ability to update in either direction, or "Skip Current File".

5.	I added the ability for I'm Sync'g to synchronize files with specific attributes set.  Synchronization will now update files retaining their attributes.  NOTE:  If the Hidden attribute is found on a file that is in a directory that is to be Sync'd its hidden attribute will be removed (and not replaced).

6.	I have added the ImSyncgScheduling.exe, and ISS.exe.  These new pieces allow Registered users to schedule packages for "On Startup, On Shutdown, and timed synchronization".

7.	I fixed a bug that was reading the "Auto Process" packages statement.  This bug would process package 1 and 10 if it was told to process 10.  Now it only processes the appropriate pacakges.

8. I fixed a bug with the iss.exe being auto started when the windows shell starts.  The problem was with the reg key value.

9.	I added the ability to Un-Install to the installation program.

Scheduled Processing

The I'm Sycn'g Scheduler is an integrated part of the I'm Sync'g package.  The scheduler allows you to schedule package synchronization in several ways.  Packages can be scheduled to run;
1	"On Startup"
2	"*On Shutdown""
3	"Daily at hh:mm"
4	"Weekly at hh:mm"
5	"Monthly at hh:mm"

There are a few basic rules behind scheduling packages.

First, the package must have been processed at least one time prior to scheduling.
Second, the scheduler demon must be running.

The best way to get the scheduler demon running is to set it for "Auto Load".  The "Auto Load" option is activated by the Auto Load Checkbox.  Simply place a check in the box, and click the "Schedule Button".  This automatically start the demon every time you start your system.  Any time you start the "I'm Sync'g Scheduler", and the demon is not already running, the demon will start as well.

Buttons and their Functions:
Process Button - Select a package, and click the process button to process that package through I'm Sync'g.
Schedule Button - Select a package, and click the schedule button to see the Schedule Window options for that package.
Auto Load Checkbox - Simply place a check in the box, and click the "Schedule Button".  This automatically start the demon every time you start your system.
Exit Button - Exits the I'm Sync'g Scheduler, leaving the schedule demon running.

Any packages that are not "Sync'd" when they are supposed to be, (weekends when the system is off) will be automatically "Sync'd" the next time that this schedule demon is started.

	Schedule Window

Scheduling a package is simple.  Review the information at the top of the "Schedule Window".  The "Package Name" and "Last Sync'd" date are displayed so that your certain that your scheduling the proper package.

You have the "On Startup" and "On Shutdown*" check boxes that will allow you to set a package synchronization for Windows startup, and Windows shutdown.

To schedule a package to run "Daily", "Weekly" or "Monthly" you MUST enter a a time in the "Time To Run" box, and it MUST be in the format: hh:mm.  Once you have entered a time, select "AM/PM", and then select a "Frequency to Run".

The frequency schedule is based on the the "Last Sync'd" date.  For Example,  If the "Last Sync'd" date is TUE 01/27/98 12:25:02 PM and you create a schedule for "Daily" at 04:00 PM, the next Sync date will be WED 01/28/98 04:00:00 PM.  Based on the same "Last Sync'd" date a schedule for "Weekly" at 04:00 PM, the next Sync date will be TUE 02/03/98 04:00:00 PM.

To remove a schedule, simply un-check the "On Startup" and "On Shutdown" check boxes, and empty the "Time To Run" box.

After ALL or ANY of your selections have been made, click the "Save Button" to record the settings.  NOTE: All changes are effective immediately.

	Registration

We are offering this software as SHAREWARE!

Benefits to registration:
the start up time of the application is cut from 15 to 3 seconds
free email based technical support
free upgrades for the life of the product

Registration is very simple. 	$20 per copy.

Call for VISA/MC/AMEX or send check or money order to:

Quality Products and Services
41 Industrial Park Drive
Suite H
Waldorf, MD. 20602
United States of America.
301-893-2056 voice
301-893-2791 fax
http://www.qps.net/

WE DO REQUESTS
"Sorry No Web Based Ordering"

	Un Attended Processing

This is basically a command line option.  This option allows you to enter a number corresponding to the order of the packages in the Packages Window. Add the Package numbers that you want Sync'd to the command line of the I'm Sync'g application.  By doing this you will have the ability command line launch the application several ways:
1.	By creating a Batch File with the appropriate line.
2.	By creating a Short Cut with the appropriate Target Line.
3.	By entering the appropriate line in the Start - Run line or directly at the Command Prompt.

Command Line Example.

About ShareWare

Shareware is copyrighted software that is distributed by authors through bulletin boards, on-line services and disk vendors.

Shareware allows you to try the software for a reasonable limited period.  If you decide not to continue using it, you throw it away and forget about it. You only pay for it if you continue to use it. Shareware is a distribution method, not a type of software. You benefit because you get to use the software to determine whether it meets your needs, before you pay for it. 

The shareware system and the continued availability of quality shareware products depend on your willingness to register and pay for the shareware you use. It's the registration fees you pay which allow authors to support and continue to develop our products. Please show your support for shareware by registering those programs you actually use.

Even if the person who supplied you with the software tells you that registration is not necessary, be assured that if the copy of the program presents a screen reminding you to register, then the author has not been paid for that copy and registration is necessary.

The Association of Shareware Professionals (ASP).  ASP wants to make sure that the shareware principle works for you. If you are unable to resolve a shareware-related problem, the ASP may be able to help. The ASP Ombudsman can help you resolve a dispute or problem with an ASP member, but does not provide technical support for members' products.  Please write to the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442-9427 USA, FAX 616-788-2765 or send a CompuServe message via CompuServe Mail to ASP Ombudsman 70007,3536.

	Package:  A Package is simply the Source One and Source Two directories that you would like to have synchronized.  The Package also retains information such as Last Update, and whether or not you have chosen to process the Sub Directories recursively.

	Automate Processing:  This option will remove all user prompts, for all Packages processed while the setting is On.  The default setting is Off.  On or Off setting available in the Settings Window.

	Verify Every File in the Package:  The user is prompted when right before a Package is processed.  If the user answers No, the files in the Package will be processed with no user intervention.  However, if there are any directories that need creating, the user will be prompted for approval.
	If Automate Processing is set to On, the user will not receive the Verify Every File in the Package option, and the system will automatically attempt to create all necessary directories.

	PopUp Help:  Provides the user with a quick help window based on whatever screen the user is in.  It provides quick, simple, and VERY basic information regarding the active window.  The default setting is On.  The On or Off setting is available in the Settings Window.

	Verify Exit:  You will be asked if you really want to exit the application.  The default setting is On.  The On or Off setting is available in the Settings Window.

	Sounds:  The Sounds played by the system are more for announcement of where the application is in its processing.  These Sounds may be turned Off if the noise becomes to much for you to bear.  The default setting is On.  The On or Off setting is available in the Settings Window.

	Disclaimer: The supplier and author bear no liability to the licensee or any other person or entity for any damage or loss, including special, incidental or consequential damages caused by this product directly or indirectly.  The software is supplied "as is" without warranty of any kind, either expressed or implied. Warranties of merchantability or of fitness for any purpose are specifically disclaimed.

	Subs:  The Subs setting allows the user to specify whether or not the package will process all of the sub directories beneath the Source One and Source Two directories.
Note:  The Sub dirs settings has no effect when the package Source One and Source Two are set to directory and file name.

	File Specification Example:  
"*.*" or "*.exa,*.exb,*.axc" or "name.ext, name.*, nam*.ext"
Don't use quotes in the File Spec box!
(If need be, any combination may be used.)

	Command Line Example
This will work from the Run line, the Command Line, or in the Target Line of a short cut file.
"c:\program files\I'm Sync'g\ImSyncg.exe" 1,3,5

	On Shutdown:
The "On Shutdown" portion of the I'm Sync'g's Scheduler is not functioning, as of this release.

	Source One/Source Two directory.:  The source directories are simply the two locations that you wish to have synchronized.
NOTE:  The directories DO NOT have to be the same.
NOTE:  The file names DO NOT have to be the same.

	Author:
David Hopkins
dhopkins@vidtel.net
http://www.vidtel.net/~dhopkins/ 
ICQ:4355398
"Please feel free to contact me,
I love the feedback!"

