You've Got Files! User Manual v3.016

Feature	BASIC	Expiring DEMO	PROFESSIONAL	CORPORATE
Maximum Quantity of Directory Structures Monitored	2	5	100	Unlimited
Monitor Unicode/UTF-8 names on Local, Network and FTP Servers
Monitor Directories on Remote FTP Servers and SFTP Servers
Authenticate using AUTH or POP3 before SMTP
Email Multiple Email Addresses support Multiple SMTP Servers
Supports LaunchApplication
Configurable Subject for Email Messages
HTML formatting for Email Messages
Old File Detection,Old Folder Detection,Spawn Application
WhoDunIt Interface Support
Disable Last Line "You've Got Files! http://www.niwotnetworks.com"
BCC Email addresses supported

• Spurious emails from monitored ftp sites

As You've Got Files! is running, it keeps a record of the contents of your directories in order to know when new/changed files have arrived or deletions have occurred.
The program no longer generates spurious emails when a Ygf*Dir= value is changed,
but there are some other changes that can generate spurious emails:
A time change occurs on a monitored FTP site which does not report file times in UTC time.
A monitored FTP site changes the format in which it reports file times.

If you are monitoring an FTP site you may want to
First: Stop the You've Got Files! Service before the time change.
Second: Within your installation directory, delete the scandir*.txt and oldrdir*.txt files associated with the FTP site.
Third: Start the You've Got Files! Service after the time change.

Setting up EXCHANGE 2003 to allow You've Got Files! to send email:

(1)From System Manager: Expand to the Default SMTP Virtual Server

(2) Right Click the Default SMTP Virtual Server and select Properties:

(3)Select The Access Tab and click Relay:

(4)Click Add and enter the IP address of the machine on which You've Got Files!is running:

In this example 192.168.0.2

(5)Please Note that if the machine on which You've Got Files! is running is separated from the Exchange server by a proxy (one example would be a NAT(Network Address Translation) proxy) then Add the address of the Proxy as seen by the Exchange Server.

Running The Program

You've Got Files! runs as a Windows service. This means it runs unattended, whether or not any user is physically working with the computer on which it is running. It runs as a "background process" and as such has absolutely no user interface.

Services can be remotely administered. Windows offers a number of administrative tools that allow a service to be managed from other machines connected on the network so that you don't have to physically check the computer running the service. You are probably already familiar with the Services Control Panel. This is the primary interface to start, stop and administer You've Got Files!

• Starting/Stopping The Program

  For Windows 2000:

1) From the Start menu, select Settings -> Control Panel. The following Control Panel window will be shown:




2) Double-click on the Administrative Tools icon. The following Administrative Tools window will be shown:




3) Double-click on the Services icon. The following Services window will be shown. Scroll down to the bottom of the window and select the You've Got Files! service in the list:




4) To start the service, click on the You've Got Files! line with the right button of the mouse, and select Start from the popup menu that appears. Once the service is started, the Services window will look like so:



To stop the service, click on the You've Got Files! line with the right button of the mouse, and select Stop from the popup menu that appears.

• Schedule Starting and Stopping You've Got Files!

The ygf service may be started and stopped with the windows scheduler.
(these directions apply to Windows XP)
Start->Control Panel->Scheduled Tasks->File->New->Scheduled Task
You'll need to name the new task ("sched start ygf" is a suggestion)
Rightclick your new task->Properties
Run: net start ygf
Select when you want You've Got Files! to start,
you will be prompted with a username and password to use.

Similarly create a stop task ("sched stop ygf" is a suggestion)
Run: net stop ygf
Select when you want You've Got Files! to stop, you will be prompted with a username and password to use.

Please set the ygf service (in Services) to "manual" so it will not start when the machine reboots.

• Monitoring Windows Computers On Your Network

You've Got Files! has the ability to monitor not only the file system of the computer that it is running on, but also of other computers on your network. In order for this to work correctly, the service must be given the proper rights for your network to be able to log on as Administrator (or as another user with similar privileges to read from the file systems of other computers). All monitoring of Network-Mounted drives requires UNC paths. See Monitoring A Network-Mounted drive

  For Windows NT4:

1) From the Services window, double-click on the Startup button to bring up the Service window:




2) Select 'This account' and enter Administrator and password. Confirm the password and then click on 'OK'. The service will now be able to monitor the file systems of other network computers.




  For Windows 2000:

1) From the Services window, double-click on the You've Got Files! selection to bring up the Properties window:




2) Click on the Log On tab:




3) Select 'This account' and enter Administrator and password. Confirm the password and then click on 'OK'. The service will now be able to monitor the file systems of other network computers.

• Monitoring Linux Computers On Your Network

First, run Samba (or its equivalent) on your Linux machine. With Samba, client PCs running Windows NT4 or 2000 can access directories on the Linux machine using the SMB protocol which is the underlying protocol for Windows file sharing. You can verify whether Samba is already installed by running "rpm -q samba" in a Linux terminal window.

Second, make sure the directories on the Linux machine will allow the username/password you are using on the NT4 or 2000 machine to read the directories on your Linux machine. Samba directories are specified in the /etc/samba/smb.conf file.

