home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / cpm / zcpr2 / xdir3.hlp < prev    next >
Text File  |  1994-07-13  |  28KB  |  629 lines

  1. Overview of XDIR3
  2. Basic Use of XDIR3 under ZCPR2
  3. XDIR3 Output Control Options
  4. XDIR3 File Selection Options
  5. XDIR3 File Name Buffer Facility
  6. Use of XDIR3 on Secure Systems
  7. Overview of XD
  8. Installation of XDIR3 and XD
  9. :Overview of XDIR3
  10.  
  11.      XDIR│á i≤ aε extendeΣ director∙ displa∙ utilit∙ designeΣá t∩ ì
  12. ruεá unde≥ CP/═ 2.▓ anΣ suppor⌠ somσ oµ thσ extendeΣ feature≤á oµ ì
  13. ZCPR▓ a≤ well«  An∙ conventiona∞ CP/═ 2.▓ use≥ ma∙ usσ XDIR3¼ bu⌠ ì
  14. hσá shoulΣ makσ surσ hσ turn≤ ofµ thσ ZCPR2-specifiπ feature≤á b∙ ì
  15. runninτá thσá ZCPR▓ Installatioε Program¼á GENINS¼á oε XDIR│á anΣ ì
  16. manuall∙ turninτ theφ ofµ beforσ usinτ XDIR3.
  17.  
  18.      XDIR│á automaticall∙á adapt≤ t∩ an∙ Org-░ CP/═á 2.▓á system¼ ì
  19. regardles≤ oµ thσ sizσ oµ it≤ disks«  I⌠ read≤ thσ disδ paramete≥ ì
  20. blocδ informatioε froφ thσ operatinτ systeφ t∩ determinσ wha⌠ thσ ì
  21. attribute≤á oµá thσá disδ i⌠ i≤ workinτ witΦá are¼á anΣá i⌠á theε ì
  22. present≤ it≤ displa∙ informatioε accordingly.
  23.  
  24.      XDIR3 runs in two basic modes:
  25.           . as a directory display utility
  26.           . as a file scanner utility (File Name Buffer Facility)
  27.  
  28.      XDIR│á i≤ ß ZCPR▓ utilit∙ whicΦ support≤ thσ extendeΣá ZCPR▓ ì
  29. features¼ particularl∙ nameΣ directories.
  30.  
  31.      A≤áá ßá director∙á displa∙á utility¼áá i⌠á display≤á t∩á yo⌡ ì
  32. informatioεá abou⌠á thσ file≤ oε ß particula≥ disδá iεá al∞á use≥ ì
  33. area≤á o≥á ß particula≥ use≥ area«á  I⌠ give≤ yo⌡á thσá followinτ ì
  34. information:
  35.           . Name of File
  36.           . Size of File (in K bytes)
  37.           . Attributes of File (Read/Only or System)
  38.           . Sum of Sizes of All Files Displayed
  39.           . Total Number of Files on Disk
  40.           . Amount of Space Remaining on Disk
  41.           . What Disk and What User Area you are looking at
  42.  
  43.      A≤ ß filσ scanne≥ utility¼ i⌠ doe≤ thσ following:
  44.           . Logs a group of selected files to disk for later scan
  45.           . Prints the contents of such a log file
  46.           « Scan≤ ß loτ filσ anΣ compare≤ i⌠ witΦ thσ file≤
  47.                selected by you, telling you what files are
  48.                missing and what files are additional
  49.  
  50.      XDIR│ i≤ quitσ human-oriented¼á witΦ man∙ built-iεá feature≤ ì
  51. whicΦá providσá ßá human-interfacσ typσ oµ servicσ t∩á thσá user«  ì
  52. Some of these include:
  53.  
  54.           . Named Directories may be specified
  55.           . The file listing is alphabetized by file name and
  56.                type or file type and name, depending on user
  57.                preference
  58.           . The file listing is organized vertically or
  59.                horizontally, depending on user preference
  60.           . Output may also be sent to disk or printer
  61.           « XDIR│ i≤ designeΣ t∩ ruε quickly
  62.  
  63. :Basic Use of XDIR3 under ZCPR2
  64.  
  65.      XDIR3 is invoked by one of the following command lines:
  66.  
  67.           XDIR afn oooo... or XDIR afn /oooo...
  68. and
  69.           XDIR /oooo...
  70.  
  71. where all elements after the XDIR command are optional.
  72.  
  73.      'afnºá i≤ aε ambiguou≤ filσ reference¼á a≤ describeΣ oεá thσ ì
  74. followinτ frames«á  'oº i≤ aε optioε letter¼ whicΦ i≤ onσ o≥ morσ ì
  75. oµá thσ option≤ describeΣ oε thσ nex⌠ frame«á  Notσ tha⌠ sincσá ß ì
  76. slasΦ denote≤ tha⌠ aε optioε follows¼ aε afε ma∙ no⌠ begiε witΦ ß ì
  77. slash«á  Thi≤á caε bσ changeΣ b∙ aε equatσ iε thσ sourcσ codσá oµ ì
  78. XDIR3 if desired.
  79.  
  80.  
  81.           Aa - Set the attributes of the files to be displayed
  82.                a=S for System Files, a=N for Non-System Files
  83.                a=A for All Files (Non-System and System)
  84.           D  - Send Output to Disk
  85.           Ff - Engage File Name Buffer Facility
  86.                f=L to Log File Names to FNAMES.DIR
  87.                f=P to Print Names Stored in FNAMES.DIR
  88.                f=S to Scan Disk and Compare to FNAMES.DIR
  89.           I  - Inspect files selected by FL option
  90.           N  - Negate Selection; select those files which do NOT
  91.                     match the ambiguous file name
  92.           Oo - Toggle Output Control Options
  93.                o=A for File Attributes, o=F for Form Feed
  94.                o=G for Grouping, o=H for Horiz/Vert Format
  95.           P  - Send Output to Printer
  96.           PF - Same as POF (Abbreviated Form)
  97.  
  98.  
  99.      'afn' is an ambiguous file reference, of the general form:
  100.  
  101.           dir:filename.typ
  102.  
  103. where
  104.      filename.typ   is a conventional CP/M ambiguous file name
  105.                          (wild card characters of ? and * are OK,
  106.                          but file name must NOT start with /)
  107.      dir:           is a ZCPR2 directory specification, which may
  108.                          be one of the following forms:
  109.           d:        where 'd' is a disk letter (A-P) to indicate
  110.                          the current user area on that disk
  111.           u:        where 'u' is a user number (0-31) to indicate
  112.                          that user on the current disk; 'u' may
  113.                          be a '?', in which case all user areas
  114.                          are selected
  115.           du:       where 'du' specifies both disk and user
  116.           name:     where 'name' is the name of a directory
  117.                          (disk/user area)
  118.  
  119.      Examples of an ambiguous file reference are:
  120.  
  121.           A:FILE.TXT          A4:FILE.TXT
  122.           ROOT:FILE.TXT       A?:*.COM
  123.           12:*.*              A12:SYSLIB*.*
  124.  
  125.      Examples of an XDIR3 command are:
  126.  
  127.           XDIR ROOT:*.COM AAN
  128.                -- Select All Files in directory ROOT which do
  129.                   NOT match *.COM
  130.           XDIR B10: ASD
  131.                -- Select the System Files in B10, and send
  132.                   output to disk as well as console
  133.           XDIR /AADP
  134.                -- Select All Files in current directory, and
  135.                   send output to disk and printer as well as
  136.                   console
  137. :XDIR3 Output Control Options
  138.  
  139.      These options are:
  140.  
  141.           D  - Send Output to Disk
  142.           Oo - Output Control
  143.                OA - Toggle Display of File Attributes
  144.                OF - Toggle Send of Form Feed with Print
  145.                OG - Toggle File Grouping (name/type or type/name)
  146.                O╚ - Togglσ Forma⌠ (Horizonta∞ o≥ Vertical)
  147.           P  - Send Output to Printer
  148.           PF - Same as POF, which sends output to printer and
  149.                form feeds when done
  150.  
  151.      ─ anΣ ╨ arσ fairl∙ obvious«á  Iµ ╨ i≤ specified¼á thσ outpu⌠ ì
  152. goe≤ t∩ you≥ printe≥ (CP/═ LST║á device⌐ a≤ wel∞ a≤ you≥ console«  ì
  153. Iµá ─ i≤ specified¼á thσ outpu⌠ goe≤ t∩ you≥ curren⌠ director∙ a≤ ì
  154. thσ filσ XDIR.DIR«  Iµ XDIR.DI╥ alread∙ exists¼ i⌠ i≤ replaced.
  155.  
  156.      Al∞á oµá thσá O∩ option≤ arσ toggled«á  If¼á vißá GENIN╙á a⌠ ì
  157. installatioε time¼ yo⌡ selecteΣ n∩ displa∙ oµ filσ attributes¼ O┴ ì
  158. wil∞á causσá thi≤ defaul⌠ t∩ bσ toggleΣ anΣ thσá filσá attribute≤ ì
  159. displayed.  The same is true with the OF, OG, and OH forms.
  160.  
  161.      O┴á allow≤á yo⌡ t∩ selec⌠ you≥ displa∙ t∩ includσá thσá filσ ì
  162. attribute≤ field«á  Thi≤ field¼á whicΦ occur≤ afte≥ thσ filσ sizσ ì
  163. i≤ printeΣ fo≥ eacΦ file¼á optionall∙ contain≤ thσ letter≤ ╥á anΣ ì
  164. S¼á indicatinτá tha⌠á thσ preceedinτ filσ wa≤ Read/Onl∙á (iµá thσ ì
  165. lette≥á ╥ appears⌐ anΣ tha⌠ thσ preceedinτ filσ wa≤ ß Systeφ filσ ì
  166. (iµ thσ lette≥ ╙ appears)«á  Iµ ╥ i≤ no⌠ present¼ thσ filσ i≤ NO╘ ì
  167. Read/Onl∙ (i⌠ i≤ Read/Write)¼á anΣ iµ ╙ i≤ no⌠ present¼á thσ filσ ì
  168. is Non-System.
  169.  
  170.      O╞á allow≤á yo⌡ t∩ selec⌠ aε automatiπ forφá feeΣá wheεá thσ ì
  171. director∙á displa∙ i≤ sen⌠ t∩ thσ printer«á  Iµ printe≥ outpu⌠ i≤ ì
  172. selecteΣ (╨ option⌐ AN─ thσ forφ feeΣ flaτ i≤ ON¼á theε thσá las⌠ ì
  173. linσá oµ thσ printou⌠ wil∞ bσ followeΣ b∙ ß forφ feeΣá character«  ì
  174. Man∙á printer≤ responΣ t∩ thi≤ characte≥ b∙ advancinτ t∩ thσá to≡ ì
  175. oµ thσ nex⌠ page«á  Note║  thσ specia∞ forφ P╞ i≤ provideΣ t∩ ac⌠ ì
  176. thσá samσ a≤ ╨ (fo≥ turninτ oε printe≥ output⌐ anΣ O╞ (t∩á togglσ ì
  177. the form feed function).
  178.  
  179.      O╟á allow≤ yo⌡ t∩ selec⌠ you≥ displa∙ t∩ bσ alphabetizeΣá b∙ ì
  180. filσá namσ anΣ typσ o≥ typσ anΣ name«á  Iµ b∙ filσ namσ anΣ type¼ ì
  181. theε AA.TX╘ come≤ beforσ BB.COM«á  Iµ b∙ filσ typσ anΣ name¼ theε ì
  182. BB.CO═á come≤ beforσ AA.TXT«á  Alphabetizatioε b∙ filσá namσá anΣ ì
  183. typσ group≤ file≤ oµ thσ samσ namσ togethe≥ (F╬ fields¼á likσ al∞ ì
  184. XDIR3.¬á files)¼á whilσ b∙ filσ typσ anΣ namσ group≤ file≤ oµ thσ ì
  185. samσ typσ togethe≥ (F╘ fields¼ likσ al∞ *.TX╘ files).
  186.  
  187.      O╚ allow≤ yo⌡ t∩ selec⌠ you≥ alphabetizeΣ file≤ t∩ bσ listeΣ ì
  188. dowεá thσá screeε (vertical⌐ o≥ acros≤ thσá screeεá (horizontal)«  ì
  189. Thσ screeε i≤ divideΣ int∩ threσ columns¼á anΣ ß vertica∞ listinτ ì
  190. alphabetize≤ dowε thσ firs⌠ column¼ theε thσ second¼ anΣ theε thσ ì
  191. third¼ whilσ ß horizonta∞ listinτ alphabetize≤ first¼ second¼ anΣ ì
  192. thirΣ column≤ oε thσ firs⌠ line¼ anΣ s∩ oε witΦ eacΦ line.
  193.  
  194.      ╔á likσ t∩ grou≡ m∙ listing≤ b∙ filσ typσá first¼á anΣá theε ì
  195. name¼á anΣá ╔ als∩ prefe≥ thσ vertica∞ displa∙ format«á  Herσá i≤ ì
  196. sucΦ ß listing (generated by the command line "XDIR"):
  197.  
  198. XDIR III, Version 1.6    Vertical Listing by File Type and Name
  199.  Disk: B  User:   7, File Attributes:  Non-System
  200.  
  201. Filename.Typ Size K RS   Filename.Typ Size K RS   Filename.Typ Size K RS
  202. -------- --- ------ --   -------- --- ------ --   -------- --- ------ --
  203. BIO     .DOC      4      GAUDE   .TXT      4      SWCT    .TXT      8      
  204. XDIR3   .HLP     24      SCCE    .TXT      8      SWDISTCT.TXT      4      
  205. BIO     .TXT      4      SCOST   .TXT      4      TRPT    .TXT      4      
  206. BOOKCT  .TXT     12      STATUS  .TXT      8      UNIX    .TXT     24      
  207. CARTERS .TXT      4      
  208.    13 Files Occupying   112K,    96 Files on Disk and  4088K Free
  209.  
  210.      Note that we are alphabetized down the columns by file type.
  211.  
  212.      Somσá prefe≥á no⌠á t∩ seσ thσ Filσá Attribute≤á Field≤á (thσ ì
  213. column≤á headeΣ b∙ RS)«á  ╔ caε togglσ thi≤ ofµ (fo≥ thi≤ displa∙ ì
  214. only⌐ b∙ usinτ thσ O┴ optioε (generateΣ b∙ thσ commanΣ linσ "XDI╥ ì
  215. /OA"):
  216.  
  217. XDIR III, Version 1.6    Vertical Listing by File Type and Name
  218.  Disk: B  User:   7, File Attributes:  Non-System
  219.  
  220. Filename.Typ Size K   Filename.Typ Size K   Filename.Typ Size K
  221. -------- --- ------   -------- --- ------   -------- --- ------
  222. BIO     .DOC      4   GAUDE   .TXT      4   SWCT    .TXT      8   
  223. XDIR3   .HLP     24   SCCE    .TXT      8   SWDISTCT.TXT      4   
  224. BIO     .TXT      4   SCOST   .TXT      4   TRPT    .TXT      4   
  225. BOOKCT  .TXT     12   STATUS  .TXT      8   UNIX    .TXT     24   
  226. CARTERS .TXT      4   
  227.    13 Files Occupying   112K,    96 Files on Disk and  4088K Free
  228.  
  229.      Note║á  thσá R╙á column≤ arσ no≈ removed«á  ┴ GENIN╙á optioε ì
  230. exist≤ whicΦ allow≤ yo⌡ t∩ se⌠ thi≤ typσ oµ displa∙ a≤ default.
  231.  
  232.      Froφ thi≤ poin⌠ forward¼á fo≥ thσ conveniencσ oµ thσ displa∙ ì
  233. size¼á ╔á wil∞ usσ thσ O┴ option«á  Somσ prefe≥ t∩ alphabetizσ b∙ ì
  234. filσ name«á  ╔ aφ usinτ thσ O╟ optioε t∩ fli≡ thi≤ (generateΣá b∙ ì
  235. thσ commanΣ linσ "XDI╥ /OAOG"):
  236.  
  237. XDIR III, Version 1.6    Vertical Listing by File Name and Type
  238.  Disk: B  User:   7, File Attributes:  Non-System
  239.  
  240. Filename.Typ Size K   Filename.Typ Size K   Filename.Typ Size K
  241. -------- --- ------   -------- --- ------   -------- --- ------
  242. BIO     .DOC      4   SCCE    .TXT      8   SWDISTCT.TXT      4   
  243. BIO     .TXT      4   SCOST   .TXT      4   TRPT    .TXT      4   
  244. BOOKCT  .TXT     12   STATUS  .TXT      8   UNIX    .TXT     24   
  245. CARTERS .TXT      4   SWCT    .TXT      8   XDIR3   .HLP     24   
  246. GAUDE   .TXT      4   
  247.    13 Files Occupying   112K,    96 Files on Disk and  4088K Free
  248.  
  249.      Again¼á wσ arσ alphabetizeΣ dowε thσ columns¼á bu⌠ thσ orde≥ ì
  250. i≤ b∙ filσ namσ anΣ theε filσ type.
  251.  
  252.      Finally¼á somσá prefe≥á horizonta∞ a≤á opposeΣá t∩á vertica∞ ì
  253. listings«á  Herσá i≤á anothe≥á listinτ whicΦá i≤á horizonta∞á anΣ ì
  254. grouped by file name first (generated by "XDIR /OAOH"):
  255.  
  256. XDIR III, Version 1.6    Horizontal Listing by File Type and Name
  257.  Disk: B  User:   7, File Attributes:  Non-System
  258.  
  259. Filename.Typ Size K   Filename.Typ Size K   Filename.Typ Size K
  260. -------- --- ------   -------- --- ------   -------- --- ------
  261. BIO     .DOC      4   XDIR3   .HLP     24   BIO     .TXT      4   
  262. BOOKCT  .TXT     12   CARTERS .TXT      4   GAUDE   .TXT      4   
  263. SCCE    .TXT      8   SCOST   .TXT      4   STATUS  .TXT      8   
  264. SWCT    .TXT      8   SWDISTCT.TXT      4   TRPT    .TXT      4   
  265. UNIX    .TXT     24   
  266.    13 Files Occupying   112K,    96 Files on Disk and  4088K Free
  267.  
  268.      Thσá O╞á forφ i≤ no⌠ illustrateΣ herσ sincσ i⌠ result≤ iεá ß ì
  269. forφáá feeΣá oεá thσá printe≥á anΣá doe≤á no⌠á lenΣáá itselµáá t∩ ì
  270. demonstratioε oε thσ CR╘ likσ thσ others«  Thσ format¼ oµ course¼ ì
  271. is similar to the others.
  272. :XDIR3 File Selection Options
  273.  
  274.      Thσá followinτá option≤ (anΣ thσ DIR║á field⌐á contro∞á filσ ì
  275. selection:
  276.  
  277.           Aa - Set the attributes of the files to be displayed
  278.                a=S for System Files, a=N for Non-System Files
  279.                a=A for All Files (Non-System and System)
  280.           N  - Negate Selection; select those files which do NOT
  281.                     match the ambiguous file name
  282.  
  283.      Thσ ╬ optioε negate≤ you≥ ambiguou≤ filσ namσ reference¼ bu⌠ ì
  284. i⌠á stay≤á iε thσ SAM┼ se⌠ oµ systeφ o≥á non-systeφá files«á  Fo≥ ì
  285. instance¼á XDI╥á *.CO═ /NA╙ select≤ al∞ SYSTE═ file≤ whicΦ d∩ NO╘ ì
  286. matcΦ *.COM«  Iµ yo⌡ havσ installeΣ XDIR│ t∩ automaticall∙ selec⌠ ì
  287. botΦ SYSTE═ anΣ NON-SYSTE═ files¼á theε XDI╥ *.CO═ /╬ wil∞ selec⌠ ì
  288. all non-COM files in your current directory.
  289.  
  290.  
  291.      Thσá ┴á optioεá set≤á thσ attribute≤á oµá thσá file≤á t∩á bσ ì
  292. displayed«á  Iµ A┴ i≤ presented¼á theε botΦ Non-Systeφ anΣ Systeφ ì
  293. file≤ wil∞ bσ displayed«á  Iµ AS¼á theε jus⌠ Systeφ files¼ anΣ iµ ì
  294. AN¼ theε jus⌠ Non-System«
  295.  
  296.      Yo⌡á caεá se⌠á thσá defaul⌠ filσá attributσá displa∙á t∩á bσ ì
  297. whateve≥áá yo⌡á desire«áá  Usinτá GENINS¼áá yo⌡á caεá havσá XDIR│ ì
  298. automaticall∙ selec⌠ jus⌠ thσ Systeφ files¼á jus⌠ thσá Non-Systeφ ì
  299. files¼á o≥á botΦ Non-Systeφ anΣ Systeφ file≤ wheneve≥ yo⌡ ruεá i⌠ ì
  300. withou⌠ usinτ thσ ┴ option.
  301.  
  302.  
  303. B7>xdir root:*.com aanoa
  304.  
  305. XDIR III, Version 1.6    Vertical Listing by File Type and Name
  306.  Disk: A  User:  15, File Attributes:  Non-System System
  307.  
  308. Filename.Typ Size K   Filename.Typ Size K   Filename.Typ Size K
  309. -------- --- ------   -------- --- ------   -------- --- ------
  310. VITALS  .BAD      4   VFILER  .CMD      4   SYSIO   .IO       4   
  311. ASM     .CFG      4   CPZM    .CPM     12   EBCDIC  .XLT      4   
  312. C       .CFG      4   CPZMH   .CPM     12   MULTICS .XLT      4   
  313. DBASE   .CFG      4   LD      .DIR      4   PARITYEV.XLT      4   
  314. PASCAL  .CFG      4   NAMES   .DIR      4   PARITYOD.XLT      4   
  315. STD     .CFG      4   BAD     .DOC      8   NEWDISK .ZEX      4   
  316. TEXT    .CFG      4   NOTESHD .DOC     16   
  317.    20 Files Occupying   112K,   303 Files on Disk and  1884K Free
  318.  
  319.      Thi≤ select≤ al∞ non-CO═ file≤ iε thσ director∙ ROOT«á  BotΦ ì
  320. Systeφ anΣ Non-Systeφ file≤ arσ selected.
  321.  
  322.  
  323. B7>xdir root:*.com asnoa
  324.  
  325. XDIR III, Version 1.6    Vertical Listing by File Type and Name
  326.  Disk: A  User:  15, File Attributes:  System
  327. No files selected --  1884K Free
  328.  
  329.      Thi≤ select≤ thσ non-CO═ Systeφ file≤ iε thσ director∙ ROOT«  ì
  330. Note that no files matched that selection.ì
  331.  
  332.  
  333. B7>xdir root:*.com noa
  334.  
  335. XDIR III, Version 1.6    Vertical Listing by File Type and Name
  336.  Disk: A  User:  15, File Attributes:  Non-System
  337.  
  338. Filename.Typ Size K   Filename.Typ Size K   Filename.Typ Size K
  339. -------- --- ------   -------- --- ------   -------- --- ------
  340. VITALS  .BAD      4   VFILER  .CMD      4   SYSIO   .IO       4   
  341. ASM     .CFG      4   CPZM    .CPM     12   EBCDIC  .XLT      4   
  342. C       .CFG      4   CPZMH   .CPM     12   MULTICS .XLT      4   
  343. DBASE   .CFG      4   LD      .DIR      4   PARITYEV.XLT      4   
  344. PASCAL  .CFG      4   NAMES   .DIR      4   PARITYOD.XLT      4   
  345. STD     .CFG      4   BAD     .DOC      8   NEWDISK .ZEX      4   
  346. TEXT    .CFG      4   NOTESHD .DOC     16   
  347.    20 Files Occupying   112K,   303 Files on Disk and  1884K Free
  348.  
  349.      Thi≤á select≤ thσ non-CO═ file≤ iε thσ director∙ ROO╘á whicΦ ì
  350. are Non-System.  Non-System is my selected default for XDIR3.
  351.  
  352. :XDIR3 File Name Buffer Facility
  353.  
  354.      Thσá option≤ oµ XDIR│ whicΦ dea∞ witΦ thσ Filσá Namσá Buffe≥ ì
  355. Facility are:
  356.  
  357.           Ff - Engage File Name Buffer Facility
  358.                f=L to Log File Names to Disk
  359.                f=P to Print Names Logged to Disk
  360.                f=S to Scan Disk for File Names and Compare to
  361.                     Log
  362.           I  - Inspect files selected by FL option
  363.  
  364.      Thσá filσ selectioε option≤ comσ int∩ pla∙ a≤ wel∞ witΦá thσ ì
  365. F╠á optioεá t∩ selec⌠ thσ file≤ t∩ bσ placeΣ int∩ thσá loτá file¼ ì
  366. FNAMES.DIR.
  367.  
  368.  
  369.      Thσá F╠ optioε write≤ thσ use≥ number≤ anΣ filσ name≤ oµ thσ ì
  370. selecteΣá file≤á t∩á disδ int∩ thσá filσá nameΣá FNAMES.DIR«á  Iµ ì
  371. FNAMES.DI╥ alread∙ exists¼á theε i⌠ i≤ rewritten«  Thσ FNAMES.DI╥ ì
  372. files is used by the FP and FS options.
  373.  
  374.      Thσá ╔á optioεá (fo≥ inspect⌐ allow≤ thσá use≥á t∩á manuall∙ ì
  375. approve each file before its name is placed into FNAMES.DIR.
  376.  
  377.      Thσá F╨ optioε simpl∙ print≤ ou⌠ thσ use≥ number≤ anΣá name≤ ì
  378. oµ al∞ thσ file≤ storeΣ iε FNAMES.DIR«á  Iµ FNAMES.DI╥ i≤ no⌠á iε ì
  379. thσ curren⌠ directory¼á F╨ wil∞ searcΦ alonτ thσ ZCPR▓ patΦ unti∞ ì
  380. it finds it or reaches the end of the path.
  381.  
  382.      Thσ F╙ optioε scan≤ FNAMES.DI╥ anΣ thσ file≤ selecteΣ b∙ thσ ì
  383. use≥á (o≥ implieΣ iµ n∩ specifiπ filσ selectioε optioε i≤á given⌐ ì
  384. anΣ compare≤ them«  Iµ ß filσ exist≤ iε FNAMES.DI╥ bu⌠ no⌠ iε thσ ì
  385. selecteΣ files¼ it≤ namσ i≤ printeΣ a≤ ß missinτ file«  Iµ ß filσ ì
  386. exist≤á oε disδ bu⌠ no⌠ iε thσ FNAMES.DI╥ file¼á theε it≤ namσ i≤ ì
  387. printed as an additional file.
  388.  
  389.      Notσá tha⌠ thσ use≥ shoulΣ kee≡ iε minΣ wha⌠ hσ i≤á scanninτ ì
  390. fo≥ wheε hσ use≤ thσ Filσ Namσ Buffe≥ Facility«  Fo≥ instance¼ iµ ì
  391. hσá select≤ botΦ Non-systeφ anΣ Systeφ file≤ witΦ thσá F╠á optioε ì
  392. anΣ theε default≤ t∩ Non-Systeφ witΦ thσ F╙ option¼á theε severa∞ ì
  393. files will come up missing while this is not necessarily true.
  394.  
  395.      Usinτ GENINS¼á thσ Installatioε Prograφ fo≥ ZCPR2¼á yo⌡á caε ì
  396. creatσá tw∩á differen⌠á version≤ oµ XDIR│á -- onσá fo≥á Director∙ ì
  397. Displa∙áá operation≤á anΣá onσá fo≥á Filσá Namσá Buffe≥á Facilit∙ ì
  398. functions«  Iµ yo⌡ d∩ this¼ theε yo⌡ coulΣ als∩ se⌠ thσ Director∙ ì
  399. Displa∙ versioε t∩ worδ witΦ Non-Systeφ file≤ b∙á default¼á whilσ ì
  400. yo⌡á coulΣ se⌠ thσ Filσ Namσ Buffe≥ Facilit∙ versioε t∩ worδ witΦ ì
  401. botΦ Non-Systeφ anΣ Systeφ files.
  402.  
  403.  
  404.      Thσ followinτ i≤ ß samplσ termina∞ sessioε whicΦ illustrate≤ ì
  405. thσá usσ oµ thσ XDIR│ Filσ Namσ Buffe≥á Facility«á  Comment≤á arσ ì
  406. placeΣ ou⌠ t∩ thσ sidσ oµ thσ command≤ anΣ arσ denoteΣ b∙ "<--".
  407.  
  408. B7>xdir /fli        <-- Log Files to Disk and Inspect
  409.  
  410. XDIR III, Version 1.6
  411. Inspection of Files for Logging to Disk
  412. Log  7 DU2     .HLP   to Disk (Y/N/<CR>=Y)? Y
  413. Log  7 S100    .TXT   to Disk (Y/N/<CR>=Y)? N
  414. Log  7 STD     .MSG   to Disk (Y/N/<CR>=Y)? N
  415. Log  7 SYSLIB  .ART   to Disk (Y/N/<CR>=Y)? N
  416. Log  7 TALK    .SUM   to Disk (Y/N/<CR>=Y)? N
  417. Log  7 TEMP    .TXT   to Disk (Y/N/<CR>=Y)? Y
  418. Log  7 XDIR3   .HLP   to Disk (Y/N/<CR>=Y)? Y
  419. Log  7 Z2CON   .WS    to Disk (Y/N/<CR>=Y)? Y
  420. Log  7 Z2CON   .WSH   to Disk (Y/N/<CR>=Y)? Y
  421. Log  7 Z2INS   .WS    to Disk (Y/N/<CR>=Y)? Y
  422. Log  7 Z2INS   .WSH   to Disk (Y/N/<CR>=Y)? Y
  423.  
  424. Logging File Names to Disk --
  425.          7 File Names to be Logged to Disk
  426.      Horizontal Listing by File Name and Type
  427.  U Filename.Typ   U Filename.Typ   U Filename.Typ   U Filename.Typ
  428.  - -------- ---   - -------- ---   - -------- ---   - -------- ---
  429.  7 DU2     .HLP   7 TEMP    .TXT   7 XDIR3   .HLP   7 Z2CON   .WS   
  430.  7 Z2CON   .WSH   7 Z2INS   .WS    7 Z2INS   .WSH  
  431.  
  432. B7>xdir /fp         <-- Print out the names of the logged files
  433. XDIR III, Version 1.6
  434.  
  435. Printout of Recrded File Names --
  436.          7 File Names Recorded
  437.      Horizontal Listing by File Name and Type
  438.  U Filename.Typ   U Filename.Typ   U Filename.Typ   U Filename.Typ
  439.  - -------- ---   - -------- ---   - -------- ---   - -------- ---
  440.  7 DU2     .HLP   7 TEMP    .TXT   7 XDIR3   .HLP   7 Z2CON   .WS   
  441.  7 Z2CON   .WSH   7 Z2INS   .WS    7 Z2INS   .WSH  
  442.  
  443.  
  444. B7>era temp.txt          <-- Erase one of the logged files
  445. TEMP    .TXT             <--   for this demo
  446. B7>xdir /fs              <-- Scan the disk
  447.  
  448. XDIR III, Version 1.6
  449. File Name Scanner
  450. Files Named in FNAMES.DIR missing from Disk --
  451.      Horizontal Listing by Fie Name and Type
  452.  U Filename.Typ   U Filename.Typ   U Filename.Typ   U Filename.Typ
  453.  - -------- ---   - -------- ---   - -------- ---   - -------- ---
  454.  7 TEMP    .TXT  
  455. Additional Files on Disk NOT in FNAMES.DIR --
  456.      Horizontal Listing by File Name and Type
  457.  U Filename.Typ   U Filename.Typ   U Filename.Typ   U Filename.Typ
  458.  - -------- ---   - -------- ---   - -------- ---   - -------- ---
  459.  7 FNAMES  .DIR   7 S100    .TXT   7 STD     .MSG   7 SYSLIB  .ART  
  460.  7 TALK    .SUM  
  461. File Scan Complete
  462.  
  463. :Use of XDIR3 on Secure Systems
  464.  
  465.      Oε Securσ Systems¼ sucΦ a≤ Remotσ CP/═ Systems¼ XDIR│ ma∙ bσ ì
  466. configured¼á viß GENINS¼á t∩ providσ ß securσ director∙á utility«  ì
  467. Somσ idea≤ alonτ thi≤ linσ include:
  468.  
  469.           . You can install XDIR3 so that it cannot look at any
  470.                directory other than the one it is in
  471.           . You can install XDIR3 so that you can look at the
  472.                current user area on any disk, but not in other
  473.                user areas
  474.           . You can install XDIR3 so that you can look at all
  475.                user areas on the current disk, but not on any
  476.                other disk
  477.           . You can install XDIR3 so that you cannot look at any
  478.                System files
  479.           . You can install XDIR3 so that none of the F options
  480.                are available
  481.           « Yo⌡ caε instal∞ XDIR│ s∩ tha⌠ user≤ ma∙ lis⌠ thσ
  482.                files (FP) or scan the disk (FS), but not log
  483.                files to disk (FL)
  484.  
  485.      Thesσ arσ jus⌠ somσ oµ thσ way≤ ╔ havσ designeΣ XDIR│ t∩á bσ ì
  486. flexiblσ iε thesσ type≤ oµ environments«á  Iε ß morσ conventiona∞ ì
  487. environment¼á sucΦá a≤á ß softwarσ developmen⌠á environment¼á yo⌡ ì
  488. woulΣá probabl∙á wan⌠á XDIR│á t∩á givσá yo⌡á completσá acces≤á t∩ ì
  489. everything.
  490.  
  491.      Seσá thσá nex⌠ sectioε oε installatioε fo≥ morσá detail≤á oε ì
  492. setting XDIR3 capabilities and defaults.
  493.  
  494. :Overview of XD
  495.  
  496.      WitΦá usage¼á i⌠ ha≤ beeε noteΣ tha⌠ mos⌠ oµ thσ morσ exotiπ ì
  497. feature≤ oµ XDIR│ arσ no⌠ useΣ 99Ñ oµ thσ time«á  Iεá particular¼ ì
  498. thesσ feature≤ includσ thσ Filσ Scanne≥ anΣ Disδ Outpu⌠ facility«  ì
  499. Becausσá thesσ feature≤ cos⌠ iε term≤ oµ thσ sizσ oµ XDIR.CO═ anΣ ì
  500. it≤ executioε speed¼á anothe≥ versioε oµ XDIR.COM¼ calleΣ XD.COM¼ ì
  501. has been created.
  502.  
  503.      X─á i≤á completel∙á compatablσ witΦ XDI╥á iεá term≤á oµá thσ ì
  504. option≤á i⌠á accept≤ anΣ ho≈ i⌠ operates«á  Thσ onl∙á difference≤ ì
  505. betweeεá thσá tw∩á i≤á tha⌠ thσá Filσá Scanne≥á anΣá Disδá Outpu⌠ ì
  506. facilitie≤ havσ beeε removeΣ froφ XD«á  Hence¼á thσ D¼á F¼á anΣ ╔ ì
  507. option≤á arσ no⌠ available«á  Ever∙ othe≥ optioε oµ XDI╥ i≤ stil∞ ì
  508. intact¼á however¼á anΣ perform≤ iε thσ samσ way«  A≤ ß result¼ X─ ì
  509. is notable smaller than XDIR.
  510.  
  511.  
  512.      X─á display≤á t∩ thσ use≥ informatioε abou⌠ thσ file≤á oεá ß ì
  513. particula≥ disδ iε al∞ use≥ area≤ o≥ ß particula≥ use≥ area«á  I⌠ ì
  514. give≤ hiφ thσ followinτ information:
  515.  
  516.           . Name of File
  517.           . Size of File (in K bytes)
  518.           . Attributes of File (Read/Only or System)
  519.           . Sum of Sizes of All Files Displayed
  520.           . Total Number of Files on Disk
  521.           . Amount of Space Remaining on Disk
  522.           . What Disk and What User Area you are looking at
  523.  
  524.  
  525.      X─á i≤á quitσ human-oriented¼á witΦ man∙á built-iεá feature≤ ì
  526. whicΦá providσá ßá human-interfacσ typσ oµ servicσ t∩á thσá user«  ì
  527. Somσ oµ thesσ include:
  528.  
  529.           . Named Directories may be specified
  530.           . The file listing is alphabetized by file name and
  531.                type or file type and name, depending on user
  532.                preference
  533.           . The file listing is organized vertically or
  534.                horizontally, depending on user preference
  535.           . Output may also be sent to disk or printer
  536.           « XDIR│ i≤ designeΣ t∩ ruε quickly
  537.  
  538.  
  539.      XD is invoked by one of the following command lines:
  540.  
  541.           XD afn oooo... or XD afn /oooo...
  542. and
  543.           XD /oooo...
  544.  
  545. where all elements after the XD command are optional.
  546.  
  547.      'afnºá i≤ aε ambiguou≤ filσ reference¼á a≤ describeΣ oεá thσ ì
  548. followinτ frames«á  'oº i≤ aε optioε letter¼ whicΦ i≤ onσ o≥ morσ ì
  549. oµá thσ option≤ describeΣ oε thσ nex⌠ frame«á  Notσ tha⌠ sincσá ß ì
  550. slasΦ denote≤ tha⌠ aε optioε follows¼ aε afε ma∙ no⌠ begiε witΦ ß ì
  551. slash«á  Thi≤á caε bσ changeΣ b∙ aε equatσ iε thσ sourcσ codσá oµ ì
  552. XD if desired.
  553.  
  554.  
  555.      XD options are:
  556.  
  557.           Aa - Set the attributes of the files to be displayed
  558.                a=S for System Files, a=N for Non-System Files
  559.                a=A for All Files (Non-System and System)
  560.           N  - Negate Selection; select those files which do NOT
  561.                     match the ambiguous file name
  562.           Oo - Toggle Output Control Options
  563.                o=A for File Attributes, o=F for Form Feed
  564.                o=G for Grouping, o=H for Horiz/Vert Format
  565.           P  - Send Output to Printer
  566.           PF - Same as POF (Abbreviated Form)
  567.  
  568.  
  569.  
  570. :Installation of XDIR3 and XD
  571.  
  572.      GENIN╙á i≤ thσ installatioε prograφ whicΦ come≤á alonτá witΦ ì
  573. ZCPR▓á anΣá allow≤ thσ use≥ t∩ definσ thσ basiπ capabilitie≤á anΣ ì
  574. defaul⌠á function≤á executeΣá b∙ ß particula≥á cop∙á oµá ßá ZCPR▓ ì
  575. utility«á  GENIN╙ i≤ awarσ oµ thσ specifiπ requirement≤ oµ al∞ oµ ì
  576. thσ ke∙ ZCPR▓ utilities¼á includinτ XDIR│ anΣ XD¼á anΣ adapt≤ fo≥ ì
  577. eacΦ utility'≤ specifiπ needs.
  578.  
  579.      Wheεá GENIN╙ i≤ executed¼á i⌠ ask≤ thσ use≥ fo≥ thσ namσá oµ ì
  580. thσ filσ t∩ bσ installed«á  Thσ use≥ ma∙ specif∙ thi≤ filσ iε thσ ì
  581. norma∞ ZCPR▓ format:
  582.  
  583.           dir:filename.typ
  584.  
  585.  
  586.      GENIN╙á wil∞á reaΣá thσá firs⌠ blocδá oµá thi≤á file¼á whicΦ ì
  587. contain≤ thσ customizatioε information¼á anΣ theε allo≈ yo⌡ t∩ d∩ ì
  588. onσ oµ threσ thing≤ (it≤ basiπ commanΣ prompt):
  589.  
  590.           . Display the Current Features
  591.           . Set the Features of the program to the user's liking
  592.           . Exit and optionally create a new COM file
  593.  
  594.      Thσá feature≤á whicΦ ma∙ bσ se⌠ b∙ thσ systeφ manage≥á unde≥ ì
  595. GENINS for XDIR3 and XD are:
  596.  
  597.           . Whether the user may specify a directory (disk/user)
  598.           . If directory specification is allowed, whether the
  599.                user may specify just disk or just user (but not
  600.                necessarily both)
  601.           . Whether the user may employ any of the F options
  602.           . If the F options may be used, if the user may employ
  603.                the FL option specificially
  604.  
  605. Features to be Set, Continued:
  606.  
  607.           . Whether the user may employ the AS option
  608.           . Whether XDIR3 will perform a Directory Display
  609.                of File Name Buffer Facility function by default
  610.           . Whether XDIR3 or XD will display Non-System or System
  611.                files (or both) by default
  612.           . Whether the alphabetization will be by file name and
  613.                type or type and name by default
  614.           . Whether the listing will be vertical or horizontal by
  615.                default
  616.           « Whethe≥ ZCPR▓ Externa∞ Path≤ arσ available¼ and¼ iµ
  617.                so, what the base path address is
  618.           . Whether the File Attributes will be included in the
  619.                display by default
  620.           . Whether printer output will be followed by a form
  621.                feed by default
  622.  
  623.  
  624.      Iµá thσ use≥ i≤ no⌠ runninτ ZCPR2¼á hσ shoulΣ disablσ al∞ oµ ì
  625. thσá ZCPR▓á features«á  Thi≤ shoulΣ bσ donσ iε thσá usua∞á manne≥ ì
  626. under GENINS (see the GENINS manual).
  627.  
  628.  
  629.