home *** CD-ROM | disk | FTP | other *** search
/ ftp.whtech.com / ftp.whtech.com.tar / ftp.whtech.com / articles / archives / limanews.exe / PLATOCAT.TXT < prev    next >
Text File  |  2006-10-19  |  4KB  |  66 lines
  1. ORIGINALLY PUBLISHED IN LIMA NEWSLETTER FEBRUARY 1988.
  2. THIS SOFTWARE IS PUBLIC DOMAIN AND AVAILABLE FROM THE LIMA USER GROUP.
  3.  
  4.  
  5. ^^^^^^^^ PLATO^CATALOG^XB^ROUTINE^DOCUMENTATION  
  6. ^^^^^^^^^^^^^^^^^by Mike Richardson 
  7. ^^^^^^^^^^^^^^^^Lima Ohio User Group 
  8.  
  9. GENERAL COMMENTS:  Trying to catalog a Plato disk by conventional techniques is
  10. futile since the file descriptor index is at sector >0167.  You can copy this
  11. sector to sector >0001, and then catalog the disk.  However, the file names
  12. returned are not very meaningful.  (If anyone knows what the names mean I would
  13. appreciate a note.)  I wrote an a/l routine that actually  catalogs the Plato
  14. disk by reading the information in the TIMENU and DISKMENU files.  To use my
  15. routine you need extended basic, 32K, and a disk system with TWO drives or one
  16. drive and a ramdisk. 
  17.  
  18. LOADING: This program is a combination of XBASIC and assembly language, and
  19. loads directly from XBASIC with OLD DSK1.PLATO.  Before you RUN the program,
  20. you need to put an initialized disk in Drive #2.  The program expects to find
  21. the Plato disk in drive #1 and you are prompted to insert the PLATO disk.
  22. Press <ENTER> rather than "N" at the flashing "N" prompt.  Don't attempt to
  23. edit the XBASIC protion of the program.  If you do, things probably won't work
  24. properly.  Once loaded, you can invoke the routine from XB command mode with
  25. ^^^^^Call Link("PLATO",TIMENU$(),TI,DISKMENU$(),DSK).^^^^^^^^ After invoking
  26. the routine the TIMENU$ string array contains information on the curriculum,
  27. subject, and program while the TI numeric variable tells us how many strings
  28. were passed back in the string array.  Likewise the DISKMENU$ array has
  29. information on the specific titles of the Plato programs and DSK specifies the
  30. number of string variables passed back. 
  31.  
  32. PROGRAM EXECUTION:  The program creates a file D/V80 file called PLATOCAT on
  33. the data disk in DSK2.  You are asked to give each plato disk your own code
  34. name.  You might, for example, give them consecutive numbers.  For each disk,
  35. PLATOCAT gives your special name, CURRICULUM name (such as High School Skills),
  36. SUBJECT name (such as Biology), PROGRAM PACKAGE (such as Biology 4), and the
  37. names of the files that appear on the disk's table of contents (such as Health
  38. tutorial, Health drill).  PLATOCAT is added to as you catalog subsequent PLATO
  39. disks, and can be read and printed with Funnelweb or TI Writer.  This plato
  40. catalog routine does not itself read PLATOCAT to the screen.  Remember to press
  41. <ENTER> every time the flashing "N" prompt appears. 
  42.  
  43. ERRORS: If the a/l routine encounters an error, it traps the error code and
  44. passes the code back to XB. 
  45.  
  46. LIMITATIONS: Not all Plato disk have TIMENU and DISKMENU files.  Consequently
  47. this program cannot catalog these disk.  It will seach all 359 sectors looking
  48. for these file names.  This was a compromise on my part as I didn't feel it was
  49. necessary to step the drive heads out to sector >0167 to read the file
  50. descriptor index each and every time. 
  51.  
  52. ACKNOWLEGEMENTS:  I used Barry Boones Systex program to hybridize the a/l
  53. routine and a DSRLNK routine from John Clulow. 
  54.  
  55. Mike Richardson 12/12/87 
  56. 927 N. Canal St. 
  57. Delphos, Ohio 45833 
  58. 216-456-0478 
  59.  
  60. EDITOR'S NOTE:  User Groups (not individuals) may obtain a copy of this program
  61. by sending a disk and mailer to the Lima User Group, P.O. Box 647, Venedocia OH
  62. 45894. 
  63.  
  64. Below is a sample printout of a small PLATOCAT file. 
  65. .PL 1
  66.