Third, make sure you can read the directory on the Linux drive from your NT4 or 2000 command prompt. For example, suppose the Linux machine was named "widget7", the mountable drive was also named "widget7", and the directory you wanted to watch was "temp". In the ygfconf.txt file you would set:

Ygf*Dir=\\widget7\widget7\temp

You should be able to run "dir \\widget7\widget7\temp" from the command prompt. You might also mount \\widget7\widget7 as "L:" and test with Ygf*Dir=L:\temp. That should work as well.

Fourth, go to the services applet and set the "LogOn As" to the account and password that works to accessthe Linuxmachine.In NT4 this is Settings->Control Panel->Services->You've Got Files!.In 2000this isSettings->ControlPanel->Administrative Tools->Services->You've GotFiles->Log On Tab.

Fifth, stop the service and restart the service so it will use your new log on.

You can verify that You've Got Files! is examining the directory by double-clicking on the scandir1.txt file and viewing the directory contents.
See Monitoring A Network-Mounted drive

Program Log Files

You've Got Files! creates log files as it runs, in order to have a record of when it was active and what emails have been sent. The log files also record any errors that may occur. All log files will be found in the directory where You've Got Files! was installed. As the log files grow in size, they are archived and will eventually be deleted from the file system.


• The Run Log

The log file runlog.txt records information about the execution of the program and any errors that may occur. If the program was run for a period of time and no problems were encountered, this would be the typical output to this log file:

>>> Starting: You've Got Files -- version 2.201 [pid=155]
Time: Thu Sep 18 12:46:00 2002

Exiting: You've Got Files -- version 2.201 [pid=155]
<<< Time: Thu Sep 18 13:55:20 2002


• Errors Found In The Run Log


DEMO Expired, version 2.201 Niwot Networks 303-772-8664

This error will appear after the 30 day demo period has expired. Contact Niwot Networks for a valid Serial Number to continue using the program.


ERROR: unable to connect to remote host: yoursmtpserver.com

This error will occur if unable to connect to your SMTP server. The most common reason for this error is a bad or misspelled server name. Check the SmtpServerName entry in the ygfconf.txt file. Click here for an explanation of this entry.


ERROR: missing SmtpServerName in ygfconf.txt

This error will occur if the SmtpServerName entry is not defined in the ygfconf.txt file. Click here for an explanation of this entry.


ERROR: missing FromEmailAddress in ygfconf.txt

This error will occur if the FromEmailAddress entry is not defined in the ygfconf.txt file. Click here for an explanation of this entry.


ERROR: missing directory specification for Ygf*Dir entry in ygfconf.txt

This error will occur if a directory specification is not defined in the ygfconf.txt file. Click here for an explanation of this entry.


ERROR: missing email addresses/launch application for Ygf*Email entries in ygfconf.txt

This error will occur if both email address and launch application specifications are not defined in the ygfconf.txt file. Click here for an explanation of this entry.


ERROR: missing directory list in ygfconf.txt

This error will occur if Ygf*Dir and Ygf*Email entries are missing entirely from the ygfconf.txt file. Click here for an explanation of these entries.


• The Send Log

The log file sendlog.txt records the email messages that have been sent by the program. An example of typical output to this log file:

From: bobsmith@widgetworld.com
To: bobsmith@widgetworld.com
Subject: You've Got 1 File
Date: Fri, 5 Apr 2002 10:44:00 -0700
Added C:\Incoming\WidgetSales.doc
11/02/01 02:12p 19,822 bytes


• The FTP Log

The log file ftplog.txt records any errors that may have occurred during scanning of an FTP server. These errors may also be written to the runlog.txt file. Following is an example of an FTP error that might be written to these files:

FTP ERROR: 530 User johns cannot log in.


• Undeliverable Mail

During the course of running You've Got Files!, it is entirely possible for the SMTP server you are using to be unavailable for mail delivery due to any number of reasons, like network outage, maintenance, etc. What happens to undeliverable mail during these times?

You've Got Files! will keep track of all undeliverable mail (for 3 days) and resend it later when your SMTP server becomes available again. The messages that will queue up to be resent later can be found in the directory where You've Got Files! was installed. These message files will be named sequentially as follows: "msg1.txt", "msg2.txt", etc. The files will be removed once they have been successfully sent. Notice that the Date: field reported in the email will be accurate in regards to when the program originally found the new/changed file, which may be different from when it was able to send the email if delayed.

NiwotFtpTool

Adding Ygf*LaunchApplication=NiwotFTPGetTheFile.bat $file >>NiwotFTPGetTheFileLog.txt
will launch the sample batch file to invoke NiwotFTPtool
and retrieve the newly arrived file from ftp site ftp.yourdomain.com
using username "username" and password "password"
The example command line is :
ftp://username:password@ftp.yourdomain.com -sub %1 -log
Use the batch file as a template to move your ftp files.

