>*<>*<¢ PSINDXER.DOC¢¢ (Adapted by R.R.S. from the original¢ "PSINDXER.DOC" as downloaded and¢ UN-ARCed from GENIE file #6649)¢ and reprinted by THE OL' HACKERS AUG¢ File will be found on the Sept/Oct¢ 1995 newsletter disk!¢¢ PRINT SHOP DISK INDEXER V2.0 10/12/91¢ Program & Documentation¢ by Steve A. Walker¢ 15629 East Asbury Place¢ Aurora, Colorado 80013¢¢ 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. 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). 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 that I have for¢ this making this program was to save¢ my 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 P/S 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:¢ 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 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 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. >*<>*<¢