SINC32+ (a.k.a SINC32plus) Copyright (c) 2004 Tzunghsing David Wong $Revision$ $Date$ $Log$ 1.0 What's New Crontab and log file can now be changed at run-time. No need to shutdown SINC32+. 2.0 About SINC32+ SINC32+ is designed to be a free scheduling utility for the Win32 environment. Based on SINC (sinc.sf.net) from SourceForge, SINC32+ adds additional functionality and flexibility. It supports standard crontab format with extension to support Win32 environment. Purpose of SINC32+ is to build a simpler, smaller, and better scheduling utility for Win32 environment. 2.1 SINC32plus.zip Contents SINC32+ is distributed with the following files: - README.txt - this readme file - HISTORY.txt - a brief history about changes made in SINC32+ - LICENSE.txt - the GNU GPL which SINC32+ is distributed under - help.html - the help file in HTML format - sinc32.exe - the executable application - sinctab.stf - an example crontab file - test.bat - a batch file to be used as test job If any of these files are missing from your distribution, please contact the project administrator. This program is licensed under the GNU GPL and is free to distribute, use and modify. 3.0 SINC32+ Setup Place the SINC32+ executable in any directory you wish. Place the test.bat file in the same directory if you're going to be running the included crontab file. The default location for the crontab file is in the same path of the EXE, but that can be changed by invoking SINC32+ with the -f switch and specifying a full path to the crontab location. 4.0 Sinctab Sinctabs are similar to crontabs but contain some differences. SINC32+ will match a * in a crontab to any available time, and it can read a comment line indicated by a line starting with the '#' character and is able to recognize a blank line. All jobs to be run must be listed after the five time-placeholder as a command line with optional command line parameters on the same line. In addition you can prefix each entry with the plus sign (+), indicating that this job will be executed just once. There are several extensions built into SINC32+. Please see the sample crontab, sinctab.stf, for detail description. At the moment Sinc can only run existing executable files, that is it can't run entry such as dir *.tmp > tmp_list.txt (dos shell commands). In this case you must create a batch file with all the command you need, and add an entry in the crontab file, pointing to this file. Finally Sinc32plus will re-read the crontab file if it detects that file has been modified since last run, so that you can edit the crontab freely without stopping the program. If you think this feature is time consuming (or other) and you prefer to have sinc read sinctab just once, write an e-mail to authors. From left to right the time fields are: - minute - hour - day of month - month of year - day of week Each must contain a integer number or a * indicating any value The example sinctab is as follows: # this is an example sinctab file * * * * * test.bat 02 4 * * * test.bat 22 4 * * 0 test.bat 42 4 1 * * test.bat 4.1 User Interface You can run sinc32.exe by dbl clicking the exe from the Explorer (then using the default sinctab.stf file) or by the dos prompt (in this way you can pass -f to use other sinctab files and/or pass a -d parameter to create a console for verbose output/debug purpose). To stop the program use the right click pop-up menu on the icon on the tray bar. Should someone prefer to add an entry to the win registry to launch Sinc32plus at start-up: [HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Run] "Sinc32plus"=":\\\\sinc32.exe [command parameters such as -f]" 5.0 Credits (SINC32) Sean Campbell - Preliminary design and development of version 0.9 Tyrell Kumlin - Development assistance with version 0.9 Talucci Andrea - Port of SINC32 from console to Win32 - primary coding of version 1.0 5.1 References (SINC32+) - Sample code of "Multithreading Applications in Win32", Jim Beveridge & Robert Wiener (multithread) - Sample code of "Programming Windows 95", Charles Petzold - Adding Windows To Your Console Application, Xiangyang Liu, http://www.codeproject.com/win32/winconsole.asp (DialogBox) - theForger's Win32 API Tutorial, Brook Miles (theForger), http://www.winprog.org/tutorial (DialogBox) - Online MSDN Library, http://msdn.microsoft.com/library/default.asp (MenuItem & Windows API) 6.0 SINC32+ Licensing This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. 7.0 Revision History: See "HISTORY.txt" for details.