There is also a sample NiwotFTPGetDelTheFile.bat that deletes the file after successfully downloading it.
The example batch file is :
REM Updated to pass file length to version 1.006 of NiwotFTPtool
REM ygfconf.txt Launch entry looks like:
REM Ygf1LaunchApplication=NiwotFTPGetDelTheFile.bat $file $length >>NiwotFTPGetDelTheFileLog.txt
mkdir getfolder
echo %1 %2
NiwotFTPtool ftp://username:password@ftp.yourdomain.com -sub %1 -len %2 -get .\getfolder -del -log

NIWOT NETWORKS, INC. NiwotFTPtool Ver 2.0.0.2
Copyright 2004-2007 All Rights Reserved
Usage: NiwotFTPtool ftpspec [options]
ftpspec ftp://[username[:password]@]urlroot[/subdir/][filespec]
   -sub [/subdir/][filespec] if using -get Alternate location for the ftp subdir
     and filespec
     if using -put then this is fulllocalpathname
   -len length of file in decimal (need this parameter to be zero to delete a
     zero-length file after getting)
   -get [localfoldername] Retrieve a file into the working directory or
     localfoldername if specified
   -put if not using -sub, fulllocalpathname to be uploaded to the FTP site
     if using -sub then this is the rootlocalpathname, the root of the local
     path being scanned by You've Got Files!
   -del with -get, Deletes the source file after verifying that a file with the
     desired name and size exists at the destination and was modified within the last 10 minutes.
     If you are getting to a UNC drive the time on the computer hosting the UNC drive must be within 5 minutes
     of the time on the machine on which You've Got Files! is running.

     -del is not recommended with -put, because it deletes the source file WITHOUT verifying
     that a file with the desired name and size exists at the destination.

   -exist returns 0 if the specified file has size >0,
    returns 6 if size zero,
    returns 7 if it doesn't exist

   -log Outputs NiwotFTPtoollog.txt and any scripts used
   You've Got Files! must be running for NiwotFTPtool to run
   Return 0 if a file was moved or -exist and non-zero length file found
   Return 1 if Command Line error
   Return 2 if couldn't get current working directory
   Return 3 if problem building Put, Get, or Delete script
   Return 4 if problem renaming or deleting
   Return 5 if You've Got Files! is not running
   Return 6 if -exist specified, file exists with length zero
   Return 7 if -exist specified, file does not exist
GET EXAMPLE: NiwotFTPtool ftp://username:password@ftp.yourdomain.com -sub /test/download.txt -get c:\getfolder
GET DEL UNC EXAMPLE: NiwotFTPtool ftp://username:password@ftp.yourdomain.com/test -sub download.txt -get \\servername\sharename\getfolder -del
PUT UNC EXAMPLE: NiwotFTPtool ftp://username:password@ftp.yourdomain.com -put \\servername\sharename\folder -sub \\servername\sharename\folder\test\upload.txt
PUT C: EXAMPLE: NiwotFTPtool ftp://username:password@ftp.yourdomain.com -put c:\folder -sub c:\folder\test\upload.txt

WhoDunIt Interface Support

WhoDunIt is a program suite purchased separately that may be driven by Demo and Corporate You've Got Files! licenses. With WhoDunIt installed, if the monitored location is on an NTFS local or UNC-accessible drive, the notification email may be set to include additional audit information on who was responsible for adding/changing/deleting your files and/or folders.

In order for You've Got Files! to drive WhoDunIt, WhoDunIt must be installed on the same machine as You've Got Files! and the program WhoDunItHostEnable must be successfully run once(Administrator required) directly on any machine that you wish to audit. Please see the WhoDunIt User Manual for instructions. Additionally, the ygf service must be logged in with sufficient priveleges to enable auditing on the monitored objects and to access the Security Log on the monitored machine.

There are 2 additional ygfconf.txt entries supported that may be added to a You've Got Files! configuration block to enable You've Got Files! to use WhoDunIt.
In the following example, we are adding WhoDunIt functionality to the Ygf1 entries in the ygfconf.txt configuration file:

Ygf1WhoDunItObjectEnable=1
Ygf1RetrieveInfo=WhoDunIt $file

Ygf1WhoDunItObjectEnable=1 causes You've Got Files! to call WhoDunItObjectEnable to enable auditing of the objects monitored in the Ygf1Dir specification.
Ygf1RetrieveInfo=WhoDunIt $file causes You've Got Files! to pass the notification object spec to WhoDunIt.exe and retrieve the returned information from the Security Log and include it in the notification email.

For the example of monitoring Deleted Files/Folders (but not Added or Changed):

Ygf1NotifyOnDelete=1
Ygf1DontNotifyOnChange=1
Ygf1DontNotifyOnAdd =1

An example email message containing WhoDunIt information might look something like:

Deleted: \\niwotd\ftp root\Robert\YgfExample.doc (time in UTC: 06/05/2007 10:31p) 164,576 bytes
Most Recent entry in Event log that has that file/folder: Thu Jun 07 10:17:47 2007 (local time on \\niwotd)
Object Name: F:\ftp root\Robert\YgfExample.doc
Primary User Name: NIWOTD$ Primary Domain: NIWOT_GROUP
Client User Name: Robert Client Domain: NIWOTD
Accesses: DELETE; ReadAttributes


