home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
World of Shareware - Software Farm 2
/
wosw_2.zip
/
wosw_2
/
DESKTOP
/
ORG212.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 !