0Use the Menu Key to Navigate this Document in Outline View
Registration details are at the end of this file.
JAM V3.0
The AGENDA view that PSION forgot!
Martin Sturgess March 1995
Introduction
JAM is an application which gives a Monthly View for PSION 3A Agenda Files.
I wrote this application because, despite it's many excellent features, there is no easy way to search for "free" time using AGENDA. I needed an application with which I could quickly determine when I have free time to arrange a meeting or appointment.
Once on the JAM icon you can view 28 days x 12 Hours at a time in a couple of clicks. Try it out and see how much faster you can interpret your AGENDA using JAM!
To maximize speed I have included a SNAPSHOT facility which will instantaneously display the JAM window as it appeared when you last launched JAM. This facility allows you to process the AGENDA file, quit JAM then display the JAM window later without the need for reprocessing.
Installation
Copy JAMV3.OPA to your \APP\ directory and install in the usual way by pressing< PSION>< I>.
Getting Started
Launch JAM by selecting one of the AGENDA files listed below the JAMV3 Icon and press ENTER.
Startup options
Use SnapShot
This option may appear when you start JAM. This will rapidly load the JAM window with Timed entries as they appeared when JAM was last run.
The snapshot files are JAMA.TMP and JAMB.TMP in the \OPD\ directory. No harm is done if you wish to delete them, new ones will be created by JAM.
Include Repeats
Repeat processing is relatively slow so if you can remember your repeat entries you have the option of disregarding the repeats.
You may find some speed benefits by changing repeats with a very old start date to start closer to today. To do this you will need to change the end date of the repeat to before today and add a new repeat starting from today. This will not effect daily or weekly repeats but will effect monthly by date, monthly by days and annual repeats.
Display Text whilst Processing
This will display the text of each entry as JAM reads the AGENDA file. This will slow processing slightly.
How many Days in Window
The JAM window is scrollable so you can use anything between 1 and 56 days. Larger windows require more memory and will take longer to process.
Use Procedure Cache
With this turned on JAM will allocate a dynamically variable cache to optimize speed. JAM will use as much memory as is needed up to the maximum available. If the Procedure Cache is off JAM will use less memory but will be slower.
Play Sound when processing complete
Allows you to turn off the short tone.
Start Time of Window
Sets the hour which appears at the top of the screen. Primarily for those whose working day is not 9-5.
Menus
Exits the Application
New Start Date
Reprocess the file using a new start date. Default start date is today.
Process Next Window
Reprocess the file starting from the day after the end of the current window.
Options
Exclude Repeats
Valid during processing only. Cancels the processing of any further repeats.
Add Timed Entry
Valid after processing. Allows you to write a timed entry to the AGENDA File. Alarm can be included although you may only use RINGS,CHIMES or SILENT sounds. This is only available in the second module, JAMREG3.OPO.
About
Displays Registration information and Help.
Search
Forward Find
Searches from the current day to the end of the window, i.e. from Start Date to Start Date+Days in window. Search is not case sensitive.
Function Keys
<Menu>
<Menu> displays the Menus. Note that the Menus are different during and after processing.
Arrows
Moves the cursor 1 day or 1 hour.
<PSION>Arrows
Moves the cursor 12 hours or 7 days.
<ENTER>
<Enter> whilst the cursor is on an entry will display the text of the entry. Memos are not displayed.
<+> will display all entries after the cursor position. <Esc> will cancel the entry details display.
<HELP>
<HELP> will display the Shareware message and details of the Function Keys. The Shareware message is suppressed by the presence of JAMREG3.OPO.
<P> will toggle the display to early am, mid day, late PM then back to normal.
<D> Toggles display of day month year info. Toggle this off for faster cursor movement.
<E> Toggles the display of Entry Text whilst moving in the window.
Sharing JAM with the AGENDA
The AGENDA file must not be open by AGENDA when the file is processed by JAM or when adding entries.
You CAN open the AGENDA file from the AGENDA application after JAM has finished processing.
Registered users will obtain an additional module to automatically close the AGENDA file then reopen it from AGENDA when JAM quits. This will allow you to run JAM on an AGENDA file irrespective of whether AGENDA has it open.
Printing from JAM
Although JAM does not include an option to print, you can print the current screen contents by saving the screen to a file then using a suitable drawing application to open then print the Screen dump.
To save the current screen press ctrl+shft+PSION+s. This will create M:\SCREEN.PIC.
Version History
V1 (Jan 95)
Original version.
V1a (9th Feb 95)
Minor bug fixes and additional functionality.
1. Tone now sounds at the end of processing of the AGENDA File.
2. JAM looked for the additional JAM.OPO ( now called JAMREG.OPO) module in the \APP\ directory of the disk on which the AGENDA file resided. JAM now looks for this module in
M:\APP\
A:\APP\ and
B:\APP\
3. The Use Snapshot option now correctly warns if Repeat processing was turned off during the previous session.
V2.0 18th Feb 1995
1. JAM now checks for the existence of the\ OPD\ Directory and will create one if not present.
2. Play Sound on completion of processing is now an option.
3. The date format has been changed to ddd dd mmm yy when displaying the text of entries. The previous format was ddd dd/mm/yy.
4. An uncommon bug which displayed unintelligible text when there were no entries for the specified period has been fixed.
5. JAM version 1 Users were invited to request the JAM1.OPO module before registering. This facility no longer applies. JAM1.OPO is not compatible with JAM Version 2.
6. Registered users now receive an additional module named JAMREG.OPO.
7. The P key now acts as a Peeking key. This will toggle the display to view Early Morning , Mid Day then afternoon/evening. This reduces the need to scroll up and down using arrow keys.
8. JAM is now approximately 10% faster.
9. The D key will toggle the GIPRINTing of the day,month,year information whilst moving with the arrow keys.
10. The <Tab> key now jumps to a date.
11. The <SPACE> key jumps to first day of first window.
12. The slow scrolling when using PSION + Arrows has been fixed.
13. Psion + Up or Down arrows now jumps 4 hours. This was 12 previously.
14. A Forward Find function has been added to the Menu.
15. JAM now checks if the AGENDA file is smaller than it was due to compression. Snapshot will NOT be an option since the text of the entries would be corrupt.
16. SNAPSHOT dialogue now tells you how long ago the SNAPSHOT was created.
17. SNAPSHOT dialogue now warns about compression. This is to ctach the situation where the AGENDA file has been compressed and new entries added thus making the file bigger than when the snapshot was created.
V3.0 31st March 1995
1. Added the E key option which toggles display of Entry Text whilst moving in the Window.
2. Changed the way in which Entry Text is looked up. In version 2 the snapshot file contained pointers to where the text is in the Agenda File. This required the AGENDA file to be closed in order to see the text. In Version 3 the Entry text is stored in the snapshot file. This makes the Snapshot file larger but allows text to be displayed whilst moving in the Window. Also the problem with corrupted entry text has been eliminated since it does not matter if the AGENDA file has been modified since the snapsho