A more verbose and detailed listing of all audit information may be obtained by adding -all to the RetrieveInfo specification in the following manner:

Ygf1RetrieveInfo=WhoDunIt $file -all

An example email message containing verbose WhoDunIt information might look something like:

Added: \\192.168.1.178\share\test\BIRD.WMF Thu Mar 31 00:00:00 1994 2,014 bytes
Thu Jun 07 10:36:19 2007 (local time on \\192.168.1.178)
Object Open:
Object Server: Security
Object Type: File
Object Name: C:\share\test\BIRD.WMF
Handle ID: 3732
Operation ID: {0,85672948}
Process ID: 1176
Image File Name: C:\WINDOWS\explorer.exe
Primary User Name: niwot
Primary Domain: NIWOT2
Primary Logon ID: (0x0,0xDE8A)
Client User Name: -
Client Domain: -
Client Logon ID: -
Accesses: DELETE
READ_CONTROL
SYNCHRONIZE
WriteData (or AddFile)
AppendData (or AddSubdirectory or CreatePipeInstance)
WriteEA
ReadAttributes
WriteAttributes
Privileges: -
Restricted Sid Count: 0


Thu Jun 07 10:36:19 2007 (local time on \\192.168.1.178)
Object Access Attempt:
Object Server: Security
Handle ID: 3732
Object Type: File
Process ID: 1176
Image File Name: C:\WINDOWS\explorer.exe
Accesses: WriteData (or AddFile)


Thu Jun 07 10:36:19 2007 (local time on \\192.168.1.178)
Handle Closed:
Object Server: Security
Handle ID: 3732
Process ID: 1176
Image File Name: C:\WINDOWS\explorer.exe

Uninstalling You've Got Files!

Please stop the "ygf" service before uninstalling You've Got Files!

You may uninstall You've Got Files! in one of two ways:

1.  From the Control Panel, run "Add/Remove Programs" and select You've Got Files! from the bottom of the list to remove.

OR

2.  From Start -> Programs -> Niwot -> Uninstall You've Got Files!

Change Notes

Version 3.016 changes since version 3.009:
1. Custom SMTP Port supported with SmtpPort=(Global) and Ygf*SmtpPort=(directory specific) feature.
2. You've Got Files! operation is suspended if available disk space in the installation directory falls below 30 million bytes.
3. You've Got Files! logging of insufficient disk space is suspended if available disk space in the installation directory falls below 6 million bytes.
4. ApplicationLogEvent.exe version 1.001 added to installation directory to support Application Event Log of insufficient disk space.
5. YgfGUI version 1.004 handles trailing spaces in ygfconf.txt and browses when you want to browse.
6. WhoDunIt Object Enable sets DELETE and FILE_DELETE_CHILD audit flags for directories with NotifyOnDelete or NotifyOnFolderDelete specified.
7. psftp.dll version 0.6.Niwot.1 supports VanDyke's VShell SFTP server and unicode file names.
8. SFTP interface supports file names over 128 bytes long and SftpAddKeyToRegistry settings over a service restart.
9. SFTP interface supports "Permission Denied" subdirectories. 10. Resent emails no longer contain the header of the email in the body.
11. Ygf*WaitBeforeSendingNextEmailInMinutes is no longer written as a default ygfconf.txt entry.

Version 3.009 changes since version 3.007:
1. CC: email address support with Ygf*CcEmail=
2. PASV mode to monitor FTP sites supported with Ygf*FtpPasv=1
3. Timeout before abort while waiting for Linefeed after an FTP LIST command increased from 1 second to 10 seconds.
4. Timeout before abort while waiting for a response to an FTP command increased from 15 to 30 seconds.
5. Case of characters in Ygf*Alias= specification now preserved.
6. "$path" in the Ygf*Subject= specification will be replaced with the path(Windows) or subpath(FTP sites).
7. YgfGUI version 1.003 allows new text placed into the comment field in the ygfconf.csv file to be preserved when the ygfconf.csv file is translated to a ygfconf.txt file.

Version 3.007 changes since version 3.006:
1. Demo version maximum number of configuration entries updated from 2 to 5.
2. Configuration file after installation now contains 2 entries. The new second entry is an example that accesses an FTP site.
3. YgfGUI.exe v1.002 now correctly handles configuration files with no comments and MFC71.dll is included.
4. Installer no longer creates Niwot program startup link to "YgfGUI Configuration Program".

Version 3.006 changes since version 3.005:
1. YgfGUI.exe configuration program translates "HTML" in ygfconf.txt to/from "_HTML_" in ygfconf.csv file.
2. Installer creates "YgfGUI Configuration Program" link in Start menu on upgrade.

Version 3.005 changes since version 3.003:
1. Addition of YgfGUI.exe -- You've Got Files! configuration program. With this release the YgfGUI is useful for translating the ygfconf.txt file to and from a csv format file.
2. Email Header/Footer file specification now accepts wildcards in the filename and UTF-8 files.
3. Last lines of ygfconf, header, and footer files no longer must end in a linefeed.
4. Experimental VisibleLaunch=1 global configuration option causes You've Got Files! to detect if it is running in a visible window, and if it is running in a visible window to hide itself unless it is launching an application.

