Share Gallery 1

home *** CD-ROM | disk | FTP | other *** search

/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / DT / DT031.ZIP / ORGANIZE.DOC < prev next >

Wrap

Text File | 1991-10-10 | 60KB | 1,274 lines

ORGANIZE Version 2.12 User's Guide ┌─────────┐ ┌─────┴───┐ │ (R) ──│ │o │────────────────── │ ┌─────┴╨──┐ │ Association of │ │ │─┘ Shareware └───│ o │ Professionals ──────│ ║ │──────────────────── └────╨────┘ MEMBER ┌──────────────────────────────────────────────┐ │ │ │ ORGANIZE │ │ │ │ Daily Appointment Calendar │ │ │ │ Version 2.12 │ │ │ │ User's Guide │ │ │ │ Revised May 7, 1991 │ │ │ │ │ │ │ │ <c> COPYRIGHT 1988, 1989, 1990, 1991 │ │ by DAVID H. PRITCHETT │ │ │ │ ORGANIZE your daily routine ! │ └──────────────────────────────────────────────┘ ORGANIZE Version 2.12 User's Guide - Page i PREFACE - ORGANIZE USER'S GUIDE DISCLAIMER This manual may not be copied or distributed wholly or in part by any person or persons except under the provisions set forth in APPENDIX D. The author reserves the right to modify and/or change the information in this manual or the structure of ORGANIZE at any time. The author does not warrant this software to meet the individual requirements of any user. Fitness for use shall be determined by trial operation by the user on the user's hardware. Although ORGANIZE has been tested thoroughly and debugged as deemed necessary, no performance guarantee is offered or implied by the author. The author shall not be held responsible for inconvenience or loss to data, hardware, or other software operated in conjunction with ORGANIZE. Compatibility with memory-resident software packages is not guaranteed. The author shall not be held responsible for lost profits, lost savings, or other incidental damages arising out of use or inability to use ORGANIZE, or for any claim by any other party. You may NOT alter, disassemble, decompile, or otherwise change the code contained in the .EXE files supplied with ORGANIZE. ORGANIZE may not be leased, rented, or sold to others for profit. You may copy the files for backup purposes and for free distribution to others provided that charges (if any) do not exceed the actual cost of the disk and copying service. The copying charge in any event may not exceed $10.00 US. Operators of BBS systems may post ORGANIZE for downloading by users without written permission as long as there is no per file charge for the privilege of accessing the file. A charge may be levied for the privilege of using the BBS, but not for access to ORGANIZE. In any event, copying is allowed only in the original unmodified format with all files intact. The following files should be on the distribution disk, preferably in an ARC or ZIP file format. ORGxxx.EXE ORGANIZE main program CONFIG.EXE Configuration utility CONFIG.ORG Configuration data file HELP.ORG ORGANIZE on-line-help ORGANIZE.DOC This manual ORDER.FRM Order blank ORDER.BAT Prints order.frm on printer TICKLE.EXE Tickler program for autoexec.bat OMBUDSMAN.DOC Explains ASP problem resolution VENDOR.DOC Notice to Shareware Distributors Shareware and Disk Distributors: Please complete and mail the release form in Appendix D so that I can track distribution and provide updates. ORGANIZE Version 2.12 User's Guide Page ii NEW PRODUCT BULLETIN Version 2.12 Now includes the following new features !!!! LASER SUPPORT ORGANIZE now supports the HP LASERJET II/III !! A new CONFIG routine allows you to select IBM GRAPHICS PRINTER or HP LASERJET series printers. Now you can print your calendar on either an IBM/EPSON printer or the HP LASERJET. IMPROVED VIEW SCREEN Also in Version 2.12 is an improved VIEW screen. Previously, the view screen allowed you to move around the screen in quadrants. The new release 2.12 paints the calendar as it would appear on the printer and allows you view any part of the calendar on-screen by pressing the arrow keys and home, end, PG UP, and PG DN. TICKLE UTILITY This utility is now included as a normal part of the shareware release. This utility can be called from your autoexec.bat file and will remind you at boot-up of those important appointments that you need to attend to. TICKLE also prints a pocket reminder that you can carry throughout the day. WE THANK YOU FOR YOUR SUPPORT !! ORGANIZE Version 2.12 User's Guide (This page was intentionally left blank) ORGANIZE Version 2.12 User's Guide TABLE OF CONTENTS SUBJECT PAGE -------------------------------------------------------------- ---- PREFACE ...................................................... i BULLETINS .................................................... ii INTRODUCTION ................................................. 1 A word about shareware ................................... 1 Registration information ................................. 1 ORGANIZE - VERSION 2.12 ...................................... 2 Features currently in VERSION 2.12 ....................... 2 MINIMUM HARDWARE REQUIREMENTS ................................ 3 QUICK START (For those who would rather read the manual later)........ 3A INSTALLATION AND OPERATION ................................... 4 Modifying the default setup .............................. 4 Selecting the window colors, path, and printer font ...... 4 Specifying a default notefile directory .................. 5 About the config file .................................... 5 Selecting the sound option ............................... 6 USING ORGANIZE ............................................... 7 Command summary .......................................... 7 Printing the calendar .................................... 8 Opening the notepad ...................................... 8 Sample screen and description ............................ 9 Using the VIEW Mode ...................................... 9A TECHNICAL ASSISTANCE AND MODIFICATIONS ....................... 10 How to obtain help with operation ........................ 10 User suggestions ......................................... 10 APPENDIX A - USING THE TICKLER UTILITY ....................... 11 APPENDIX B - PROBLEM SOLVING ................................. 12 Error 203 ................................................ 12 Color choices don't change after running config.exe ...... 12 Problems with printed output ............................. 12 ORGANIZE can't find the CONFIG.ORG file .................. 13 Printer won't respond .................................... 13 APPENDIX C - RUNNING ORGANIZE FROM MULTIPLE DIRECTORIES ...... 14 Methods of running ORGANIZE .............................. 14 Creating a batch file to call ORGANIZE ................... 14 APPENDIX D - DISTRIBUTION OF THIS PROGRAM .................... 15 Copying and distributing ORGANIZE ........................ 15 Distributor release form ................................. 15A APPENDIX E - CHANGES IN Version 2.12 ......................... 16 Revision History ......................................... 16 What's new in Version 2.12 ............................... 18 CREDITS Thanks to those who helped ............................... 20 ORGANIZE Version 2.12 User's Guide - Page 1 INTRODUCTION ORGANIZE was designed to help you keep up with important appointments, birthdays, deadlines, etc. We all seem to be driven by schedules and notes scribbled on bits of paper and envelopes (not to mention those confounded little yellow stick-notes that clutter up the walls and desks of corporate America). ORGANIZE allows you to easily enter and revise schedules and appointment dates in a convenient form and refer to them at any time. ORGANIZE prints an attractive calendar on any IBM/EPSON <TM> or HP Laserjet compatible printer, complete with daily notes printed right in the calendar blocks. Now you can make an appointment days or months into the future and ORGANIZE will remember it for you ! A WORD ABOUT SHAREWARE ... ORGANIZE IS NOT FREE SOFTWARE ! It is NOT public domain. The program and supporting documentation are distributed on disk as a Shareware product. For those who are not familiar with the concept, Shareware software products are created by authors who feel that users should have an opportunity to try a product before purchasing it. If after trying the product for a short period you find it useful and wish to continue using it, you should then mail the author a contribution in the amount specified in the documentation supplied with the program. At that point you become a registered user. The contribution entitles you to a license to USE the software, not owner- ship of the actual code. Ownership of the code remains with the author. The low overhead costs associated with Shareware enable commercial-grade products to be offered at very low prices. Advertising is accomplished through word-of-mouth and distribution is handled through bulletin boards and shareware vendors who graciously duplicate the disks for a small fee. If you choose to continue using ORGANIZE please mail a $25.00 contribution to the author at the following address: David Pritchett P. O. Box 7273 Macon, Georgia 31209-7273 Your contribution will be acknowledged by return mail and your name, address, and date of purchase will be filed for registration. You will receive the latest production release. THE ORDER FORM IS CONTAINED IN THE FILE ORDER.FRM. You may print the order form by typing ORDER at the dos prompt. The form will be printed on the line printer by the batch file ORDER.BAT. ORGANIZE Version 2.12 User's Guide -Page 2 ORGANIZE - REGISTERED VERSION The registered version is at level 2.12 at the time of this writing. New features are being added constantly. When you register, you will receive the latest full-featured version along with a PRINTED MANUAL. LICENSE AND REGISTRATION Registration is not optional. If you continue to use the program after a reasonable evaluation period (suggested trial period is 30 days), you must register. The user is granted a license to use the software for evaluation purposes only for a period of 30 days, after which you must register the software or delete it from your system. You may pass the shareware version on to someone else for evaluation, provided the original files are copied intact and complete, including this documentation file. Continued use without registration is a violation of U.S. copyright law. ORGANIZE Version 2.12 User's Guide - Page 3 MINIMUM HARDWARE REQUIREMENTS Computer: IBM PC/AT/PS2 or 100% compatible. Memory : 256K Minimum (ORGANIZE uses about 80K of this) Printer : IBM GRAPHICS/EPSON or HP LASERJET ORGANIZE utilizes Turbo Pascal <tm> direct video screen writing for windows and thus requires true IBM compatibility. Display type is sensed automatically. Most DOS machines meet this requirement. Your line printer should support EPSON/IBM Graphics Compatible condensed and/or super and subcript operation. This is selectable in the configuration file by selecting MICROPRINT. CONFIG.EXE will allow selection of screen color combinations and print types. The HP Laserjet microprint mode utilizes the standard line printer compressed font (16.7 CPI). ORGANIZE is written in TURBO PASCAL 5.5 <tm> ORGANIZE Version 2.12 User's Guide - Page 3 QUICK START INSTALLATION INSTRUCTIONS ORGANIZE is supplied in a compressed format (usually in ZIP format). Before the program can be run, the files must be extracted from the archive file. To do this, type one of the following ... Method 1 - TO RUN FROM A HARD DISK 1. First, create a directory on the hard disk named ORGANIZE and copy the archived file and the unarchive utility to it. TYPE--> MD C:\ORGANIZE <return> TYPE--> COPY ORG212.* C:\ORGANIZE TYPE--> COPY PKUNZIP.EXE C:\ORGANIZE 2. If the ORG212 file has an ARC extension ... TYPE--> PKXARC ORG212 C:\ORGANIZE <return> 3. If the ORG212 file has a ZIP extension ... TYPE--> PKUNZIP ORG212 C:\ORGANIZE <return> 4. Now set up the configuration TYPE--> CONFIG <return> (This is optional) (The default setup should run) 5. To run ORGANIZE TYPE--> ORG212 <return> Method 2 - TO RUN FROM FLOPPY 1. Copy the distribution diskette TYPE--> COPY A:ORG212.ZIP B: <return> 2. Put a diskette containing PKUNZIP.EXE in A: TYPE--> PKUNZIP B:ORG212 B: <return> 3. Change to the B: drive to run TYPE--> B: <return> 4. Configure the program TYPE--> CONFIG <return> (This is optional) (The default setup should run) 5. Run ORGANIZE TYPE--> ORG212 <return> ORGANIZE Version 2.12 User's Guide - Page 4 INSTALLATION AND OPERATION NOTES No modifications are necessary to run ORGANIZE. The default setup will run with no changes. The window colors and backgrounds are selectable by running the configuration utility CONFIG.EXE. The configuration utility allows you to select color combinations for foreground and background colors as well as the type of calendar print font, default directory and sound options desired. If the default color setup is not satisfactory on your monochrome monitor, run the configuration utility and experiment with the color choices until you obtain optimum contrast. NOTE: The file CONFIG.ORG must reside in the directory from which ORGANIZE is called. DOS does not automatically search the default path for data files. If you invoke ORGANIZE from another directory, create a batch file which changes to the directory in which ORGANIZE is located before it calls ORGANIZE. This allows ORGANIZE to find its CONFIG.ORG file at startup. If this is not done, ORGANIZE will begin with a standard color setup and will create a new notefile in the directory where it is called. (See appendix C). MODIFYING THE DEFAULT SETUP From the DOS prompt, type CONFIG and press <RETURN>. The configuration utility will load and run. Instructional prompts are presented on-screen as you make choices from the menu. Available choices are as follows: SELECTING A WINDOW COLOR To select a window for color selection, press 1 - 5. This will place the cursor next to the appropriate selection. The color selection for each window may be varied using the left/right/up/down arrow keys. As you change the foreground and background colors the result is displayed on screen. When you are satisfied with the color combination press <RETURN>. <1> Selects CALENDAR colors. <2> Selects NOTEPAD colors. <3> Selects DAYNOTE colors. <4> Selects BORDER colors. <5> Selects HELP colors. SELECTING THE PRINTER FONT. To toggle from micro-print to condensed select 6. The printer font will toggle on-screen as you repeatedly press <6>. Choices are <Condensed> and <MicroPrint>. Both fonts allow eighteen characters per daynote line within the calendar block. Condensed print is larger vertically than microprint and allows for easier readability. Microprint is derived from the super/subscript feature of the IBM/EPSON printer family and occupies the same horizontal space per character as condensed, with a shorter vertical character height. ORGANIZE Version 2.12 User's Guide - Page 5 SPECIFYING A DEFAULT NOTEFILE DIRECTORY. To specify a directory other than the current directory, press <7>. The directory selection allows you to tell ORGANIZE where the NOTEFILE (Notefile.org) is located. This feature allows you to run ORGANIZE from any directory while storing data in the same file each time. If you desire, you may enter a period (.) in the directory selection. The period tells ORGANIZE to look for the file NOTEFILE.ORG in the current directory. Should the notefile not exist, ORGANIZE will create it. If you are specifying a drive other than the default drive, enter the drive designation followed by a period (EX: A:. ) and ORGANIZE will utilize that drive instead. Since it is desirable to store data commonly in one file, I suggest that you place ORGANIZE in its own directory and configure the notefile path to that directory with the CONFIG.EXE utility (place a period or the full pathname in the path entry) . This will eliminate any confusion from multiple calendar notefiles. (See Appendix C for more information). TO RUN ORGANIZE FROM YOUR DEFAULT PATH DIRECTORY EXAMPLE: If your DOS files are located in \DOS, load ORGANIZE and its associated files into the \DOS directory. Use the following command sequence to configure ORGANIZE (Type the letters in caps only). CD \DOS CONFIG (The configuration utility will load) 7 (This selects the path from the menu) \DOS (Hit the return key afterwards) ESC (Tell the configuration utility to exit) Y (Yes, Quit the configuration utility) Y (Answer Y to save current configuration) Now place the command PATH=\DOS in your autoexec.bat file in the root directory. When you are finished with your configuration changes press ESC. Answer <Y> or press <RETURN> to the prompts for QUIT ? and SAVE ? and your changes will be saved. To abort without saving changes, press <N> when prompted to save current configuration. ABOUT THE CONFIG FILE ORGANIZE will read the configuration file at start-up. If the configuration file is not present, ORGANIZE will ask you to enter a path to CONFIG.ORG or press RETURN to implement a default configuration setup, save it on disk, and continue to run. In this situation, ORGANIZE will look for the notefile in the current directory. If it is not found, ORGANIZE will create a new one and store data in it. The configuration file name is CONFIG.ORG. This is a text file and may be altered using Sidekick <TM> or any other ASCII compatible word processor. Unless you are sure of yourself, do not modify this file. The numbers in the file represent Ansi color codes for foreground and background in the order that the windows appear in the configuration menu. The twelfth line of the file should reflect your path designation depending on the last configuration selection. Should you attempt to modify the file outside of the configuration program you are on your own ! If you get into trouble just delete CONFIG.ORG and re-run the file CONFIG.EXE. The file will be recreated and you may then modify it from within the program. ORGANIZE Version 2.12 User's Guide - Page 6 NOTE: CONFIG.EXE looks for the file CONFIG.ORG in the current directory first. If CONFIG.ORG is not found, a new config file is created in the current directory. To modify a setup you should run CONFIG.EXE from the directory in which you intend to store the file and place a period (.) in the directory choice. This tells ORGANIZE to look first in the current directory for the file NOTEFILE.ORG. SELECTING THE SOUND OPTION. To Toggle the sound option on and off press <8>. ORGANIZE will initialize with the sound off or on depending on the choice made here. Individual user preference will dictate whether sound is defaulted on or off. The calendar will display faster with sound off and the notepad will operate slightly faster, however, the keyclicks in the notepad will be absent with the sound option disabled. ORGANIZE Version 2.12 User's Guide - Page 7 USING ORGANIZE NOTE: Before running organize the system date should be set. ORGANIZE retrieves the current date from DOS at startup. To set the DOS Date, type DATE <RETURN> while at the DOS prompt and enter the correct date when prompted. From the DOS prompt, type ORGANIZE and press <RETURN>. The system date will be read from DOS and the main screen will appear. At the left of the screen is the ORGANIZE calendar. The current day of the week should be highlighted when the current month is shown on the calendar. COMMAND SUMMARY The following commands are available from the initial calendar screen: Month forward : Right Arrow Month backward : Left Arrow Year forward : Up Arrow Year backward : Down Arrow New Month : <RETURN> On-Line-Help : F1 Open Notepad : F2 Print the Calendar : F3 Sound On/Off : F5 Quit : ESC MONTH FORWARD: Each press of the right arrow key will increment the calendar one month. MONTH BACKWARD: Each press of the left arrow key will decrement the calendar one month. YEAR FORWARD:Each press of the up arrow key will increment the calendar one year. YEAR BACKWARD: Each press of the down arrow key will decrement the calendar one year. NEW MONTH: This function is supplied to allow you to quickly go to another month without repeatedly pressing the arrow keys. To go from the current month to December just press <RETURN> and enter 12. December will appear on the calendar. SOUND: The default is SOUND ON. Pressing F5 will toggle the sound on or off depending on its current state. The calendar will tick each time it displays and the windows "swoosh" up and down. Keyclicks occur when typing or using the arrows. If you desire silent operation, press F5 at startup to turn of the sound. Sound may be defaulted to off using the CONFIG.EXE utility. ORGANIZE Version 2.12 User's Guide - Page 8 PRINTING THE CALENDAR. F3 will cause the calendar to be printed along with any daily notes which were entered. Just press F3 and, when prompted press <RETURN> to begin the printing operation or <ESC> to return to the calendar screen. The calendar is printed in an 8 1/2" x 11" format (Normal 9 1/2" fanfold). Text graphic characters are used for the frame and the notes are printed either in condensed or microprint depending on the configuration selection. The F4 key toggles bolding On/Off. Bolding will cause the printer to use double-strike and emphasize attributes. While the calendar is printing, you may stop the printing operation by pressing any key. The prompt "ABORT PRINTING Y/N ?" will appear. If you answer <Y> the printing operation will cease immediately and you will be prompted to reset the paper to TOF (Top of Form). NOTE: Some printers may continue to print several lines after the ABORT command is issued. Interrupt Hex 17 Service 1 is used to reset the printer. This interrupt pulls the printer reset line (Printer Parallel connector pin 31 - IBM PC connector pin 16) LOW to reset the printer. Some printers respond differently to the hardware reset and will continue to print what is in the printer hardware buffer. OPENING THE NOTEPAD. While the calendar is displayed press F2 to enter the notepad. The notepad consists of approx. fifteen lines per page, depending on the month selected, which can hold titles and other references. The first notepage is numbered one through fifteen. The second page is numbered 16 through the last day of the month. The cursor may be moved up, down, left, and right using the cursor keys and pages are switched by pressing PgUp and PgDn. If you arrow up past one or down past the last day of the month, the notepad will roll around to the top or bottom of the next page. Pressing the down arrow at day fifteen or the up arrow at day sixteen will also cause the notepad to change pages. ESC will remove the notepad window, leaving only the calendar displayed. While using the notepad, notice that there is another window which automatically follows the line that the cursor is on. This window contains a five line by eighteen character edit box containing notes for a particular day. You may switch to this window at any time by pressing F2. The same edit commands and full screen cursor movements used in the notepad also apply to this window. ESC will place the cursor back in the notepad leaving the daynote display active. You can then view the notes which were entered into the daynote window at any time by moving the cursor to the day desired. ON LINE HELP In areas where you see the F1 key designated as a help key, on line help is available. Help is presented in a context sensitive format which senses the area that you are currently in and offers the appropriate help summary. A sample screen is shown on the next page. ORGANIZE Version 2.12 User's Guide - Page 9 FIG. 1 TODAY'S DATE AND TIME ─┐ v ╔═══════════════ Monday September 5, 1988 08:56:27 PM ═════════════════════╗ ║ CALENDAR ╔═══════════════════════════════════════╗ Insert ║ ║ │ ║ ORGANIZE - Daily Appointment Calendar ║ ║ ║ \│/ ╚═══════════════════════════════════════╝ ║ ║ ┌─── September 1988 ────┐ ╔September 1988════════╗ ║ ║ │ S M T W T F S │ ║Day ------Title-------║ ║ ║ ├───┬───┬───┬───┬───┬───┬───┤ ║ 1: ║ ║ ║ │ │ │ │ │ 1 │ 2 │ 3 │ ║ 2: ║╔Day: 5════════════╗║ ║ ├───┼───┼───┼───┼───┼───┼───┤ ║ 3: ║║Legal Holiday ║║ ║ │ 4 │ 5 │ 6 │ 7 │ 8 │ 9 │10 │ ║ 4: ║║All employees off ║║ ║ ├───┼───┼───┼───┼───┼───┼───┤ ║ 5: Labor Day ║< ║║ ║ │11 │12 │13 │14 │15 │16 │17 │ ║ 6: ║║ ║║ ║ ├───┼───┼───┼───┼───┼───┼───┤ ║ 7: ║║ ║║ ║ │18 │19 │20 │21 │22 │23 │24 │ ║ 8: ║╚═══════════════════╝║ ║ ├───┼───┼───┼───┼───┼───┼───┤ ║ 9: ║ /|\ DAYNOTES ║ ║ │25 │26 │27 │28 │29 │30 │ │ ║10: ║ | follows cursor║ ║ ├───┼───┼───┼───┼───┼───┼───┤ ║11: ║ for each day. ║ ║ │ │ │ │ │ │ │ │ ║12: ║ ║ ║ └───┴───┴───┴───┴───┴───┴───┘ ║13: ║ <---NOTEPAD ║ ║ ║14: ║ for titles and ║ ║ Month : <-> Year :^ v ║15: ║ references. ║ ║ Help : F1 Notepad : F2 ║ ║ ║ ║ Print : F3 New Month:<─┘ ╚══════════════════════╝ ║ ║ Quit : ESC Sound : F5 On USING: \DOS ║ ╚════════════════════════════════════════════════════════════════════════════╝ The above illustration shows the major component parts of ORGANIZE. The calendar appears at startup and is displayed at all times. The F2 key opens the notepad window and also causes the daynote window to open. As you move the cursor in the notepad window, the daynote window follows the cursor from line to line, displaying the notes associated with a particular day. Pressing F2 again switches the active edit window from the notepad to the daynote window and allows you to edit the daynotes. ESC will switch you back one level. If you are in the daynote window, ESC will return you to the notepad. Once back in the notepad, ESC returns you to the calendar. In the top right-hand corner of the screen you will find the status indicator for INSERT/REPLACE. Pressing the INS key toggles the status indicator whether you are in the notepad or the daynote window. INSERT mode pushes all characters to the right of the cursor one position at a time while you type, and REPLACE overwrites characters under the cursor with the key that is pressed. The cursor will change from flashing to steady when REPLACE is selected. This function operates the same way as in a normal word processing program with the exception that line wrap is not implemented. Since daynotes are usually independent of each other, it is not generally desirable to have the previous line wrap into the note for the next line. The current NOTEFILE directory is displayed in the bottom right corner. ORGANIZE Version 2.12 User's Guide - Page 9A USING THE VIEW MODE The VIEW mode allows you to preview the calendar as it will be printed on the line printer. This feature is invaluable for those of you who create schedules and various other complex calendars. The VIEW mode is instantaneously updated when you make a change in the notepad or daynote window. By pressing F6, you can immediately see the effect of your entry. The VIEW mode is accessible from all areas of ORGANIZE except, of course, the HELP and PRINT routines. While in the calendar you may select a month and press F6 to see the calendar for that month. The notepad and daynote windows may be edited and subsequently VIEWed after a change is made. VIEW OPERATION To use VIEW, press F6 while in the calendar, notepad, or daynote window. The VIEW screen will open and display the preview calendar for the current month. The VIEW calendar is displayed in a "window" format. To move around the calendar press the arrow keys. The up and down arrows move vertically and the left and right arrows move horizontally within the VIEW screen. Each press of the arrow keys moves you in small increments similar to a spreadsheet display. The memo notes for each day are printed in their correct place on the VIEW screen. For example, if you are creating a work schedule calendar that shows employees who are on vacation each week within a month, you may want to use dashed lines with arrows at each end to indicate the begin and end dates for a vacation as in the compressed display below. ┌────────────────────────────────────────────────────────────────┐ │ Sun Mon Tue Wed Thu Fri Sat │ │────────────────────────────────────────────────────────────────│ │ │1 │2 │3 │4 │5 │ │ │ │<-------│--------│-Jones--│--------│------->│ │ │ │ │ │Vacation│ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ └────────────────────────────────────────────────────────────────┘ ORGANIZE Version 2.12 User's Guide - Page 9B The event is difficult to visualize when stretched across several days. When viewed with the VIEW feature it becomes a simple matter to ensure that the dashed lines are aligned properly and that they are inserted in the proper day blocks. The VIEW mode allows this without "trial printing" to determine the effect of the change, thus saving the frustration of having to print and edit several times not to mention the savings in paper. When you are finished with VIEW, press ESC and you will be returned to the exact place in ORGANIZE that you left. ORGANIZE Version 2.12 User's Guide - Page 10 TECHNICAL ASSISTANCE AND MODIFICATIONS ORGANIZE is written with ease of use and utility in mind. I hope that you enjoy using ORGANIZE and I welcome your comments and suggestions. You may reach me by mail at the address on the registration form. I will be more than happy to answer any questions from registered users concerning the use of ORGANIZE. Please include a SASE for my reply. Modifications will be implemented by popular demand and/or discretion of the author. If users desire that an enhancement should be made, and such modifications are possible within the scope of the program, the changes will be considered for implementation in future releases. Technical assistance for both registered and non-registered users may be obtained by leaving a message for me on my home BBS at: BBS: U WANT WHAT? NUMBER: (912) 471-7629 HOURS: 24 hrs. PROTOCOL: 1200-2400 N 8 1 OR you may leave a message on Compuserve. Address any message to: David Pritchett 70242,760 I will respond to messages left on either of these services with a personal reply. If you do not have access to a modem or Compuserve, you may write me at the following address. Please state the problem completely, giving as much information about how the problem occurs including your system configuration. You should print out the contents of your autoexec.bat and config.sys files by typing: CD C:\ <return> COPY AUTOEXEC.BAT PRN <return> COPY CONFIG.SYS PRN <return> Your autoexec.bat and config.sys files will be printed on the line printer. Include the copies in the envelope along with sample copies of the printed calendar if your problem is with calendar printing. Mail all of this to: DAVID PRITCHETT P.O. BOX 7273 MACON, GA 31209-7273 Most problems can be solved by refering to the manual. Please make an attempt to solve the problem by reading the manual first. ORGANIZE Version 2.12 User's Guide - Page 11 APPENDIX A USING THE ORGANIZE TICKLER UTILITY (Now included in the shareware version) The TICKLE.EXE utility should be placed in the directory with the ORGANIZE files and the commands: CD \<The directory path where NOTEFILE.ORG is located> TICKLE CD \ <Back to the path of your choice> NOTE: Text shown in <> (angle brackets) will vary from system to system. The directory where ORGANIZE is located goes here. should be added in the appropriate place in the AUTOEXEC.BAT file in the root directory. When the computer is booted, the tickle.exe file will run and interrogate the file NOTEFILE.ORG. If any notes are present for the current date, they will be listed on the screen along with the prompt: Press F2 to Print, RETURN to Exit Pressing the F2 key will result in the prompt: When Printer is Ready, Press Any Key. ESC to Abort At this time you may elect to continue with the print operation or press ESC to go to the next autoexec batch file command (or back to DOS if the utility is run from the DOS prompt). NOTE: Non-registered users may obtain this utility by mailing the registration form along with a $25.00 donation. You will receive the latest registered version. Shareware notices are removed from the production release. TICKLE is a separate program and is included with each registration order. ORGANIZE Version 2.12 User's Guide - Page 11A APPENDIX A New in Tickle version 1.2! Now you can call TICKLE.EXE with parameters to flag events in advance. Just call tickle with a number from 1 to 31 and tickle will look that many days into the future and retrieve any events that fall on that day. EX: TICKLE (no parameter-looks at today) TICKLE 1 (looks at tomorrow) TICKLE 10 (looks at 10th day ahead) TICKLE 30 (looks at 30th day ahead) TICKLE 1 30 (looks at the next 30 days) You may call TICKLE with a range of parameters to look at various days in the future. TICKLE only takes an instant to return events for various dates, so you can call it several times to look at individual days or give it a range to look at all events that occur within that range. Use TICKLE to prevent those missed events! ORGANIZE Version 2.12 User's Guide - Page 12 APPENDIX B PROBLEM SOLVING 1. Error 203 appears when I run ORGANIZE. What's wrong? Error 203 is a HEAP OVERFLOW error. This means that there is not enough memory available to run the program. Run chkdsk to determine the amount of memory available before ORGANIZE is loaded. If it is less than 128K, remove TSR utilities to make more memory available. 2. My color choices do not change after I run CONFIG.EXE. Color choices as well as the printer font and default directory are stored in the file CONFIG.ORG. This file must be available to ORGANIZE at startup. Store all ORGANIZE related files in the same directory and run from that directory each time. If you wish to invoke ORGANIZE from another directory, create a batch file which changes to the that directory before running the program or store CONFIG.ORG and CONFIG.EXE in the directory you will be running the program from. (See Appendix C.) ORGANIZE also prompts you for the CONFIG.ORG path if it is not found at startup. If you just press return at this prompt, a default color, font, and directory setup are chosen. The file CONFIG.ORG is created in that directory and will contain a generic setup. You may then modify that configuration. 3. My printer does not print correctly (IBM EPSON Selection). Check to ensure that your printer is IBM GRAPHICS/EPSON compatible. All printer codes are standard EPSON issue. Check the DIP switches and compare them with the printer manual. Set the printer mode switch to "IBM Graphics" mode. o The CR/CRLF (carriage return/line feed) switch should be set to CR position. If it is set to CRLF the calendar blocks will be double spaced and the vertical lines won't touch. o If your printer is dual-mode (i.e. EPSON/IBM GRAPHICS), you may get garbage characters instead of the graphic line drawing characters if IBM GRAPHICS mode is not selected. ORGANIZE Version 2.12 User's Guide - Page 13 4. ORGANIZE always asks for the directory path to CONFIG.ORG. The file CONFIG.ORG must be available in the directory from which the command ORGANIZE is issued. DOS will not search for data files... only executable files such as .COM, .EXE, .BAT, etc. If your ORGANIZE files are located other than the current directory, you must create a BATCH file to change to that directory before calling ORGANIZE and the CONFIG.ORG file must be located in that directory. See appendix C. 5. My printer is ready but ORGANIZE reports that the printer is not responding. The printer error checking routine senses both parallel and serial port status. The few printers that have exhibited this phenomena have had multiple printer A/B switches and other non-standard fan-out devices connected. For this reason there is an <I>gnore option in the error message which allows you to press <I> to override the error. Pressing <I> should allow the printing operation to continue past the error. *** Be aware that if an error condition really exists, the program may hang up or report error 160 (Device Not Ready). ORGANIZE Version 2.12 User's Guide - Page 14 APPENDIX C RUNNING ORGANIZE FROM MULTIPLE DIRECTORIES ORGANIZE may be called from any directory on your hard disk if it's stored in the default directory. It will store notes in the directory that you specify during setup. In order to utilize the custom setup choices made by CONFIG.EXE you must allow ORGANIZE to find its CONFIG.ORG file at startup. This is best accomplished by creating a separate directory for ORGANIZE and loading all related files into this directory. Should you wish to call organize from anywhere on the hard disk, you should use the method described below: 1. Load all ORGANIZE files into your default <PATH> directory. 2. Create a batch file which changes to that directory and loads ORGANIZE. This will allow ORGANIZE to find its CONFIG.ORG file. EXAMPLE: Your default path is \DOS. The batch file ORGANIZE.BAT contains the following commands and is stored in the \DOS directory: CD \DOS ORGANIZE The above file may be created with any ASCII word processor or by typing: COPY CON ORGANIZE.BAT (RETURN) CD \DOS (RETURN) ORGANIZE (RETURN) ^Z (Control + Z - Save file) Store the batch file in your default directory along with the ORGANIZE files. NOTE: If ORGANIZE cannot find the file CONFIG.ORG it will beep at startup and ask you to enter the full pathname to CONFIG.ORG. Once this is done and ORGANIZE locates the CONFIG.ORG file, the program will operate normally and will store notes in the proper notefile. You may forego the creation of a batch file as described above if you are willing to enter the path at startup. In summary, you may run ORGANIZE using three methods. 1. Load everything into the same directory and change to to that directory for each run. (Highly recommended For simplicity!) 2. Load everything into your default directory and create a batch file to change to the default directory and run organize automatically. This gives you the freedom to call ORGANIZE from any subdirectory on the hard disk. The batch file should be located in your default path directory. 3. Load everything into the default directory and enter the pathname to CONFIG.ORG when ORGANIZE asks you for it. Configure the notefile path to the default directory using CONFIG.EXE. * If in doubt, use method 1. ORGANIZE Version 2.12 User's Guide - Page 15 APPENDIX D DISTRIBUTION OF ORGANIZE The file ORGxxx.ZIP may be freely distributed to other users. NO CHARGE other than a small fee to cover copying and the cost of the diskette may be charged to a user. The program and accompanying files will remain the property of the author. Registration grants to the user a license to use the software and does not constitute a sale. Corporations and organizations who wish to distribute this program to members and employees should contact the author to obtain information on site-licensing at a discounted per-user rate. Should you decide to distribute the program to other users you should copy only the ORIGINAL ZIP FILE in its complete form with the default configuration and notefile with this documentation file unaltered. Shareware and disk distributors may include ORGANIZE in catalogs and advertising media and may distribute ORGANIZE on disk media as long as the release form (see next page) is completed and mailed to my P.O. Box in advance. I will acknowledge receipt of the form and grant permission to distribute. This is necessary to ensure that the latest version is made available for your use and that I can properly track distribution through commercial channels. When ORGANIZE is distributed through such channels, a notice should be included informing the recipient that the program is SHAREWARE and is NOT public domain. An explanation of the term SHAREWARE should be included for the user's information. SEE DISCLAIMER - Page 2 ORGANIZE Version 2.12 User's Guide - Page 15A ORGANIZE Shareware Distribution Release Form Company Name ________________________________________________ Address______________________________________________________ P.O. Box_____________________________________________________ City______________STATE____ZIP____________Phone______________ What version do you currently have?__________________________ Method of Distribution: Catalog [ ] Magazine Ads [ ] Other [ ] Please explain other_________________________________________ Do you include documentation identifying the programs as shareware? __________________________________________________ Do you explain the shareware concept?________________________ Please name a contact person/librarian and list phone number and extension _______________________________________________ ============================================================= Please mail the completed form to: David Pritchett P.O. Box 7273 Macon, GA 31209-7273 Terms: o You may distribute ORGANIZE after written confirmation of this release form. o You must include a shareware identification message with the program. The Shareware concept must be explained clearly. o You may not sell the program; you may only distribute the program. The program remains the property of David H. Pritchett. o You may not bundle the program with commercial software. I agree to and will abide by the above terms and conditions. Signed________________________________________________________ ============================================================== ORGANIZE Version 2.12 User's Guide - Page 16 APPENDIX E REVISION HISTORY CHANGES IN VERSION 1.01 Trapped all invalid keystrokes so that the calendar is not redrawn everytime a non-operational key is struck. Added an on-screen sound state (on/off) indicator. File is only written to disk if changes are made in the notefile. Check implemented for path existence when creating new notefile. Previously the program would crash if the config.org file held an invalid path to the notefile. CTRL-BREAK is disabled in version 1.01. Previously a user could break out of the program without closing the notefile. This would cause the latest notepad entries to be lost. The cursor is turned off at certain points to prevent flashing snow on the screen. A sound default selection was added to the CONFIG.EXE program. This lets the user choose whether sound is enabled at startup. CHANGES IN VERSION 1.2 All applicable V1.01 changes remain in V1.2 except where otherwise noted. Some printers would not accept simultaneous emphasized and condensed print modes. These printers would accept emphasized and ignore the subsequent command to begin condensed mode. This resulted in a double spaced printout because the pitch remained in emphasized Pica and the line exceeded the carriage width. Epson LX-800, FX-80, and Diablo P12CQI narrow carriage models were among those tested. Most IBM Graphics compatible wide carriage printers seemed not to mind this command sequence. If the Up or Down arrow was pressed in the notepad and the line above or below was blank, the next character pressed would appear at the left margin. This was fixed by automatically padding the line with spaces. The line is trail-edge trimmed when stored to minimize file size. Version 1.2 implemented an on-screen clock and date display. ORGANIZE Version 1.2 included On-Line-Help in a context sensitive format. Version 1.2 implemented help for the following items: * Main Calendar Screen * Individual help for New Month and Print functions. * Notepad usage * Daynotes usage * Printer functions Help is invoked by pressing the standard F1 key while in the area where help is desired. A full screen help window will open for that topic. ORGANIZE Version 2.12 User's Guide - Page 17 CHANGES IN VERSION 1.3 ORGANIZE Version 1.3 dealt with some minor bugs. The "Jittery" notepad cursor was changed to a solid reverse video block cursor. One or more garbage characters appeared only on the first line of the editor if you used the right arrow to move to the end of the first line, thus wrapping to the next line. The line was clean if you arrowed down a line and then back up. An uninitialized variable proved to be the culprit. There was a garbage character at the right end of the clock line. This is fixed in 1.3. Printer "ready" sensing was added in 1.3 to prevent a crash if the printer was off-line when the calendar was printed. A couple of non-standard configurations didn't accurately report printer status so an override was implemented, allowing the user to "go ahead" even though DOS reported the printer as busy or otherwise encumbered. Certain buffers only report status changes AFTER a char is sent, so toggling the printer off-line doesn't show up until the first character is sent to the printer. Then it's too late to report the condition to the user. Be aware that use of the override may result in a crash. However, the data notefile is closed at this time, so a crash will not result in corrupted files. The real-time clock didn't sense PM existence. This was fixed by converting the 24 hour integer return from the DOS interrupt to 12 hour time and sensing > 12:00 as PM. Calendar print bolding was added as a new feature. This feature implements a double-strike, emphasized calendar printing option. CHANGES IN VERSION 1.31 A new printer bug appeared in 1.3 (still evident only with some printers). It seems that some printers don't have reverse line feed capability. This proved to be an elusive bug. When sending high order ASCII characters (text line drawing chars) to the printer followed by a carriage return, then another line of text line drawing characters, some printers reverse to the top of the first line before printing the second line... others don't. This caused a breakup in vertical line spacing. This bug was fixed by sending high order chars (to draw the calendar frame) in single lines followed by a CRLF. CHANGES IN VERSION 1.4 Version 1.4 fixed a very minor but agravating bug that dealt again with 80 Col printers. It was discovered that under certain circumstances a line of notes would exceed 80 cols and thus cause an occassional wrap of spaces to the next line, followed by a carriage return. This produced a "gap" in the vertical format of the calendar. A watchdog routine in the printer code took care of this. Also in 1.4, a bug appeared in the TICKLE.EXE file. If Tickle was run during a month where no notes had ever been entered in the notefile, it locked up in an infinite loop. One ELSE statement took care of the condition that caused the error. ORGANIZE Version 2.12 User's Guide - Page 18 CHANGES IN Version 1.41 Version 1.41 finally cured the "printer blues." Formatting was extensively tested on various printers and adjusted for optimum performance with the many "IBM graphics compatible" printer personalities. CHANGES IN Version 1.42 The BOLD option in the print function failed to bold all of the printed output. The line containing the day of the month was left in normal single pass print. Version 1.42 fixed this. Version 1.42 is compiled using the Turbo 5.0 command line compiler, thus decreasing the size of the EXE file by approximately 5K bytes. This decrease in EXE size is due to the removal of Turbo's debugging code which is only needed during development and beta testing. As a result, ORGANIZE 1.42 executes a little faster. CHANGES IN Version 1.43 A small problem surfaced in Version 1.42 which occurred when the first day of the month hit on Friday or Saturday AND there were five sundays in the month. The July 1989 Calendar expanded one line too far and printed the very bottom of the calendar on the next page. Version 1.43 fixed this glitch. CHANGES IN Version 1.45 Version 1.45 fine-tunes the printer routine so that each note is printed with the proper registration within each day block. There were some variations in some printers which caused the first or last character to print on top of a vertical line in the calendar. An improved printer sensing routine was implemented in Version 1.45. This routine allows a 20-second time-out before declaring that the printer is not responding. This was necessary because some printers are technically "off-line" to DOS while initializing or performing a form feed. CHANGES IN Version 1.46 Version 1.46 is basically a maintenance release which fixed some minor irritations. The clock wouldn't change to AM/PM until 1:00. The swooshing sound effects were a little too noisy and were toned down to a more pleasant level. ORGANIZE Version 2.12 User's Guide - Page 19 Changes in Version 2.1 In keeping with other quality shareware programs, I released the full production version with all features activated. After surveying users and potential users I found that many of those who evaluate shareware were disturbed at shareware that had some features deactivated. This version activates the VIEW mode allowing you to preview the calendar as it will appear in print and offers support for the HP Laserjet printers. I hope that you enjoy the new features and find them an added incentive to register your copy of ORGANIZE. Changes in Version 2.11 I inadvertently initialized a constant incorrectly for the number of lines in the VIEW screen which truncated the VIEW screen in a manner that did not allow viewing the bottom row of the calendar if the first day of the month began on Friday, Saturday, or Sunday AND the month had more than 29 days. In the previously described case, a month will fill parts of the sixth calendar row. Changes in version 2.12 An error 204 was generated if an exit was attempted, then the user chose to return to the program. The error was reported upon exit to DOS when pointers were released. This was due to a inadvertent releasing of heap space due to a parameter that was not passed to a routine. This error did not affect the registered version, only the shareware version. Also, in keeping with ASP (Association of Shareware Professionals) re- quirements, Shareware message screens were kept to a minimum. The screen that appeared every ten uses in version 2.11 when the notepad was selected has been removed. ORGANIZE Version 2.12 User's Guide - Page 20 CREDITS Thanks are due to my BETA testers GERRY DOYON, BARRY LINDSAY, BILL BOWLES, and TOM LEONARD who spent countless hours trying (and often succeeding) in blowing up my code !