ROLDX.LIB Copyright 1990 Tom Mullin Program: ROLDX.LIB Target: HP48 with serial cable Bytes: 3714 Checksum: #8F69h (when stored as object) Version: 1.0 Date: 9-12-1990 ----------------------------------------------------------------- Features: - Holds name, address, and phone numbers. Allows for quick access to any one entry. The entries are sorted on last name as they are entered. The program mimics an actual rolodex. To find a name zero in on the first letter of the last name then leaf thru the remaining entries. - The program is contained in library for reduced clutter. - Data is kept in user memory. All Data is kept in just one file. Just the data needs to be backed up. The program will start a new data file if one is not present. - The program can be invoked from anywhere and will pop up current entry. - The program will cleanup after itself restoring: stack, flags, directory and menu. ----------------------------------------------------------------- Installation: - Copy the file roldx.lib to your root directory. - Recall the file to the stack. - Type :0:1 STO ENTER to store the library in port 0. - Purge roldx.lib (it isn't needed anymore) - Turn the 48 off then on. The display should blink. - Type :0:807 ATTACH to attach the library to the home directory. ----------------------------------------------------------------- Program Invocation: - First use the installation procedure detailed above. - The program can be run by selecting it from the library menu. It can also be executed by typing ROLDX. Because the library is attached to the home directory it can be accessed anywhere. - If desired, the program can be attached to a key: Example: Type << ROLDX >> 45.3 ASN to assign the program to the LOG key in user mode. ----------------------------------------------------------------- Using the Rolodex - The first time the program is invoked it will create an empty database in the current directory. You should be in the home directory the first time you invoke the rolodex. See the section below on placement of files. - The active menu keys : [EXIT] [ADD] [EDIT] [DEL] [PREV] [NEXT] - [EXIT] This will exit the program. The stack, directory, flags, and menu will be restored. - [ADD] The user will be prompted to enter the four fields of an entry: first name, last name, address (use CR\LF to separate multiple lines), and phone number. The ENTER bar will end each entry. The two name entries enable sorting the phone list alphabetically on the last name. If no first name leave that entry blank. Example: Educalc would not have a first name entry and would be sorted under the 'E''s. Example: Joe Smith would be sorted under the 'S''s. All entries wider then two characters will be converted to mixed case. - EDIT: The current entry will be edited. The user will be prompted for the field to edit. The ENTER bar will end an entry. - DEL: The user will be prompted to delete the current entry. - PREV: The previous entry will displayed. - NEXT: The next entry will be displayed. ----------------------------------------------------------------- Speed Searching Keys: - The A-Z keys can be used to quickly go to any entry. - [G - Z,' '] Push the key and the first entry that starts with that letter will be displayed. Example: The number of Joe Smith is desired. Push 'S'. The First 'S' entry will be displayed. Push the 'S' key repeatedly to view all the 'S' entries. If an entry's last name doesn't start with a letter A-Z then it will be stored at the end of the database. The space key will go right to these entries. Repeatedly pressing this key will view all these non alphabetical entries. - [alpha A-F] Because of the menu keys the alpha shift key will have to be pressed first to speed search the letters 'A' - 'F'. Example : The number of Educalc is to be displayed. Push the alpha shift key then 'E'. The first 'E' entry will then become the current entry. ----------------------------------------------------------------- Placement of Files: The program resides in a library. The data is contained in a list ('Roldata') that resides in the current directory or the home directory. If Roldata is in neither of these two locations the file Roldata will be created in the current directory. ROLDX should be invoked for the first time from the home directory. This will place the data file in the home directory making it accessible from anywhere. The user can also have multiple phone lists by creating multiple Roldatas in different subdirectories. ------------------------------------------------------------------- Thanks to Eric L. Hernes I. for the original HP28 rolodex program (ITEM #14 comp.sys.handhelds) Also thanks to HP BBS for the USRLIB program. Future release: - Speed Search on more then just the first entry. - String packing would decrease the 'Roldata' size. - I wish there was an OBGET function on the HP48. It would streamline ROLDX. Maybe an assembly language routine would get a string from a list of lists of strings. - Allow user to modify number and name of fields to allow for different databases to be serviced by the same library. - Have data sorted by separate B-Tree index. User could sort data on say phone number, city, etc on the fly. - Add [DIAL] key if it ever becomes possible to use the HP48 as a phone dialer ROLDX Copyright 1990 Tom Mullin This library can be freely distributed under the following conditions: 1) This file must be included with the program if possible. 2) You may not charge money for this library. Comments: Tom Mullin, 2412 Palm Ave. Manhattan Beach, CA 90266 213-545-9888 evenings or tmullin on HP BBS