Version 3.003 changes since version 3.000:
1. Passwords correctly recoded when serial numbers change .
2. New expiring serial number selects Basic, Professional, Corporate products.
3. ygfconf.txt final line is now correctly parsed even if it does not end in "newline".
4. Support for multiple AUTH or POP3B4SMTP SMTP servers when specified on a per-directory basis.

Version 3.000 changes since version 2.429:
1. Support for communicating with UTF-8 compliant FTP servers.
2. Support for non-standard port usage for FTP (normal is port 21).
3. Support for communicating with SFTP servers (new psftp.dll module).
4. Support for UTF-8/Unicode for local/mounted file systems. (new niwotdir module).
5. Expiring serial number.
6. Version upgrade of ygfconf.txt does not add unnecessary entries.
7. Email notifications are now sent with "-charset utf-8".
8. YGF service can be turned off much faster now.
9. Attributes are included in local/mounted file system scans.

Version 2.429 changes since version 2.425:
1. Add support for WhoDunIt, and configuration entries Ygf*RetrieveInfo and Ygf*WhoDunItObjectEnable.
2. Handle directory specifications even if they have a trailing slash.
3. BccEmail no longer overwrites the regular email address in the msg*.txt file.
4. Alias specification of file:// treated the same as Alias specification of http:// or ftp://, so that an alias of file:// may result in a clickable link in email.
5. Generated HTML links longer than 60 characters are preserved if Ygf*HtmlFormatEmail=1.
6. Blat.dll version 2.502 fix for excessive cpu usage/runlog when attempt to access SMTP server returns Windows error code 10093 (WSANOTINITIALISED).
7. Ygf*SpawnAppNoWait will Spawn even if no parameters are being passed to the spawned app.
8. Demo expiration extended to 30 days.

Version 2.425 changes since version 2.421:
1. ScanIntervalInMinutes may now be specified uniquely for each folder monitored. Ygf*ScanIntervalInMinutes overrides the global ScanIntervalInMinutes.
2. Ygf*OldFirstLevelFolderDetectInMinutes feature in Corporate and Demo may be used to detect when all the files within a first level folder are older than the specified number of minutes.
3. Ygf*SpawnAppNoWait feature in Corporate and Demo may be used to spawn applications and not wait for their completion before resuming You've Got Files! processing.
4. NiwotFTPTool Version 2.0.0.2 adds -exist feature to allow detection of a files existence. This allows a scheduled batch file to generate a notification if a specified file does NOT exist on the FTP site.

Version 2.421 changes since version 2.418:
1. Added the ability ignore an empty FTP site scan with the Ygf*NetworkSolutionsFtpServer feature. (The Network Solutions server farm occasionally erroneously reports that the hosted site is empty.)
2. Error "Day Mon DD HH:MM:SS YYYY FTP ERROR[34]: No List Data Received" written in runlog.txt when Ygf*NetworkSolutionsFtpServer=1 and an empty site scan occurs.
3. Added the ability to ignore file modification time changes with the Ygf*DontNotifyOnTimeChange feature.
4. Made Ygf*IncludeFilesNamed and Ygf*ExcludeFilesNamed work correctly with Ygf*OldFileDetectInMinutes.
5. Added the ability to send HTML-formatted emails with the Ygf*HtmlFormatEmail feature.
6. ygfctrl version 2.421 recovers if ygf.exe was running when ygfctrl.exe thought it was not running (previously required the customer to manually stop the ygf process from the Task Manager).
7. ygfctrl version 2.421 recovers if ygf.exe was not running when ygfctrl.exe thought it was running.
8. NiwotFTPTool Version 2.001 allows Put and Put+Del from UNC drives as well as local drives.
If there is no -sub parameter, then the -put specification is used as a complete path to a local/UNC file and the file is placed into the root of the FTP login.
If there is both a -put and a -sub parameter then the -sub parameter is used as a complete path to a local/UNC file.
The -put is taken as the local monitored root, and the folder structure below that monitored root is replicated on the ftp site.
9. NiwotFTPTool Version 2.001 Allow Get and Get+Del to retrieve files to UNC paths as well as local drives.
10. Blat.dll Version 2.501 based on version 2.50 from blat.net.
11. Blat.dll Version 2.501 Niwot Networks change to not display passwords, quote the username if it has unusual characters, and translate %20 to space in username.


Version 2.418 changes since version 2.416:
1. Increased speed of directory comparison..by an order of magnitude when the directory listings to be compared are megabytes in size.
2. Reduced processor time consumption from 90 per cent to under 10 per cent when comparing directory listings that are megabytes in size.
3. Added the ability to notify on a new folder or new directory with the Ygf*NotifyOnFolderAdd feature.
4. Increased the time to wait for a response from the FTP server from 5 to 15 seconds to accomodate slow links with large delays.
5. Added a copy of the serial number to the YouveGotFiles registry entry so we can recode passwords correctly on upgrades and on the transition from an expired demo to a production serial number.


