LogMaker Date & Time Utility Version 2.2 5-29-93 (c) 1992, 1993 DYNAMOUS Software. All Rights Reserved. 47 Kristin Dr. Rochester, NY 14624 Concept: Have you ever wondered if someone turned on your PC while you were not there? Is it hard to remember when you did that last backup of your hard disk? Do you know what other people do when they use your PC? Would you like to know if someone was looking at your personal information or financial data? What games do the kids play when you're not around and how long do they play them? If you'd like to know the answers to these questions you can install LogMaker on your PC to record the date and time these events occur. Introduction: LogMaker is a useful utility that keeps a record of when events occur. You can add LogMaker to a batch file or to the AUTOEXEC.BAT file. When you add LogMaker to a batch file, LogMaker will keep a record of: when a program was last used. conditions that occurred during the batch file execution. When you add LogMaker to the AUTOEXEC.BAT, LogMaker will keep a record of when the PC was booted. Usage: You can use LogMaker by executing the program by its name: C:\> LogMaker LogMaker will display the program information and then write a small informational file containing: LogMaker was executed at: 21:47:31 on 3/09/93 Option Usage: The following options may be used on the command line to change the defaults of LogMaker. This will allow you to use LogMaker for your specific needs. C:\> LogMaker /f:[d:\]filename.ext /t:"Text comment" /m:o /l:lines Where: /f:[d:\]filename.ext The name of the log file that LogMaker will write.[d:\] can be used to specify another drive or directory. Example - /f:c:\logs\database.log Default - logmaker.log in the current directory. /t:"Text comment" The text comment to be written in the log file. If the text contains spaces, you must enclose the text in double (") quotes. Example - /t:"The Database was last packed on:" Default - LogMaker was executed at: /m:o Use 'o' for the overwrite mode. The log file will contain only one entry, which will be the last time LogMaker was executed. Default - No switch will append the new entry to file. /l:lines Use 1 through 99. * This limits the number of lines LogMaker will maintain in the log file. Example - /l:25 {The number of lines in the log file will not exceed 25 lines.} Default - The number of lines in the log file will be unlimited. Note: Item marked with the '*' are only availible after registering LogMaker with DYNAMOUS Software. You will also receive a configuration program to store your default configuration and enable the registered options. Example Using Options: If LogMaker is in your PATH you can execute the program from any directory. If it is not in your PATH you must change to the directory on your hard disk where you keep LogMaker. For more information concerning your PATH or the TYPE command, refer to your MS-DOS manual. At the MS-DOS prompt type: C:\UTIL\> LogMaker /f:c:\bbs.log /t:"Node 1 was started at:" After the example executes, use the DOS "TYPE" command to view the log file: C:\UTIL\> TYPE c:\bbs.log MS-DOS will display the contents of the log file. Node 1 was started at: 17:39:23 on 2/19/93 Error Levels: LogMaker will return an error level after it executes. The following list shows the error levels and their meanings. Errorlevel 0 -- The error level is set to 0 if the program executed successfully. Errorlevel 1 -- The error level is set to 1 if the user enters an invalid option or /? /H help requested. *Errorlevel 2 -- The error level is set to 2 if an error occurs opening or writing to the log file. *Errorlevel 3 -- The error level is set to 3 if the program cannot find enough memory. *Errorlevel 4 -- The error level is set to 4 if the requested log file name is not a valid DOS file name. * NOTE: LogMaker will display an error message when these conditions occur. Sample Batch File: This batch file shows the usefulness of LogMaker, the use of the options and the use of error levels. @echo off c:\util\tape.exe /full if not errrorlevel 0 goto ABORT c:\util\LogMaker /f:c:\logs\backup.log /m:o /t:"Last backup was completed successfully on:" if not errrorlevel 0 goto BADLOG goto END :ABORT c:\LogMaker /f:backup.log /t:"An Error occurred during the last backup on:" if not errrorlevel 0 goto BADLOG goto END :BADLOG echo Unable to create or write to log file. Check usage or disk space. pause :END This BATCH file will execute a backup program called TAPE. When the backup finishes successfully LogMaker will write a new log file deleting any existing log file of the same name. If LogMaker is successful writing the new log file, BACKUP.LOG in the directory C:\LOGS, the batch file will end. BACKUP.LOG will contain: Last backup was completed successfully on: 21:15 on 03/11/93 If the backup program cannot complete successfully LogMaker will add a new entry to an existing log file of the same name. BACKUP.LOG will contain: Last backup was completed successfully at: 21:15 on 03/11/93 An Error occurred during the last backup at: 20:30 on 03/12/93 If LogMaker is unable to write the log file for any reason, a message will be displayed to the screen and the batch file will pause. For more information concerning BATCH files, refer to your MS-DOS manual. Shareware Notice: You may use this utility for a 30 day trial period. If you do not register within the trial period, please discontinue using this software. If you like this utility please consider registering LogMaker with DYNAMOUS Software. You will receive a registered copy of LogMaker and LMcfg to personalize your copy. This enables the 'registered options' and allows you to change the program defaults. The registration code allows you to download and register future LogMaker versions with no addition registration fees! We also include other shareware utilities we have written. To register, please send $5 (US) plus $3.50 (US) for media and US mailing to DYNAMOUS Software. If you wish to avoid the media and mailing costs, register with DYNAMOUS and then you may download your registered version on: "The Hat's Place BBS" (716) 594-5572 16.8K USR HST Dual Standard Multiple copies and site licenses discounts are available by contacting DYNAMOUS Software for more information. A site license is required by a corporation, company, educational institution, or governmental agency for use of DYNAMOUS Software's executable programs, LogMaker and LMcfg on the total number of computers that will use the software. Use of DYNAMOUS Software's executable programs for personal use is covered by your purchase of a single registration for LogMaker. No part of this software publication may be copied, reproduced, transmitted, transcribed, stored in a retrieval system, or translated into any other language or computer language in whole or in part, in any form or by any means, whether it be electronic, mechanical, magnetic, optical, manual or otherwise, without prior written consent of DYNAMOUS Software. DYNAMOUS Software grants the permission to allow shareware distributors the right to distribute our software as long as all our software documentation is included with the executable programs. Fees charged by the distributor must clearly explain that the those fees do not include program registration with DYNAMOUS Software. DYNAMOUS Software disclaims all warranties as to this software, whether express or implied, including without limitation any implied warranties of merchantability, fitness for a particular purpose, functionality, data integrity or protection. MS-DOS is a trademark of Microsoft Corporation. Trademarks of other companies mentioned in this documentation appear for identification purposes only and are the property of their respective companies. DYNAMOUS Software - 47 Kristin Dr. Rochester, NY 14624