=-=-=-=-=¢ PSINDXER.DOC ¢¢ (Adapted by R.R.S. from the original¢ "PSINDXER.DOC" as downloaded and¢ UN-ARCed from GENIE file #6649),¢ and printed by OL' HACKERS A.U.G.¢ (program is on this disk!)¢¢ PRINT SHOP DISK INDEXER¢ Version 2.0 12-OCT-91¢ Program and Documentation by¢ Steve A. Walker¢ 15629 East Asbury Place¢ Aurora, Colorado 80013¢¢ FROM THE AUTHOR!¢¢ This program is SHAREWARE. I have¢ spent a great deal of time designing,¢ coding, debugging, and modifying it. A¢ minimum donation of $6 that I might¢ receive for my time and effort will¢ encourage me to continue supporting¢ this program, as well as writing new¢ software for Atari 8-bit computers.¢ Thank you.¢¢ A UTILITY FOR ME!¢¢ Release 1.0 was written as a¢ utility program to index all of my PS¢ ICON disks. The program was written¢ for myself without much design and to¢ be used only a few times (originally). ¢ MORE WORK,¢¢ A NEW AND BETTER VERSION¢¢ Release 2.0 is a complete re-¢ write to allow more of a user¢ interface. It was submitted to the¢ Atari Club of Denver programming¢ contest of October 1992, and took¢ first place; but that may be due more¢ to the way I did the Demo (to avoid¢ errors). Suggestions or comments ¢ about the program can be posted via¢ the Atari Club BBS:- (303) 343-¢ 2956¢¢ PURPOSE:¢¢ The main reason for this program¢ was to save time searching for an ICON¢ to use for my family newsletter. I¢ had printed out all of the ICONS but¢ with over some 2000 to go thru I ended¢ up wasting more time paging through my¢ notebook instead of writing the news-¢ letter. So I decided to write this¢ program with the idea of pulling the¢ PS ICON names from each disk and¢ writing it to a file with a special¢ identifier and disk side label and¢ then sorting by the PS ICON name. I¢ ended up with twenty files that¢ identified each of my twenty PS ICON¢ disks I gave up on sorting the files¢ and uploaded all of them to the DEC¢ /VAX at work and appended all twenty,¢ sorted and printed out the listing,¢ which is now in my notebook along with¢ PS ICONs. I did download the single¢ file which took up over 700 sectors. ¢ Now I have since acquired several more¢ PS ICON disks which I have not added¢ to the main listing. I may in a¢ future release allow combining of¢ existing sorted files to be joined¢ into one sorted file for print out.¢¢ REQUIREMENTS:¢¢ This routine is in Atari Basic¢ and requires (naturally) a disk drive¢ and PS ICON disks. Besides the PS¢ ICON disks, you'll need a formatted¢ Atari or Spartdos disk for saving your¢ indexed files.¢¢ HOW IT WORKS:¢¢ Basically the routine performs a¢ directory of PS Icon names and saves¢ them in memory, by the dimensioned¢ variable name PSNAME$. Depending how¢ often you want to save to disk, you¢ may want to increase the size of the¢ PSNAME$ (Line 80). This would allow¢ you to index several PS ICON disks¢ under one file name. Beware that you¢ may receive Error-5 "string length¢ error" when you try and index more¢ names than PSNAME$ can hold. If you¢ save the index, after the string¢ length error, the last entry may not¢ be indexed. You may press "ESC" and¢ clear out the whole PSNAME$ variable¢ and re-run.¢¢ MENU: USE ARROW KEYS ¢¢ N Tag Record D1:Source¢ N Sort Record D1:Destination¢ Y Trim Record ON Screen Prt¢ 1 Disk # A Disk Side¢¢ To move around on the menu just¢ use your arrow keys (without control).¢ It allows for wrap around. To make¢ your selection just move your arrow¢ key to the desired option and press¢ [RETURN]. Most options will toggle¢ back and forth. The following¢ identifies the settings:¢¢ Y/N-Tag Record:¢¢ Saves names with disk ID (Index).¢ When set to "N" only the name is saved¢ (i.e. disk ID is not added). This¢ option was allowed to create a data¢ output file for another program. N-¢ Sort Record:¢¢ NOT AVAILABLE!!!¢¢ N/Y-Trim Record: ¢¢ Setting this option to "Y" will¢ save disk space. The name will have¢ the disk ID right after it. It may be¢ a little hard to read the name¢ ("FLOWER#001A") I prefer to set it to¢ "N", this will pad blanks to the right¢ of the name, when it is less than 15¢ characters ("FLOWER #001A"). When the¢ name is 15 char. the disk ID will be¢ right after it.¢¢ 1 Disk #:¢¢ Pressing RETURN will give you a¢ "?". Enter your disk Identifier (ID)¢ number. YOU MUST KEEP TRACK of your¢ own numbering. The largest value is¢ "999". If less then 3 or 2 char-¢ acters the ID will be filled in with¢ leading "0" (i.e. "001") DO NOT ENTER¢ LEADING "0". D1:Source: Toggle¢ 1-4 for source drive that contains¢ your PS ICONS to read.¢ D1:Destination:¢¢ Toggle 1-4 for output drive.¢ Press OPTION and enter your index¢ filename after the "?". ON/OFF Screen¢ Prt: Prints PS ICON names at the¢ bottom of the screen.¢¢ A/B Disk Side:¢¢ Part of the disk Identifier (ID).¢ YOU MUST KEEP TRACK of which side you¢ Indexed. ¢¢ OPTION:¢¢ Index filename.¢¢ SELECT:¢¢ Save index. ¢¢ START:¢¢ Read PSICON disk.¢¢ RUNNING THE PROGRAM ¢¢ START:¢¢ Insert your PRINT SHOP Graphics¢ disk and Press [START] to read. Once¢ the PSICON disk side has been read,¢ you may elect to save or continue with¢ another PSICON disk. Be sure to change¢ your disk #ID and side number before¢ running again.¢¢ SELECT:¢¢ Pressing SELECT will check to¢ ensure that you have a filename¢ available for saving, if not you will¢ be prompted for a filename.¢¢ OPTION:¢¢ This is used to enter your¢ filename to save as. DO NOT include¢ your drive number ("D?:"), the toggle¢ is used to change drive assignment. ¢¢ STATS¢¢ 0 <bytes-saved-records> 0 The¢ stats display to the left is the¢ running total of bytes saved in the¢ PSNAME variable. The display to the¢ right is the total number of PS ICON¢ name records read.¢¢ NOTES:¢¢ Pressing "ESC" will perform a CLR¢ of memory. The machine language¢ routine for reading the PS ICON disks¢ does not perform any error trapping, ¢ so make sure you have PS ICON disk in¢ the correct drive. The cursor posit-¢ ion is incorrect after you input the¢ filename, it will display over the¢ "Trim Record" toggle option. This is¢ misleading, it is still sensing over¢ the last entry before the filename was¢ entered. Haven't been able to figure¢ out how to get the cursor display¢ where it should be after the INPUT¢ command. ¢ *+*+*¢¢