Version 2.416 changes since version 2.415:
1. Restored ability of Corporate to monitor more than 400 directories. This ability was lost in the 2.411 change.


Version 2.415 changes since version 2.414:
1. Correctly handle FTP site that fails to respond for 5 seconds after we CD to a directory. Previously this resulted in spurious notifications.
2. OldfileDetectInMinutes now handles the Unix FTP site default of not specifying the year of modification if the file was changed in the last six months.
NiwotFTPTool Version 1.006 changes since version 1.005:
1. Now accept as input the length of the file (added -len parameter). Can now perform a Get and a Delete of a zero-length file from an FTP site


Version 2.414 changes since version 2.412:
1. Correctly handle FTP site that gives us a -250 banner after we CD to a directory. Previously this resulted in spurious notifications.
2. Correctly set reenter if Watchdog occurs or bad reply occurs after we CD to a directory. Previously this resulted in spurious notifications.

Version 2.412 changes since version 2.411:
1. Changed notification on OldfileDetectInMinutes so only 1 notification would arrive if the file was removed immediately after the first notification.
2. FTP client is now 5X faster.
3. FTP client spurious notification no longer occur when scanning a large local FTP site at high speed.
4. FTP client now treats "500" response as retriable.
5. FTP client now correctly scans sites with sub-subdirectory names that match the subdirectory of the original Ygf*Dir=ftp://username@ftp.sitename.com/subdirectory.
6. Installer stops the service (if it exists) before upgrading.

Version 2.411 changes since version 2.410:
1. Include/Exclude FileNames and FolderNames when performing OldFileDetect.
2. Handle Include/Exclude foldernames that include a "/" in the foldername.
3. Handled a case where a watchdog failure when accessing an FTP site results in spurious notifications.
4. Debug=16 Show Notification Triggers in notification.txt.
NiwotFTPTool Version 1.005 changes since version 1.003:
1. Overcame a problem with Windows FTP client not handling a space in a mget quoted spec correctly.
2. Wait for large files to complete.

Version 2.410 changes since version 2.409:
1. Eliminate trailing spaces in config values read from ygfconf.txt.
2. Quit printing internal Ftp Password in showconf.txt file.
3. Changed trailing cr-cr-lf "0D 0D 0A" to cr-lf "0D 0A" in FTP directory scan .
4. Debug=16 Show Notification Triggers in notification.txt.
5. Restored ability to not send a notification for a slowly arriving file until the file is identical in the two latest scans. If the user specifies DontNotifyOnChange then notification of a newly arrived file will occur when it does not exist in the oldest scan and does exist in the two latest scans, even if it is not identical in the two latest scans.
6. Removed a case where a new empty directory would generate a notification.

Version 2.409 changes since version 2.408:
1. Updated WaitBeforeSendingNextEmailInMinutes when OldFileDetectInMinutes>0 and the SMTP server is not available.
2. utcdir version 1.005 adds TIME: local time offset from UTC in the scandir listing for mounted drives and version 2.409 adds the TIME: local time offset from UTC in the scandir listing for FTP-accessible drives.
3. utcdir version 1.005 also now reports multi-gigabyte file sizes.
4. Detects that local time has changed from when the scan was done and rescans. This should eliminate one more cause of file change notifications due to time changes.
5. Corrected Parsing of email messages queued for re-sending, version 2.408 had the subject lines of re-transmitted emails overwritten by the first body line.
6. Corrected handling of FTP directory entries when an intermediate Ygf* had been commented out. This could cause a Dr. Watson crash on 2.408.
7. ScanIntervalInMinutes is back to having 60 seconds in a minute. It had been 10 seconds in 2.408 for diagnostic purposes.

Version 2.408 changes since version 2.406:
1. Repaired memory leak in versions using Mail Passwords (since in Version 2.400)
2. Ygf*EmailPriority new feature. Default is 1, Set =0 for low priority, 2 for high priority.
3. Ygf*OldFileDetectInMinutes new feature. Default is 0, Set = 1440 minutes for a day, 525600 minutes for a year.
For Windows accessible files, the file time is compared to the current time.
For FTP-accessible files, the FTP time is compared to the local time.
Selecting this feature causes DontNotifyOnChange and DontNotifyOnAdd to default to 1
OldFileDetectInMinutes is available on Demo and Corporate versions.
4. NiwotFTPTool updated to version 1.003 to improve downloading and deletion of files from FTP sites
(especially in conjuction with OldFileDetectInMinutes).
5. MailMultipleLinesPerFile new feature(global). Default is 0, so the email will now be formatted with one line
per file added, changed,deleted, or detected as Old. Set =1 to return to the old 3-line-per-file format.
6. Improved reporting of file time on Added, changed, and detected as Old files. We are now using
the local time of the file as reported by ctime instead of retrieving file time from "Dir" output
7. Changed default on FTP client to move up a directory from "CWD .." to "CDUP"
which is standard and is the only one allowed by Communigate FTP server.
Added Ygf*FtpDontUseCDUP just in case this change needs to revert to "CWD .."

Version 2.406 changes since version 2.404:
1. FTP directory lines that start with " Volume in drive " no longer appear in notification emails.
2. Fix Directory mismatch on scanning path whose specification did not end in "\"

