home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / beehive / zcat / lbrdsk23.lbr / LBRDISK2.DQC / LBRDISK2.DOC
Text File  |  1991-01-30  |  4KB  |  122 lines
  1.  
  2.     Preliminary documentation for LBRDISK (CP/M 2.2 version)
  3.  
  4.  
  5.  
  6.  
  7.                          Jim Lopushinsky
  8.  
  9.                           March 5, 1984
  10.  
  11.  
  12. What is LBRDISK?
  13. ----------------
  14.  
  15.      LBRDISK  is  an  extension of the CP/M 2.2 BDOS  (RSX)  that 
  16. allows  you to treat libraries and archives as a  logical  drive.  
  17. For  example,  to squeeze and collect into a library a collection 
  18. of text files you might do the following:
  19.  
  20. B>CREATE TEXT.LBR          <--- creates an empty library
  21. Allow how many entries: 12 <--- 12 files. 
  22. B>LBRDISK C:=TEXT          <--- allocate drive C to TEXT.LBR
  23. B>NSQ C:=*.TXT             <--- squeeze all text files into TEXT.LBR
  24.  
  25. It  doesn't matter if the assigned drive actually exists or  not.  
  26. All  transient  programs (including the CCP) have access  to  the 
  27. newly created drive.
  28.  
  29. Are there any restrictions?
  30. ---------------------------
  31.  
  32.      Yes.  LBRDISK allows modifications to the library drive only 
  33. if  one  library or archive is allocated.   If more than  one  is 
  34. allocated,  the library drive becomes Read-only,  and will return 
  35. appropriate CP/M errors if an attempt is made to write,  erase or 
  36. rename a file on the library drive.
  37.  
  38.      There  must  not  be more than one open output file  on  the 
  39. library  drive.   Programs  must  close any  output  file  before 
  40. opening another.  There are no restrictions on the number of open 
  41. input files.
  42.  
  43.      Libraries and archives are sequential files.  It is strongly 
  44. recomended  to erase a file and re-make it before writing to  it.  
  45. Writing  to an existing file is allowed.   However,  the  records 
  46. replace existing records in the old file,  and if writing  occurs 
  47. past  the  end of the file,  the next member will  be  clobbered.  
  48. Making a new file causes output records to be appended to the end 
  49. of  the library.   Random write is allowed,  but the program must 
  50. not leave any "holes" in the file.
  51.  
  52.      As  far as I can tell,  all the common utilities operate  as 
  53. expected.
  54.  
  55.      Editors should not be used, unless you are positive that the 
  56. editor maintains only one output file at a time.
  57.  
  58.  
  59. What are the programs?
  60. ----------------------
  61.  
  62.      There are two utilities associated with LBRDISK:
  63.  
  64. 1.  CREATE - to create an empty library or archive.  This utility 
  65. will run under CP/M 2.2 as well as CP/M 3.
  66.  
  67. 2.   SETRSX  - loads the RSX manager just below  the  CCP.   This 
  68. utility  must be executed prior to using LBRDISK.   It is  loaded 
  69. once only, and remains active through warm boots.
  70.  
  71.  
  72. How do I use LBRDISK?
  73. ---------------------
  74.  
  75.      Here is the syntax:
  76.  
  77. A>LBRDISK
  78.      Entering  LBRDISK with no command tail will remove the  last 
  79. active Lbrdisk RSX from memory.  If there is more than one active 
  80. Lbrdisk, only the last one loaded is removed.
  81.  
  82. A>LBRDISK C1:=B5:CASM,C:TEXT
  83.      Drive  C user 1 will be allocated to CASM on B5 and TEXT  on 
  84. C0.
  85.  
  86. B>LBRDISK C:=*,1:=A1:JRT*,2:=2:CASM,LASM
  87.      Drive C will be assigned to the following:
  88.      C0 = all libraries and archives on B0
  89.      C1 = all libraries and archives on A1 beginning with JRT
  90.      C2 = CASM on B2 and LASM on B0
  91.  
  92. In the above two examples, drive C becomes read-only.
  93.  
  94. B>LBRDISK D:=TEST
  95.      D0 will be assigned to TEST on B0.   Since only one  library 
  96. was specified, drive D becomes read-write.  If we now execute the 
  97. following:
  98.  
  99. B>LBRDISK C:=1:TESTA
  100.      A  second  library  drive is created.   C0 is  now  all  the 
  101. members  from  TESTA on B1.   There is nothing stopping you  from 
  102. using NSWP to copy members back and forth between the 2 libraries 
  103. and/or archives!
  104.  
  105. B>CREATE TEST.LBR
  106. Allow how many entries: 6
  107.      This creates an empty TEST.LBR file with room for a  maximum 
  108. of 6 members.
  109.  
  110. B>CREATE TEST.ARC
  111.      This creates an empty TEST.ARC and TEST.DIR file.
  112.  
  113. B>SETRSX
  114.      This  command  must be executed before  using  LBRDISK.   If 
  115. executed a second time,  it removes the RSX manager,  and any LBR 
  116. RSXs below it.
  117.  
  118.  
  119. Please  make  any  bug reports and/or comments to  the  SYSOP  at 
  120. Meadowlark RCP/M (403) 484-5981 @ 300/1200 baud.
  121.  
  122.