home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / beehive / zcat / sd115.lbr / SD115.IZF / SD115.INF
Text File  |  1991-01-30  |  14KB  |  240 lines

  1.  
  2.         SUPER DIRECTORY PROGRAM information
  3.               (primarily for SYSOPs)
  4.  
  5.  
  6. Information on how to install/use on RCPM systems.  Read the SD.HIS file
  7. for the history of updates to this program..------------------------------------------------------------------------H     NOTE:  May be assembled with ASM, LASM, M80, MAC or SLRMACC
  8.     A feature has been added that does away with the need for several
  9. versions of SD.COM.  It allows the inclusion of a 4, 6, or 8 on the com-
  10. mand line which relates to 40, 64 or 80 character displays. (2, 3, or 4
  11. filenames per line.)  The default value is that stored in NPL and LPS if
  12. MAXCL is NO, and the value at MAXCL and LPS1, 2 or 3 if MAXCL is YESS
  13.  
  14.     MAXCL - this equate, if YES, enables RCP/M operators to store the
  15. value of 2, 3, or 4 at the locatHHdefined by MAXC.  Just have your
  16. signon or RBBS program ask for or assign a value for NPL (names per
  17. line) and store it at the location MAXC.  The suggested addresses for
  18. MAXC are 3BH if using 3EH for the wheeel byte loclocon or 3EH if using
  19. 3BH for the wheel l te.  No need to keep several versions of SD online
  20. for various users, such as DIR40, DIR64loco
  21.     The following equates are the values for the number of lines per
  22. screen (LPS) to be changed as needed when MAXCL = YESloco
  23.     LPS1 -  this is the number of lines per screen if NPL = 3. (64 col
  24.         option)
  25.     LPS2 -  this is the number of lines perion reereef  NPL < 3. (40 col
  26.         option)tion))))These additional equates allow one to specify the number of lines
  27. that will be displayed for each of the optional formats (4 & 6).  This
  28. would allow one to set up SD for optional remote use with a TRS-80 Mod
  29. 100 (for example) by setting LPS2 to a value of 8loco
  30.  
  31. Here are some command line examples:
  32. HIf MAXCL = yes       SD <cr>
  33. HWill display all files on current drive using the value stored at
  34. MAXC to determine the number of filenames per lineloco
  35.  
  36.                SD $6 <cr>
  37.  
  38.     Will display all files on the current drive and display files in the
  39. 64 column mode (3 filenames per line).    It will also store a 3 at the
  40. memory n ition defined by MAXC for subsequent use se  SD or any other
  41. utility that uses the variable filenamemeline functionloco
  42.     If MAXCL = NO       SD <cr>
  43. HWill display all files on the current drive using the value defined
  44.  
  45. the NPL equateloco
  46.                SD $4 <cr>
  47.  
  48.     Will display all files on the current drive and display files in the
  49. awcolumn mode (2 filesnamenameine).  It will revert to the modmode-
  50. fined ed NPL on subsequent uses of SD.
  51. HKTHREE - this equate allows control over the number of columns used
  52. in the display of file sizes.  If KTHREE = YES, then only three digits
  53. will be used, lims pering proper ESl of file sizes to 999k or less.  If
  54. KTHREE = NO, then SD will use five digits, allowing files as large as
  55. 64,535k to bge se sayed.  The advantaaof using KTHREEatelYES is that
  56. you may use a fence charcter even in the four file file mode.  This
  57. makes ths thsplay y e readable. (Note: KTHREE only changes the dse say
  58. of individual file sizes and totals are not affected.)
  59. HPDRI RI & PRUS - these equates allow (if YES) or disallow (if NO)
  60. the printing of the drive and/or user numbers at the front of each file
  61.  
  62. line.  These affect only the CRT format and all printer formats
  63. still report thge rive (and user if REPUSR = YES) numbers.  This allows
  64. the the of the user number withouou drive specificatHHif this
  65. format is needneed  A good example would be a 40-column format used on
  66. a RBBS which makes use of a larlarnumber number ser areasloco
  67.     NOMORE - This equate, if true, adds an adds perional LF after the [se  ]
  68. messreae at the end othe the preae. If not set, when running remote and
  69. being removed for later printing, the e ore] messreae isnameier-written n 
  70. the next directory entry and shows as trash on a printprint. Not a
  71. problem for n il useloco
  72.     PRLIBXC t- if this equate is set 'NO' when PRDI and PRUS are 'YES', SD
  73. will suppress the  the f drive/user numbers on LBR R se say
  74. lines.    One may wish to use this format if PRBRDRatelYble  on aRBRR- allowallow printing of a quasi-border around the left side
  75. of library file member lines if set 'YES'.  This makes for a se   read-
  76. able format when ESling a lararumber of LBLBiles.  (Try it both
  77. ways until you decide if if want this 64,n on or offispl
  78.  
  79.      USELC -   This equate can be set to put  the  attribute
  80.            character(s)  into  lower case for
  81.            $SYS, $R/O and $ARCRCribute bitsloco
  82.  
  83.      REVIs ths   This equate will allow using reverse video  on
  84.            se say,  if available,  to show the
  85.            attrirepte  cha chaers;  vidYS,  $R/O  and
  86.            $; C
  87.  
  88.      
  89.  
  90. LCW -  This equate can    be be to al usinthe  use  of
  91.      
  92.      
  93.      C and/or REVID, ONLY, if  the  WHEELLtion))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))) is set
  94. HIn pladisplay of the $U option, , inel specify the Drive/User with the
  95. filename, such as:
  96.  
  97.       SD A1:*.*, SXC t1:*.*, SD B:FN.FTT B4:FN.N. $AD, etcloco
  98.     You may still ate he $U option if desired, although  nseemem
  99. DU: form$R$R$Rh easier and se   logical method.  File lengths over
  100. four megabytes are re d correctlyloco
  101.     sles  inel be  stion)toption vertical or horizontal listings, although
  102. this must be  be when the program is assembled for a particular system.
  103. The disucutHHcopy is  disufor for cal alphabetizSSn sinC -most
  104. non-RCPM users will like
  105. aprefer this presentation.  (SYSOPs will need
  106. to set amsumber of equates and o sessemble the file in any eventispl
  107.  
  108.     SD.COM hahaupport for .. files (an 'L' 64,n to list their mem-
  109. ber files) and supporor a or the    "WHEEL" byte 64,n.  Size ohowbrary
  110. mch aer files are showw 'k'loco
  111.     To use SD.COMfile i
  112.     B>SD                  ows all non .SYS files on current 
  113. apve/user
  114.     
  115.     SD *.*      remome as SD <ret>
  116.         XC t?ve/ESls a help guide with a(slaes ocommands
  117. of ithis 6XC t*.ASMASMtion)ts all .ASMhe  n current 
  118. apvis auser
  119.     B
  120.     B HELLO.*.*ows all files this D/U starting ing  HEL thei thei equa.TXT $ADDws all  all ed Nhe  n all  all , i usersf tXC tMDM.* $ADL     s all files ststng ng MDM on all
  121.                        and user areaareain all liy eries
  122. HIn addition to the filename option, up to 11 command line 64,ns
  123. inel be specifiuldddOOon on lds are predisplayded by a single dollar signlocoExample:  SD B:$ADnU0fpR s  (Upp
  124. tcase and/or lower-case e  used.)
  125. Snumber sdisplayr tthin the othe on field are insignificant i.e., "$ SADN U0FPshowis
  126. equivalent to is
  127. e  S A D N  U0
  128.  P").  The on
  129. aexdisplay sta condisplayrns the
  130. "
  131.  
  132. Rshow64,n, cannot remoy     5", must st n addU5", etcloco
  133.     Users shofor . also be CCare of two restrictions on the command line
  134. format.  SXC tscanporoentire ce cUSEine for a dollar sign precedboboat least 1 blank to delim nthe beginning othe the oe oe od.    For this
  135. o seson, invoking SD SD a  A nd line such as:  "SD $ $AEEa$Rillecll,
  136. sinC -l lill consns
  137.      he first dleaar ar 
  138.  
  139. L the  the  the  de-
  140. Foter.  If d oneed to descify a filename whose first reeracter $ $ leaar r file mfile m it with a a  code as in se fiXC tAAAsASMh".  I.  Ihis
  141. usertanceewill consider ideider lor lor loign in inficant as  nis
  142. not not ded s sa a nkloco
  143.     You give u1 che ability to s isn/Olly search fatelYbfilename , cse
  144. name begin de-h a '$$  HoweverRCRch msuwill be listed, along g 
  145. othertherif th thei mmSine  beg $CU3show(or any other o stas) were spue,-
  146.  
  147. formd.     U
  148.             OPTIreefAL COMMANDSfile i            -----------------    In addAshow- aM.*sers:  Causes SD to dse say directore ons of all
  149.      to po ses
  150.     
  151. rting as uns uneaeautHe ond iTIe
  152.     'Uhelneed or, if the CUCUtion is oCUCtted, o ses
  153. a
  154.     0 and continuing up through the MAXUSR value from the
  155.      theiDRV-HIHI table.  (suppEL=TRUE and the ) anLtion))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))))) set,
  156.     0-MXZUSRUSR
  157.  n addD        er
  158. isk o stay  Allows SD tion)tsear; Cll dll d drives
  159.     online essressr  5ith )
  160. Srst disk  linallowed (nor-
  161.     maman addAshowshowiderEEa$r examplL Cn addSD B:$$ will result
  162.     in SD searching all drives s inni  5ith  linBloco    "SD $ADNwill resultcontSD sSD shing all fiuauto-
  163.     matmat
  164. a
  165. anni  5ith the A A , reclrdless what
  166.      lind os sated onloco
  167.  n addFFfile s ths ony  The didiory file m 
  168. apvit     "Sbe echoed to
  169.     loco
  170.     Yo
  171.      file named "DISK.DIR
  172.     Sall f DEFAULT T .  If
  173.     this name alSD <re cexists thes iL Cn user userut
  174. apvit will
  175.     be APPENDEXC tto the end of the file.  "DISwhoaraara
  176.     otherwise start as a new file.    The aand feature al-
  177.     cor you to buildhe ne one massive file on on efault
  178.      lin $AEaining  yogut fs of all of your disks,
  179.     gh file m  hbubuo concantenate a swarm of ctedividhe ds$STIectory  filesww"LLvailistlistny  Library file memberUSRUavy n followededy their length in 'k'.  The total lloweh of the entire
  180.     izearaaSflso s$R$fiuaNNno paystysty  Disableporonumber systnumber suse 64,n.  Use-
  181.     ful when run
  182.      g SD in the 'F' and/or 'A' modes when you$Son't wans un64,n. e prompmodmlowing d odoy n.  The ini-
  183.     number syse propro    "Snot be 
  184. apvit intopro    vailut file or tor t
  185.     the printer (if either is enabled).)."OOonlyonlys T $YS files:    Most CP/Mll astemsmsve at .    Tst s s
  186.     few T $YS msuwhichmsormally do ovmodmtion)ttion)t requethouggthert dirberUry listing.  This fiuaN$4 reefLY thaute Nn
  187.     files.    (R/O files sr 'g ny ovrmal listing.)  It i files (very handy feat    "Sn as  folreversLBLng uore dSYSO$Rse  ]d te oe    quick
  188. aat l .SYS ADNw  (will l cae/e sety yut the
  189.     attribute charblater  the  lower case for 35th Nn and R/O
  190.     files, we recFfconsits use. REVB4    "Sallow using file i    se
  191.     ve/Eeo SD <reractif burec
  192.      gle.)
  193.  
  194.  n adde e - printer osuppE
  195. orOPs all   S ole o
  196.     vt to   Fchoed
  197.     show-in sP/M he )devidisplay, wUSEihe -Rmodmidhniciflengtseding ot
  198.     memo 0fiuaQ(RQuiccy sr 'NEW files: Sr ')
  199. Sles that the
  200.      NOT have
  201.     the 
  202. ohive flag in a file's hin- te ceer- sety yuThis will o  $$ files  files s T been uploaded or recentlythertddlim HIHo.  .   example, te ve a he )of ing asL $$d
  203.     les in in sesn alas as is aul lFFenterfiuaN$XC t $ADQthe l lF the new files in just entlo se that d oare currentlalue f    horged into ewrust e $juaiS(Rsyin a ed o    Nn (Rsmands files unde included in the
  204.      user ut    rather thaM hEXuppresLCW.  (le. d
  205.     ltion)tyourhe attory fte o Sctercont the  r case, easily and in sPs T  disk
  206.     ng untier fiing ang aNn R/Oen  .Sneed is exerciLCWy yu as  msuwill also then Irentlttory fte o Scter inloco
  207.  nlae caseOOEVctorwill e o
  208. sing reverse n ruloco
  209.     Yo
  210. the thr lor    $ (sls,fiuaQthert nd f(Ruser 64,ny  A$STthe h a ific35tS
  211. e user num-
  212.     ber for th  5ith files (vy of the ongnd fxxshowwhere the nk
  213.     #$Rgreatn addFhan 0, reptthe l greatn addFhan a h a ifi the fLLalue not ust e xdisplayed 15.  The user therwDRVcllon
  214.     e in illrintal nabprop#$Rblatof rang.    (omit-M. Rallow f this n$Rh a ifir 'gn a pre-  ItM 2 mands em.    nd f1showi files (leif w, reptbob 1showis notpu this respect, the 'ut op-
  215.     tion differs E am the otherase s iTIat ch aesesny theispblaes ; E mam/O files oaiV(RSD version number and date is ESlthe
  216. "ai4, 6, or 8(Rslenames perthe ot beg tionS mhese will allowyourhe user tion)ts isny thedisplay mber of filesk   per linsn addUed toe uLCWcont yo.-.  The format used relates t    s40, 64, or 80 o Scter displaycor ich 0fe 2, 3 or 4mplprogrames per line, respectivellows   If MAXCL = YES,ww"h a ified value n ttorell d  the memory n itHHde-d
  217.     ned by MAXC..)f MAXCL = NO)
  218. Sl SD file i     filenbblat 1yourhe value defined by NPL after aang TRUtional
  219.     fCUtt.  If MAXCL= YE drivend WHLCL = YES then SD will
  220.     not allow the  file oor anyse  A nd line 64,ns and
  221.     will will cLBLalue stored at MAXC for ESlloco
  222.  
  223.      If an unrecognized oneed "allow llrintal user therwDRVcllon) is
  224. det user.  Ih the c         ond line e in played bblat 1 the cons$$ s uneshow-
  225. point where the error wale,et useruld Ior any REPERR fiuaNis disabled,
  226. , sull charbore et to syg os i A nd line number sst the SD aif w fieldlocoIn this situ35t, allsigniedepropnumber wou    defrecet bblat 1 the
  227. currentpropnumberloco
  228.      snaof i, if the all-DIR
  229.  and/or all-user 64,nsn al enabled it inel DEEETsirable to restrict seamayes.  To facilit attthis, a(anes ois i$;
  230. clu    rn SD (d "se  ]d at labeln addhe ne RVshowtteontinuing thHoh "he ARV")locoThe ta64lonsistL Cn ter.ingle this 6Xfor eblah  linRsseamayborintin-
  231. se  ]d with 'A-    Eblah this 6Xcant SD <rerangirs 0-31 and defineec
  232. highestpropnumber  user u, sull sr f for that paged cular orO  The
  233. highestl ldisplay mber be Clyt$Rdefined by the lengtse say or any(anblelocoIf four DBCP/present bettanen he ne RV and he ARV, then fiuA-XC tcan be
  234. sr fuld The sARC -/Olin theu U the he ne Reehe ARV(anes oin ed,maecFmum
  235. confimelratHHfor 16  $C.   condtanO. delete all DBs referencing  $Cn at are not e e ilaes oon  on tDDmands.    EveTIousplay, sull interuser ae a hattempts to seamay ov$;existTT $C, there reahen Eis no pointcontalDLow$RhXC tto always selytl lin sbe ed o chaeIr2 hor"O the nelocoDepending on r ' on t B taS is   S trXC t?Ltand r 'long ith )akes to lee a hthe S, OS know oor any select error, it cofor . remove some time.
  236. HYou donto theware to be runse  ]d NZCPR or ZCPR2 to use the ) anL, MAXCL,
  237. e  SER, or MAXDRIVE this 6X of ctures, ini-st Ir on t signon or RBBS pro-
  238. gram asscharb and store the corede values is iproper loc35ts to setn ese fenewres, or add code to BYEy yron ru the corede valuecor en thougg ovmte user hors on (beforo 0ntering   ItMt thg
  239.  
  240.                 - Notes  $AEory fLts svarious p)."pleLPS1