Version 2.404 changes since version 2.403:
1. The only changes to ygf.exe and ygfctrl.exe were to update the version number to 2.404.
2. The previous InstallShield X installation inadvertently installed the Install Shield Update Manager, that was unexpected.
If you would like to remove Install Shield's Update Manager from your computer (Assuming the Update Manager is not being used by programs other than You've Got Files!):
A partial uninstaller is available from Install Shield at:
http://saturn.installshield.com/isus/310/sdk/uninstallupdatemanager.exe
Additional information is at: 
http://support.installshield.com/kb/view.asp?articleid=Q111106 After running the uninstaller and rebooting, you may want to delete the folder:
C:\Program Files\Common Files\InstallShield\UpdateService and its contents.

Version 2.403 changes since version 2.401:
ygfctrl.exe is version 2.403
1. Added Ygf*StalenessDetectInMinutes so Corporate users can monitor workflow folders and receive notifications of files that have remained in the folder for too long. On startup of Corporate, if a staleness has been specified and the current time minus the scandir*.txt time is less than staleness time, then the first scan is delayed until the staleness detect time has been exceeded.
2. Added Ygf*BccEmail so Corporate users can also send notification to a BCC list.
3. Added Ygf*IncludeFoldersNamed to enable users to monitor only folders that have the named folders in their path.
4. Added FTP client support of ephemeral ports 32768 and higher.
5. Clear text passwords converted to encoded text sooner.
6. The directory comparison engine now checks if the specification of the folder it is monitoring has changed between scans. If it is a different directory, changes are ignored until after the new path has been scanned three times.
7. Increased FTPAccept timeout from One second to 5 seconds and retried on FTP ERROR[12]: Error, Accept on DataSock = -8 SOCKET_ERROR=-8
8. CrushFTP rejected "CWD ../" and "CWD ../.." so now we do "CWD .." over and over.
9. CrushFTP occasionally loses the connection after we issue a "PORT" command. We now recover from that.
10. ygfctrl.exe better handshake with ygf.exe when stopping the service.
11. Attempting to start the service without username/password sufficient to write files in the Installation directory will now return Error 5 Access Denied.
12. The You've Got Files! installer is now built using InstallShield X. When installing over an earlier version, the user is prompted to first uninstall the earlier version.

Version 2.401 changes since version 2.400:
ygfctrl.exe is version 2.401
1. ygfctrl cleans up old kill*.txt files.
2. msg*.txt files deleted after 3 days, From, To, Subject and Date
written to runlog.txt with "Unsent Email deleted after 3 days:"
3. Expiration email tried to use POP3B4SMTP when should have used AUTH
4. Upgrades no longer lose P3B4SMTP and AUTH settings from ygfconf.txt files.
5. ygfconf.txt entries that are default and not required are not written to
ygfconf.txt files.
6. If you are monitoring an FTP site and Ygf*FtpPassword= is blank, "ftp" will be put in as the password.
7. NiwotFTPtool.exe version added to distribution, allows users
to retrieve newly-arrived files from an FTP site.

Version 2.400 changes since version 2.304:
ygfctrl.exe is still version 2.301

1. Added "AUTH" and "P3B4SMTP" authentication by way of the blat.dll
2. Added blat.dll version 2.2.2 modified by Niwot Networks to not print out password in debug mode. Removed Niwot's email-sending software.
3. Changed handling of output showconf.txt in debug mode, so only the last three parses of the ygfconf.txt are saved.


Version 2.304 changes since version 2.303:
ygfctrl.exe is still version 2.301

1. "\" at the end of Ygf*Dir=d:\ftp\ATTCreative\ or Ygf*Dir=\\Niwotdell1\Temp\niwoth\ will no longer get [ _stat is unable to obtain status info for this path ]
2. Fixed ygf.exe crash that could occur due to uninitialized smtpserver variable introduced in version 2.300.
3. Improved Ygf*AliasExclude= , the string after exclusion is now correct.

Version 2.303 changes since version 2.301:

1. When parsing an FTP directory name from an FTP server that returns info in MS-DOS
format we now space over 9 characters from "|DIR|" to find the directory name. This gets rid
of extra leading spaces in reported directory names, and lets ExcludeFoldersNamed work.
2. FTP username is now everything between "FTP://" and the rightmost"@" in the
Ygf*Dir= specifier. This allows support of usernames that contain the "@" sign
3. Alias modified to not insert %20 in place of spaces if the Alias
string does not begin with http://, ftp://, file://, or \\
(this item erroneously said "AliasExclude" in the first issue of this manual)
4. The change in 2.301 to the FTP format written to scandir*.txt resulted in occasional spurious change notifications, that has been fixed.
5. Installer now adds icons to read Ygfuserman.htm and Uninstall You've Got Files!
6. Installer now stops ygf service (if it is running), before installing new files.

Version 2.301 changes since version 2.300:

