ࡱ> ܥhW eI&/XXXXXXXL.4b%P"z`####,!$$%7&X&&%X\d%!XX!!!XX#2,lXXXX#!%! PIM48 (Library Version 4.5a) PERSONAL INFORMATION MANAGER (PIM) HP48GX/SX by GLENN P. ROBERTSON (CIS 73117,675) January 1997 USER DOCUMENTATION TABLE OF CONTENTS  TOC \o "1-3" USER DOCUMENTATION  GOTOBUTTON _Toc380114335  PAGEREF _Toc380114335 3 INTRODUCTION  GOTOBUTTON _Toc380114336  PAGEREF _Toc380114336 3 Features:  GOTOBUTTON _Toc380114337  PAGEREF _Toc380114337 3 Calendar  GOTOBUTTON _Toc380114338  PAGEREF _Toc380114338 3 Appointment/Todo Browser  GOTOBUTTON _Toc380114339  PAGEREF _Toc380114339 3 Access to External Programs  GOTOBUTTON _Toc380114340  PAGEREF _Toc380114340 3 NEW FEATURES  GOTOBUTTON _Toc380114341  PAGEREF _Toc380114341 4 Version 4.5a (Feb 97)  GOTOBUTTON _Toc380114342  PAGEREF _Toc380114342 4 Version 4.5 (Jan 97)  GOTOBUTTON _Toc380114343  PAGEREF _Toc380114343 4 Version 4.4 (15 Jul 96)  GOTOBUTTON _Toc380114344  PAGEREF _Toc380114344 4 SHAREWARE REGISTRTION  GOTOBUTTON _Toc380114345  PAGEREF _Toc380114345 5 USER SUPPORT  GOTOBUTTON _Toc380114346  PAGEREF _Toc380114346 5 DEFINITIONS  GOTOBUTTON _Toc380114347  PAGEREF _Toc380114347 5 APPOINTMENT/TODO ACCESS  GOTOBUTTON _Toc380114348  PAGEREF _Toc380114348 5 CONTROL ALARMS  GOTOBUTTON _Toc380114349  PAGEREF _Toc380114349 6 ALARMS IN ADVANCE OF APPOINTMENTS  GOTOBUTTON _Toc380114350  PAGEREF _Toc380114350 6 REPEATING ALARMS  GOTOBUTTON _Toc380114351  PAGEREF _Toc380114351 6 SYSTEM FLAG USEAGE  GOTOBUTTON _Toc380114352  PAGEREF _Toc380114352 6 HP48 COMPATIBILITY AND DISCLAIMER  GOTOBUTTON _Toc380114353  PAGEREF _Toc380114353 7 INSTALLATION  GOTOBUTTON _Toc380114354  PAGEREF _Toc380114354 7 UNINSTALL  GOTOBUTTON _Toc380114355  PAGEREF _Toc380114355 8 LIBRARY MENU  GOTOBUTTON _Toc380114356  PAGEREF _Toc380114356 8 THE CALENDAR  GOTOBUTTON _Toc380114357  PAGEREF _Toc380114357 9 CALENDAR FORMAT  GOTOBUTTON _Toc380114358  PAGEREF _Toc380114358 9 CURSOR MOVEMENT  GOTOBUTTON _Toc380114359  PAGEREF _Toc380114359 9 MOON PHASES  GOTOBUTTON _Toc380114360  PAGEREF _Toc380114360 10 SUNRISE/SUNSET TIME  GOTOBUTTON _Toc380114361  PAGEREF _Toc380114361 10 THE CLOCK DISPLAY  GOTOBUTTON _Toc380114362  PAGEREF _Toc380114362 10 SETUP SCREENS TIME/DATE and OTHER VARIABLES  GOTOBUTTON _Toc380114363  PAGEREF _Toc380114363 10 SNIPPET OF TODOS OR APPOINTMENTS  GOTOBUTTON _Toc380114364  PAGEREF _Toc380114364 11 BRINGING FORWARD TODOS  GOTOBUTTON _Toc380114365  PAGEREF _Toc380114365 11 COUNTDOWN TIMER  GOTOBUTTON _Toc380114366  PAGEREF _Toc380114366 11 STOP WATCH  GOTOBUTTON _Toc380114367  PAGEREF _Toc380114367 12 MENU KEYS - CALENDAR DISPLAY  GOTOBUTTON _Toc380114368  PAGEREF _Toc380114368 12 HARD KEYS - CALENDAR DISPLAY  GOTOBUTTON _Toc380114369  PAGEREF _Toc380114369 15 APPOINTMENT/TODO BROWSER  GOTOBUTTON _Toc380114370  PAGEREF _Toc380114370 17 INTRODUCTION  GOTOBUTTON _Toc380114371  PAGEREF _Toc380114371 17 MESSAGE VIEWER  GOTOBUTTON _Toc380114372  PAGEREF _Toc380114372 17 MENU KEYS - APPOINTMENT/TODO BROWSER  GOTOBUTTON _Toc380114373  PAGEREF _Toc380114373 17 HARD KEYS - APPOINTMENT/TODO BROWSER  GOTOBUTTON _Toc380114374  PAGEREF _Toc380114374 20 ACKNOWLEDGEMENTS  GOTOBUTTON _Toc380114375  PAGEREF _Toc380114375 21  USER DOCUMENTATION INTRODUCTION PIM48 is a calendar based Personal Information Manager designed to manage appointments and todos. Features: Calendar US or European calendar appointments and todos marked with small boxes beside appropriate date days passed/days to go in the current year week of the year days or week days between any two dates analog and digital clock show current time snippets of a days appointments or todos graphical display of moon phases sunrise/sunset times for any given date Julian day integrated stop watch timer Appointment/Todo Browser uses small font for maximum display of detail appointment and todos can be filtered by the MON, WEEK, or the DAY a built in viewer allows full viewing of selected appointments and todos messages. Viewer supports carriage returns and full scrolling of display using the cursor keys. menu keys allow full editing (add, delete, and edit) clipboard metaphor provides cut, copy, paste functions ability to set alarms in advance of appointment times easy entry of repeating alarms supports control alarms support for user defined text editor ability to save APPOINTMENTS and TODOS to a save file (PIM.SAV). Access to External Programs List Manager (LM) - a LIST manager/browser which provides outliner capabilities. ROLDX - a database program by James Weisbin. Any user provided program defined by the variable 'db'. Any user provided text editor. NEW FEATURES (for a complete history, see the file HISTORY.DOC) Version 4.5a (Feb 97) Fixed LS/RS-LEFT/RIGHT ARROW bug. Corrected documentation pertaining to the use of the above functions Version 4.5 (Jan 97) alarm advance feature to set alarms to go off before a given appointment "viewer" improves viewing appointment/todo message details week-of-year added to calendar display Faster jumps - does not redraw the calendar if result is in the same month Stop Watch running time is "remembered" between PIM48 sessions Stop Watch automatically begins "running" when entered Bar added to delete key to indicate sub-directory options Improved setup screen (allows date/time adjustment, setting of date/time format, auto todo update , and input of latitude, longitude, and time zone information) Alarm sound can turned off from the calendar display The setup screen is accessible from both the calendar and the appointment/todo browser Auto todo update works on a SX (does not require SORT feature of GX) "Initialization" process removed Fixed bug which caused appointments/todos not to display when the wordsize was < 64. Distribution file now includes a "light" version of PIM48 (PIM48LT.LIB) for those with limited memory Note: The following features are removed in the light version: moon phases; sunrise/sunset times; auto todo updates (manual updates still available); and input screen for auto todo updates, latitude, longitude, and time zone. The light version is approximately 3.1K smaller. Documentation available in MS Word. Version 4.4 (15 Jul 96) Added an integrated STOP WATCH. Added a count down TIMER. Routines to RCL and STO APPOINTMENTS/TODOS available in library menu to allow access by other programs. The time can continuously updated itself (active when STOP WATCH is running, clock adjustment is active, or when the COS ("T") key is pressed). Time (both analog and digital clocks) show the seconds. Clock (date/time) adjustment screen displays current date and large running clock with seconds. Option is available for changing the time to shut off. Improved browser for APPOINTMENTS AND TODOS ... faster, better use of available memory. Improved input screens for APPOINTMENTS AND TODOS (dates, appointment times, and repeat times can be input directly). APPOINTMENTS AND TODOS can now contain LISTs and PRGMs. Editing APPOINTMENT/TODO containing a LIST can automatically take you to List Manager (LM) if it is installed. Checked off TODOs are no longer brought forward (change means updating todos require a GX). Clipboard metaphor has been extended for use by other (external) programs. Clipboard information is stored in the variable 'clip' in the "Hidden" directory. Faster ... rewrote many routines to improve performance! Program size still less than 20k. Help available to both registered and unregistered users. Removed 30 day evaluation restriction. Added HISTORY.DOC. SHAREWARE REGISTRTION PIM48 is distributed as shareware for $25(US). You may register ... through Compuserve - GO SWREG - #2119; or direct with the author - SEND CHECK OR MONEY ORDER to: GLENN P. ROBERTSON 1954 Naskapi Drive Gloucester, Ontario CANADA K1J8K3 Registration removes the introductory screens, personalizes PIM48 for your unlimited use, provides unlimited user support, and entitles you to free upgrades. Thank you for supporting the shareware concept and for registering your use of this software. USER SUPPORT For user support, comments, or other question please contact me at the above address, by e-mail, or by phone. e-Mail - 73117.675@compuserve.com voice mail - home 613-741-8853 DEFINITIONS Appointments and todos are defined as follows: Appointments - scheduled events which occur on fixed dates and at specific times. Todos - tasks associated with specific dates but not with specific times. APPOINTMENT/TODO ACCESS Appointments are maintained in the variable (list) named "Alarms" located in the "Hidden" directory. Appointments are controlled through PIM48 or through HP48's normal time/alarm functions. Todos are maintained in the variable (list) named "ToDoList" also located in the "Hidden" directory. Todos are controlled through PIM48. CONTROL ALARMS PIM48 has the ability to handle control alarms. Control alarms can be set within PIM48 using a secondary editor. If a control alarms is set, it can then be cut, copied, and edited. Control alarms are displayed in the browser within << >>. Notes: A secondary editor can be accessed when a box is displayed beside the menu keys ADD or EDIT. The box can be toggled ON/OFF by using LS-ADD or LS-EDIT. Secondary editors provided by the user must be stored in the variable ed located in the current (or higher) directory. If ed is not present or if the format is incorrect, the internal HP48 editor is used. ALARMS IN ADVANCE OF APPOINTMENTS New in version 4.5 is the ability to have alarms go off at a set time before a given appointment. Appointments with advance alarms display both the alarm time and the appointment time. For example, if an appointment for a 09:00 am meeting is entered with an "advance" alarm time of 15 minutes, the listing in the appointment/todo browser would show "08:45A @09:00A MEETING". The advance alarm menu includes the selection of "ANY" advance time and presets for 30, 20, 15, 10, or 0 minutes. Notes: The advanced alarm feature does not support advanced times which go into the previous day. Advance times are remembered from the last use. REPEATING ALARMS Repeating alarms are displayed with a "_R" after the time. Repeating alarms can be set from within PIM48 by selecting RPT from the preview appointment menu which is displayed when an appointment/todo is ADDed or EDITed. The preview appointment display shows the repeat time on the last line. SYSTEM FLAG USEAGE The following SYSTEM flags control the calendar display, the way dates and times are displayed, and alarms are controlled: 41 - SET 24 hour clock format CLR 12 hour clock format 42 - SET European date format (dd/mm/yy) and European calendar display CLR US date format (mm/dd/yy) and US/Canada calendar display 43 - SET Repeat alarms are NOT rescheduled CLR Repeat alarms ARE rescheduled 44 - SET Acknowledged alarms ARE saved CLR Acknowledged alarms are NOT saved 57 - SET Alarm BEEP enabled CLR Alarm BEEP suppressed Note: Setting USER flag 44 allows the Alarms list to function as a historical record of past due alarms and completed todos (when they are moved to the alarms catalog). System flags 41 and 42 can be changed from within PIM48 by pressing RIGHT-SHIFT-TIME and selecting the desired format (available with both the calendar and appointment/todo browser. System flag 57 ca be toggled with the LS-Backspace key when the calendar is displayed. When sysFLAG 57 is CLR (Alarm beep suppressed) the message ALM OFF is displayed at the bottom of the calendar. HP48 COMPATIBILITY AND DISCLAIMER PIM48 has been thoroughly tested on the HP48GX (version "R"). Some users previously identified incompatibilities with the GX version "P", however, these have all been corrected. PIM48 should also be fully compatible with HP48S(X). PIM48 has no known bugs, however, normal caution is required. BACKUP YOUR HP48 BEFORE USING. The author is not responsible for any loss of data (or missed appointments or todos ) from the use of this software. INSTALLATION PIM48.ZIP contains the following files: PIM4845A.LIB (the PIM48 library in binary format); P4845LT.LIB (PIM48 "light") PIM4845A.DOC (this file); PIM4845A.INF (information file); and HISTORY.DOC (version history) Download PIM48.LIB (or P4845LT.LIB) to your HP48 as a binary file. If using KERMIT, press the menu key that shows up labeled PIM48. You should then see this on the stack: Library 1769 PIM48 ... Decide which port (0, 1, or ...) you want the program installed in. Enter this port number on the stack and press STO. Cycle the HP48 OFF then ON. PIM48 is now installed! PURGE the menu variable PIM48 if present. PIM48 auto attaches itself to the HOME directory and may be accessed from any directory by simply executing PIM48. It is recommended, however, that PIM48 ONLY be used from within the data directory associated with LM or ROLDX. To simplify this, it is recommended that path information be added to a CST menu or to a key assignment as follows: << PATH HOME 'Rtn' STO DATA.DIR PIM48 Rtn EVAL >> Note: Using this technique, the return path is STOed in the variable 'Rtn' located in the HOME directory and the stack remains clear for other uses. Assign the above to key 34.4 using the ASN function (Right-SHIFT MODES ASN) PIM48 will now be accessible at anytime by pressing ALPHA "P" while in the "USER" mode. PIM48 has the ability to save past due APPOINTMENTS and completed TODOS to a save file (PIM.SAV). This file will automatically be created if not present in the current directly or updated if it is. By always accessing PIM48 from the same directory, saved APPOINTMENTS/TODOS will always be in the same file. Version 4.3 on allows access through variables to any user defined database and any editor. To define a database, place its name within << >> and store as the variable 'db' (note the lower case). To define an editor, place its name within << >> and store as the variable 'ed' (note the lower case). These variables should be stored either in the HOME directory or in the PIM48 DATA directory. Note: The following program, when saved as 'ed', will allow appointments or todos with lists to access List Manger (LM) if this program is available else it accesses the HP48 text editor. List Manager is by the same author as PIM48 and is distributed separately. << DUP TYPE IF 5 == THEN LM ELSE # 273714d SYSEVAL END >> UNINSTALL To uninstall PIM48, enter the home directory and perform the following: ENTER (displays as 0:1769 on level 1) ENTER (creates a second copy on the stack) DETACH (MEMORY, NXT) PURGE PIM48 is UNINSTALLED! LIBRARY MENU With PIM48 installed, the following menu files are available: Main program Program information screens Recalls all appointments to the stack as a list of lists. The format is suitable for loading into the appointment catalog using APTv). Loads a list of appointments from the stack into the appointments catalog. Recalls all todos to the stack as a list of lists. The format is suitable for loading back into the todo catalog using TODv. Loads a list of todos into the todo catalog. Notes: The format for the list of appointment/todos MUST be the same as that created by APT^ or TOD^. This format is required by the HP48. CAUTION. DO NOT load appointments/todos from the stack that are already in their respective catalog. Double entries will result. The "list" created by APT^ and TOD^ can easily be transferred to a PC or MAC using KERMIT (SEND) or XMODEM (XSEND). When using KERMIT, save the list to an appropriate variable and transferred using ASCII. When using XMODEM, convert the list into a string variable (PRG, OBJ, ->STR) before saving it. This will ensure the object is transferred in ASCII format rather than in a binary format. Second menu screen (press NXT). Recalls all saved appointment and todos to the stack as a list of lists. The format is suitable for loading back into either the appointment or todo catalog using APTv or TODv. This function deletes all entries in either the ALARM catalog or the TODO catalog. When PURG is selected, a further prompt allows selection of ALMS, TODOs, pimPA, or QUIT. ALMS - DELETES all APPOINTMENTS (Alarm catalog) TODO - DELETES all TODOS (TodoList catalog) PIMPA (pimPAR) - DELETES the parameter file from the hidden directory. pimPA is used by PIM48 to retains information between sessions. QUIT Quits the PURGE functions and returns to the previous menus. THE CALENDAR The main screen of PIM48 consists of a MONTHLY CALENDAR, the current date, and an analog and digital clock. APPOINTMENTS and TODOS are displayed on the calendar with SMALL BOXES beside the appropriate date. The UPPER box represents APPOINTMENTS; the LOWER box represents TODOS. A digital readout in the top right hand corner of the calendar shows the number of DAYS-PAST/DAYS-TO-GO in the current year and the current week of the year. A digital readout in the bottom right hand corner of the calendar shows the number of DAYS BETWEEN ANY TWO DATES. LEFT-SHIFT-J.DD/J.WD toggled the readout between DAYS [J.DD] and WEEKDAYS [J.WD] (WEEKDAYS exclude Saturdays and Sundays). Note: An about screen displays registration information each time PIM48 is entered. Registration removes this reminder to register. Registration information is always available by pressing PRG. On start up, the current date is [0] and any movement of the cursor will either increment or decrement this value. You can make any date the [0] date by simply moving to that date and pressing "0" on the key board. The JUMP KEY (J.DD or J.WD) always prompts for the proper value to take you back to the [0] date. CALENDAR FORMAT The calendar can be displayed in the US/CANADIAN format (week begins on Sunday) or in the EUROPEAN format (week begins on Monday). The format can be changed within PIM48 by selecting TIME (RIGHT-SHIFT 4) and pressing the first menu key (MDY/DMY). CURSOR MOVEMENT The inverse day cursor can be moved with the cursor (arrow) keys or with the add, subtract, multiply, and divide keys. With a "box" beside TODO, the RIGHT-SHIFT RIGHT ARROW key causes the inverse day cursor to "JUMP" to the next day for which a TODO is scheduled. With a "box" beside APPT, the RIGHT-SHIFT RIGHT ARROW key causes the inverse day cursor to "JUMP" to the next day for which an APPOINTMENT is scheduled. Similarly, the RIGHT-SHIFT LEFT ARROW key will cause the inverse day cursor to "JUMP" to the previous day for which either a TODO or APPT is schedule. MOON PHASES Moon phases can be graphically displayed on the calendar (toggled ON/OFF) by pressing key 13 ['/M]. Local latitude, longitude, and time zone information is required. This information is entered through the set up function [TIME] (RIGHT-SHIFT 4) and pressing NXT. SUNRISE/SUNSET TIME With the calendar displayed, pressing the [S]IN key (key 19) displays the SUNRISE//SUNSET time for the current date. The sunrise//sunset is predicated on the local latitude, longitude, and time zone. This information is entered through the set up function [TIME] (RIGHT-SHIFT 4) and pressing NXT. The JULIAN DAY for the current date is displayed whenever the sunrise/sunset display is toggled OFF. THE CLOCK DISPLAY The clock (both digital and analog) can be toggled to run continuously (display current time) by pressing key 20 [T]. In the continuous run mode, the HP48 will shut itself off when the keyboard has been inactive for the period set for "T.OFF". T.OFF time can be set to any value and is adjusted by pressing TIME (RIGHT-SHIFT 4) and pressing the MENU key labeled T.OFF. Note. In the continuous run mode, the T.OFF time overrides the HP48's normal shutdown time of approximately 10 min. If large values are entered for T.OFF, you may drain the batteries. The clock will also run in the continuous time mode whenever the stop watch is running. When not in the continuous run mode, the clock is updated whenever a key press occurs and the time since the last change exceeds one minute. Display of the analog/digital clock can be toggled OFF and ON using the [+/-] key (key 26). When OFF, it is replaced with a snippet of either the todo or the appointment screen. SETUP SCREENS TIME/DATE and OTHER VARIABLES The internal HP48 clock can be adjusted by pressing RIGHT-SHIFT-TIME from the calendar screen. When selected, the following keys adjust the display format and time: Toggles the date display MDY or DMY <24> Toggles the time to display either a 24 hour clock or a 12 hour clock. Prompts for the input of correct date.