1. Now generate email time stamp offset by calculating the difference between localtime() and gmtime(). This will be more accurate than previous method.
2. ExcludeFoldersNamed now works at the first level when monitoring FTP sites.
3. ExcludeFoldersNamed now also works when NotifyOnDelete=1.
4. Improved handling of empty FTP directory.
5. Handle non-ftp directory specifications with and without an ending "\".
6. We now treat all FTP error code 550 "Action Not Taken" the same as error code 553 "Permission Denied" since all the FTP servers we have encountered that give us 550 codes are using them for access denied.
7. Remove leading and trailing spaces from include/exclude strings read in from ygfconf.txt.
8. Clarify in manual that ExcludeFoldersNamed, IncludeFilesNamed, and ExcludeFilesNamed are case insensitive.
9. Changed the format written to scandir*.txt when scanning FTP sites to make it editable with notepad.
10. Ygfctrl.exe version 2.301 now handles the possibility that currpid.txt could not be opened.

Version 2.300 changes since version 2.203:

1. Added YgfXSmtpServerName and YgfXFromEmailAddress to support multiple SMTP servers.
2. Added YgfXFtpDoubleLogin to support FTP servers that require an anonymous login before a regular login.
3. When the DontNotifyOnChange is selected and a file is both added and changing it will be reported as added.
4. When the SmtpServerName, FromEmailAddress, or EmailAddress is blank then we can still support Launch Application.
5. Added an error code to "cannot create socket" message when failed to send an email.
6. This version can handle FTP servers that generate a 125 DATA_CONNECTION_OPEN reply.
7. The EmailAddress field is limited to 511 bytes. The list of "To" email addresses must fit within 511 bytes.
8. New ygfctrl.exe version 2.300 checks that the service is not already running trying to rename the ygfactive.txt file which the running ygf.exe keeps open. This allows You've Got Files! to once again run on Windows NT.
9. New utcdir version 1.004 may now scan drive letter volumes from their root as well as UNC volumes from their root.
10. utcdir version 1.004 handles the case of a FAT32 mount returning a file first or a single file in FindfirstFile.
11. utcdir version 1.004 recovers from strange windows handling of a quoted incoming path where the last character in the path was a "\".
12. utcdir version 1.004 does not crash when the path length exceeds 255 characters.
13. utcdir version 1.004 limits the year to not exceed 9999 (Will this be a Y10K bug?).
14. utcdir version 1.004 will show hidden folders and hidden folder contents but not hidden files (more like Microsoft's dir).

The You've Got Files! License Agreement

NIWOT NETWORKS, INC.
ELECTRONIC END USER EXPIRING LICENSE AGREEMENT
FOR You've Got Files! (tm)

NOTICE TO USER:
THIS IS A CONTRACT. BY INSTALLING THIS SOFTWARE YOU ACCEPT ALL THE TERMS AND CONDITIONS OF THIS AGREEMENT.

This Niwot Networks, Inc ("Niwot Networks") End User Expiring License Agreement accompanies the Niwot Networks You've Got Files! SOFTWARE PRODUCT, related explanatory materials and "online" or electronic documentation ("Software"). The term "SOFTWARE PRODUCT" also shall include any upgrades, modified versions or updates of the Software licensed to you by Niwot Networks.

The "SOFTWARE PRODUCT" is defined as the contents of this installation package with the exceptions of:
blat.dll (see www.blat.net)
psftp.dll (see http://www.chiark.greenend.org.uk/~sgtatham/putty/licence.html).
Contact Niwot Networks for the Niwot modified source code for these 2 programs.

The SOFTWARE PRODUCT is licensed, not sold. Please read this Agreement carefully. Do not use the Software if you do not accept this Agreement. At the end of the license term you agree to renew your license or refrain from using the software.

Upon your acceptance of this Agreement, Niwot Networks grants to you a non-exclusive and non-transferable license to use The Software, provided that you agree to the following:

1. Use of The Software. You may install the Software on a hard disk or other storage device; You may also store or install a copy of the SOFTWARE PRODUCT on a storage device, such as a network server, used only to install or run the SOFTWARE PRODUCT on your other computers over an internal network; however, you must acquire and dedicate a distinct license for each operating system instance using the SOFTWARE PRODUCT from the storage device. Any given license for the SOFTWARE PRODUCT may not be shared or used concurrently or otherwise on different computers or different operating systems within the same computer in a given organization.

Without prejudice to any other rights, Licensor may terminate this Agreement if Licensee breaches any of its terms and conditions and Licensee has failed to cure such breach within 15 days of receiving the written notice of such breach. Upon termination, Licensee shall destroy all copies of the SOFTWARE PRODUCT.

If you have not purchased You've Got Files! and been provided a production serial number for this copy of The Software then this is a demo license and is licensed for 30 days from first installation on a computer.

2. Copyright and Trademark Rights. The SOFTWARE PRODUCT is owned by Niwot Networks and its suppliers, and its structure, organization and code are the valuable trade secrets of Niwot Networks and its suppliers. The Software also is protected by United States Copyright Law and International Treaty provisions. Use of any trademark does not give you any rights of ownership in that trademark. Therefore, you must treat The Software product like any other copyrighted material. Except as stated above, this Agreement does not grant you any inte