Overview of XDIR3
Basic Use of XDIR3 under ZCPR2
XDIR3 Output Control Options
XDIR3 File Selection Options
XDIR3 File Name Buffer Facility
Use of XDIR3 on Secure Systems
Overview of XD
Installation of XDIR3 and XD
:Overview of XDIR3

    XDIR�� i� a� extende� director� displa� utilit� designe� t� �
ru� unde� CP/� 2.� an� suppor� som� o� th� extende� feature� o� �
ZCPR� a� well�  An� conventiona� CP/� 2.� use� ma� us� XDIR3� bu� �
h� shoul� mak� sur� h� turn� of� th� ZCPR2-specifi� feature� b� �
runnin� th� ZCPR� Installatio� Program�� GENINS�� o� XDIR�� an� �
manuall� turnin� the� of� befor� usin� XDIR3.

    XDIR�� automaticall�� adapt� t� an� Org-� CP/͠ 2.�� system� �
regardles� o� th� siz� o� it� disks�  I� read� th� dis� paramete� �
bloc� informatio� fro� th� operatin� syste� t� determin� wha� th� �
attribute� o� th� dis� i� i� workin� wit� are�� an� i� the� �
present� it� displa� informatio� accordingly.

    XDIR3 runs in two basic modes:
         . as a directory display utility
         . as a file scanner utility (File Name Buffer Facility)

    XDIR�� i� � ZCPR� utilit� whic� support� th� extende� ZCPR� �
features� particularl� name� directories.

    A� � director�� displa�� utility��� i� display� t� yo� �
informatio� abou� th� file� o� � particula� dis� i� al� use� �
area� o� � particula� use� area��  I� give� yo�� th� followin� �
information:
         . Name of File
         . Size of File (in K bytes)
         . Attributes of File (Read/Only or System)
         . Sum of Sizes of All Files Displayed
         . Total Number of Files on Disk
         . Amount of Space Remaining on Disk
         . What Disk and What User Area you are looking at

    A� � fil� scanne� utility� i� doe� th� following:
         . Logs a group of selected files to disk for later scan
         . Prints the contents of such a log file
         � Scan� � lo� fil� an� compare� i� wit� th� file�
              selected by you, telling you what files are
              missing and what files are additional

    XDIR� i� quit� human-oriented�� wit� man� built-i� feature� �
whic� provid� � human-interfac� typ� o� servic� t� th� user�  �
Some of these include:

         . Named Directories may be specified
         . The file listing is alphabetized by file name and
              type or file type and name, depending on user
              preference
         . The file listing is organized vertically or
              horizontally, depending on user preference
         . Output may also be sent to disk or printer
         � XDIR� i� designe� t� ru� quickly

:Basic Use of XDIR3 under ZCPR2

    XDIR3 is invoked by one of the following command lines:

         XDIR afn oooo... or XDIR afn /oooo...
and
         XDIR /oooo...

where all elements after the XDIR command are optional.

    'afn�� i� a� ambiguou� fil� reference�� a� describe� o� th� �
followin� frames��  'o� i� a� optio� letter� whic� i� on� o� mor� �
o� th� option� describe� o� th� nex� frame��  Not� tha� sinc� � �
slas� denote� tha� a� optio� follows� a� af� ma� no� begi� wit� � �
slash��  Thi� ca� b� change� b� a� equat� i� th� sourc� cod� o� �
XDIR3 if desired.


         Aa - Set the attributes of the files to be displayed
              a=S for System Files, a=N for Non-System Files
              a=A for All Files (Non-System and System)
         D  - Send Output to Disk
         Ff - Engage File Name Buffer Facility
              f=L to Log File Names to FNAMES.DIR
              f=P to Print Names Stored in FNAMES.DIR
              f=S to Scan Disk and Compare to FNAMES.DIR
         I  - Inspect files selected by FL option
         N  - Negate Selection; select those files which do NOT
                   match the ambiguous file name
         Oo - Toggle Output Control Options
              o=A for File Attributes, o=F for Form Feed
              o=G for Grouping, o=H for Horiz/Vert Format
         P  - Send Output to Printer
         PF - Same as POF (Abbreviated Form)


    'afn' is an ambiguous file reference, of the general form:

         dir:filename.typ

where
    filename.typ   is a conventional CP/M ambiguous file name
                        (wild card characters of ? and * are OK,
                        but file name must NOT start with /)
    dir:           is a ZCPR2 directory specification, which may
                        be one of the following forms:
         d:        where 'd' is a disk letter (A-P) to indicate
                        the current user area on that disk
         u:        where 'u' is a user number (0-31) to indicate
                        that user on the current disk; 'u' may
                        be a '?', in which case all user areas
                        are selected
         du:       where 'du' specifies both disk and user
         name:     where 'name' is the name of a directory
                        (disk/user area)

    Examples of an ambiguous file reference are:

         A:FILE.TXT          A4:FILE.TXT
         ROOT:FILE.TXT       A?:*.COM
         12:*.*              A12:SYSLIB*.*

    Examples of an XDIR3 command are:

         XDIR ROOT:*.COM AAN
              -- Select All Files in directory ROOT which do
                 NOT match *.COM
         XDIR B10: ASD
              -- Select the System Files in B10, and send
                 output to disk as well as console
         XDIR /AADP
              -- Select All Files in current directory, and
                 send output to disk and printer as well as
                 console
:XDIR3 Output Control Options

    These options are:

         D  - Send Output to Disk
         Oo - Output Control
              OA - Toggle Display of File Attributes
              OF - Toggle Send of Form Feed with Print
              OG - Toggle File Grouping (name/type or type/name)
              O� - Toggl� Forma� (Horizonta� o� Vertical)
         P  - Send Output to Printer
         PF - Same as POF, which sends output to printer and
              form feeds when done

    � an� � ar� fairl� obvious��  I� � i� specified�� th� outpu� �
goe� t� you� printe� (CP/� LST�� device� a� wel� a� you� console�  �
I� � i� specified�� th� outpu� goe� t� you� curren� director� a� �
th� fil� XDIR.DIR�  I� XDIR.DI� alread� exists� i� i� replaced.

    Al� o� th� O� option� ar� toggled��  If�� vi� GENINӠ a� �
installatio� time� yo� selecte� n� displa� o� fil� attributes� O� �
wil� caus� thi� defaul� t� b� toggle� an� th� fil� attribute� �
displayed.  The same is true with the OF, OG, and OH forms.

    O�� allow� yo� t� selec� you� displa� t� includ� th� fil� �
attribute� field��  Thi� field�� whic� occur� afte� th� fil� siz� �
i� printe� fo� eac� file�� optionall� contain� th� letter� Ҡ an� �
S�� indicatin� tha� th� preceedin� fil� wa� Read/Onl�� (i� th� �
lette� � appears� an� tha� th� preceedin� fil� wa� � Syste� fil� �
(i� th� lette� � appears)��  I� � i� no� present� th� fil� i� NO� �
Read/Onl� (i� i� Read/Write)�� an� i� � i� no� present�� th� fil� �
is Non-System.

    OƠ allow� yo� t� selec� a� automati� for� fee� whe� th� �
director�� displa� i� sen� t� th� printer��  I� printe� outpu� i� �
selecte� (� option� AN� th� for� fee� fla� i� ON�� the� th� las� �
lin� o� th� printou� wil� b� followe� b� � for� fee� character�  �
Man�� printer� respon� t� thi� characte� b� advancin� t� th� to� �
o� th� nex� page��  Note�  th� specia� for� P� i� provide� t� ac� �
th� sam� a� � (fo� turnin� o� printe� output� an� O� (t� toggl� �
the form feed function).

    OǠ allow� yo� t� selec� you� displa� t� b� alphabetize� b� �
fil� nam� an� typ� o� typ� an� name��  I� b� fil� nam� an� type� �
the� AA.TX� come� befor� BB.COM��  I� b� fil� typ� an� name� the� �
BB.CO͠ come� befor� AA.TXT��  Alphabetizatio� b� fil� nam� an� �
typ� group� file� o� th� sam� nam� togethe� (F� fields�� lik� al� �
XDIR3.�� files)�� whil� b� fil� typ� an� nam� group� file� o� th� �
sam� typ� togethe� (F� fields� lik� al� *.TX� files).

    O� allow� yo� t� selec� you� alphabetize� file� t� b� liste� �
dow� th� scree� (vertical� o� acros� th� scree� (horizontal)�  �
Th� scree� i� divide� int� thre� columns�� an� � vertica� listin� �
alphabetize� dow� th� firs� column� the� th� second� an� the� th� �
third� whil� � horizonta� listin� alphabetize� first� second� an� �
thir� column� o� th� firs� line� an� s� o� wit� eac� line.

    ɠ lik� t� grou� m� listing� b� fil� typ� first�� an� the� �
name�� an� � als� prefe� th� vertica� displa� format��  Her� i� �
suc� � listing (generated by the command line "XDIR"):

XDIR III, Version 1.6    Vertical Listing by File Type and Name
Disk: B  User:   7, File Attributes:  Non-System

Filename.Typ Size K RS   Filename.Typ Size K RS   Filename.Typ Size K RS
-------- --- ------ --   -------- --- ------ --   -------- --- ------ --
BIO     .DOC      4      GAUDE   .TXT      4      SWCT    .TXT      8
XDIR3   .HLP     24      SCCE    .TXT      8      SWDISTCT.TXT      4
BIO     .TXT      4      SCOST   .TXT      4      TRPT    .TXT      4
BOOKCT  .TXT     12      STATUS  .TXT      8      UNIX    .TXT     24
CARTERS .TXT      4
  13 Files Occupying   112K,    96 Files on Disk and  4088K Free

    Note that we are alphabetized down the columns by file type.

    Som� prefe� no� t� se� th� Fil� Attribute� Field� (th� �
column� heade� b� RS)��  � ca� toggl� thi� of� (fo� thi� displa� �
only� b� usin� th� O� optio� (generate� b� th� comman� lin� "XDI� �
/OA"):

XDIR III, Version 1.6    Vertical Listing by File Type and Name
Disk: B  User:   7, File Attributes:  Non-System

Filename.Typ Size K   Filename.Typ Size K   Filename.Typ Size K
-------- --- ------   -------- --- ------   -------- --- ------
BIO     .DOC      4   GAUDE   .TXT      4   SWCT    .TXT      8
XDIR3   .HLP     24   SCCE    .TXT      8   SWDISTCT.TXT      4
BIO     .TXT      4   SCOST   .TXT      4   TRPT    .TXT      4
BOOKCT  .TXT     12   STATUS  .TXT      8   UNIX    .TXT     24
CARTERS .TXT      4
  13 Files Occupying   112K,    96 Files on Disk and  4088K Free

    Note��  th� RӠ column� ar� no� removed��  � GENINӠ optio� �
exist� whic� allow� yo� t� se� thi� typ� o� displa� a� default.

    Fro� thi� poin� forward�� fo� th� convenienc� o� th� displa� �
size�� ɠ wil� us� th� O� option��  Som� prefe� t� alphabetiz� b� �
fil� name��  � a� usin� th� O� optio� t� fli� thi� (generate� b� �
th� comman� lin� "XDI� /OAOG"):

XDIR III, Version 1.6    Vertical Listing by File Name and Type
Disk: B  User:   7, File Attributes:  Non-System

Filename.Typ Size K   Filename.Typ Size K   Filename.Typ Size K
-------- --- ------   -------- --- ------   -------- --- ------
BIO     .DOC      4   SCCE    .TXT      8   SWDISTCT.TXT      4
BIO     .TXT      4   SCOST   .TXT      4   TRPT    .TXT      4
BOOKCT  .TXT     12   STATUS  .TXT      8   UNIX    .TXT     24
CARTERS .TXT      4   SWCT    .TXT      8   XDIR3   .HLP     24
GAUDE   .TXT      4
  13 Files Occupying   112K,    96 Files on Disk and  4088K Free

    Again�� w� ar� alphabetize� dow� th� columns�� bu� th� orde� �
i� b� fil� nam� an� the� fil� type.

    Finally�� som� prefe� horizonta� a� oppose� t� vertica� �
listings��  Her� i� anothe� listin� whic� i� horizonta� an� �
grouped by file name first (generated by "XDIR /OAOH"):

XDIR III, Version 1.6    Horizontal Listing by File Type and Name
Disk: B  User:   7, File Attributes:  Non-System

Filename.Typ Size K   Filename.Typ Size K   Filename.Typ Size K
-------- --- ------   -------- --- ------   -------- --- ------
BIO     .DOC      4   XDIR3   .HLP     24   BIO     .TXT      4
BOOKCT  .TXT     12   CARTERS .TXT      4   GAUDE   .TXT      4
SCCE    .TXT      8   SCOST   .TXT      4   STATUS  .TXT      8
SWCT    .TXT      8   SWDISTCT.TXT      4   TRPT    .TXT      4
UNIX    .TXT     24
  13 Files Occupying   112K,    96 Files on Disk and  4088K Free

    Th� OƠ for� i� no� illustrate� her� sinc� i� result� i� � �
for� fee� o� th� printe� an� doe� no� len䠠 itsel栠 t� �
demonstratio� o� th� CR� lik� th� others�  Th� format� o� course� �
is similar to the others.
:XDIR3 File Selection Options

    Th� followin� option� (an� th� DIR�� field�� contro� fil� �
selection:

         Aa - Set the attributes of the files to be displayed
              a=S for System Files, a=N for Non-System Files
              a=A for All Files (Non-System and System)
         N  - Negate Selection; select those files which do NOT
                   match the ambiguous file name

    Th� � optio� negate� you� ambiguou� fil� nam� reference� bu� �
i� stay� i� th� SAM� se� o� syste� o� non-syste� files��  Fo� �
instance�� XDIҠ *.CO� /NA� select� al� SYSTE� file� whic� d� NO� �
matc� *.COM�  I� yo� hav� installe� XDIR� t� automaticall� selec� �
bot� SYSTE� an� NON-SYSTE� files�� the� XDI� *.CO� /� wil� selec� �
all non-COM files in your current directory.


    Th� �� optio� set� th� attribute� o� th� file� t� b� �
displayed��  I� A� i� presented�� the� bot� Non-Syste� an� Syste� �
file� wil� b� displayed��  I� AS�� the� jus� Syste� files� an� i� �
AN� the� jus� Non-System�

    Yo�� ca� se� th� defaul� fil� attribut� displa�� t� b� �
whateve� yo�� desire���  Usin� GENINS��� yo�� ca� hav� XDIR� �
automaticall� selec� jus� th� Syste� files�� jus� th� Non-Syste� �
files�� o� bot� Non-Syste� an� Syste� file� wheneve� yo� ru� i� �
withou� usin� th� � option.


B7>xdir root:*.com aanoa

XDIR III, Version 1.6    Vertical Listing by File Type and Name
Disk: A  User:  15, File Attributes:  Non-System System

Filename.Typ Size K   Filename.Typ Size K   Filename.Typ Size K
-------- --- ------   -------- --- ------   -------- --- ------
VITALS  .BAD      4   VFILER  .CMD      4   SYSIO   .IO       4
ASM     .CFG      4   CPZM    .CPM     12   EBCDIC  .XLT      4
C       .CFG      4   CPZMH   .CPM     12   MULTICS .XLT      4
DBASE   .CFG      4   LD      .DIR      4   PARITYEV.XLT      4
PASCAL  .CFG      4   NAMES   .DIR      4   PARITYOD.XLT      4
STD     .CFG      4   BAD     .DOC      8   NEWDISK .ZEX      4
TEXT    .CFG      4   NOTESHD .DOC     16
  20 Files Occupying   112K,   303 Files on Disk and  1884K Free

    Thi� select� al� non-CO� file� i� th� director� ROOT��  Bot� �
Syste� an� Non-Syste� file� ar� selected.


B7>xdir root:*.com asnoa

XDIR III, Version 1.6    Vertical Listing by File Type and Name
Disk: A  User:  15, File Attributes:  System
No files selected --  1884K Free

    Thi� select� th� non-CO� Syste� file� i� th� director� ROOT�  �
Note that no files matched that selection.�


B7>xdir root:*.com noa

XDIR III, Version 1.6    Vertical Listing by File Type and Name
Disk: A  User:  15, File Attributes:  Non-System

Filename.Typ Size K   Filename.Typ Size K   Filename.Typ Size K
-------- --- ------   -------- --- ------   -------- --- ------
VITALS  .BAD      4   VFILER  .CMD      4   SYSIO   .IO       4
ASM     .CFG      4   CPZM    .CPM     12   EBCDIC  .XLT      4
C       .CFG      4   CPZMH   .CPM     12   MULTICS .XLT      4
DBASE   .CFG      4   LD      .DIR      4   PARITYEV.XLT      4
PASCAL  .CFG      4   NAMES   .DIR      4   PARITYOD.XLT      4
STD     .CFG      4   BAD     .DOC      8   NEWDISK .ZEX      4
TEXT    .CFG      4   NOTESHD .DOC     16
  20 Files Occupying   112K,   303 Files on Disk and  1884K Free

    Thi� select� th� non-CO� file� i� th� director� ROOԠ whic� �
are Non-System.  Non-System is my selected default for XDIR3.

:XDIR3 File Name Buffer Facility

    Th� option� o� XDIR� whic� dea� wit� th� Fil� Nam� Buffe� �
Facility are:

         Ff - Engage File Name Buffer Facility
              f=L to Log File Names to Disk
              f=P to Print Names Logged to Disk
              f=S to Scan Disk f
or File Names and Compare to
                   Log
         I  - Inspect files selected by FL option

    Th� fil� selectio� option� com� int� pla� a� wel� wit� th� �
F̠ optio� t� selec� th� file� t� b� place� int� th� lo� file� �
FNAMES.DIR.


    Th� F� optio� write� th� use� number� an� fil� name� o� th� �
selecte� file� t� dis� int� th� fil� name� FNAMES.DIR��  I� �
FNAMES.DI� alread� exists�� the� i� i� rewritten�  Th� FNAMES.DI� �
files is used by the FP and FS options.

    Th� ɠ optio� (fo� inspect� allow� th� use� t� manuall� �
approve each file before its name is placed into FNAMES.DIR.

    Th� F� optio� simpl� print� ou� th� use� number� an� name� �
o� al� th� file� store� i� FNAMES.DIR��  I� FNAMES.DI� i� no� i� �
th� curren� directory�� F� wil� searc� alon� th� ZCPR� pat� unti� �
it finds it or reaches the end of the path.

    Th� F� optio� scan� FNAMES.DI� an� th� file� selecte� b� th� �
use� (o� implie� i� n� specifi� fil� selectio� optio� i� given� �
an� compare� them�  I� � fil� exist� i� FNAMES.DI� bu� no� i� th� �
selecte� files� it� nam� i� printe� a� � missin� file�  I� � fil� �
exist� o� dis� bu� no� i� th� FNAMES.DI� file�� the� it� nam� i� �
printed as an additional file.

    Not� tha� th� use� shoul� kee� i� min� wha� h� i� scannin� �
fo� whe� h� use� th� Fil� Nam� Buffe� Facility�  Fo� instance� i� �
h� select� bot� Non-syste� an� Syste� file� wit� th� F̠ optio� �
an� the� default� t� Non-Syste� wit� th� F� option�� the� severa� �
files will come up missing while this is not necessarily true.

    Usin� GENINS�� th� Installatio� Progra� fo� ZCPR2�� yo�� ca� �
creat� tw� differen� version� o� XDIR�� -- on� fo� Director� �
Displa��� operation� an� on� fo� Fil� Nam� Buffe� Facilit� �
functions�  I� yo� d� this� the� yo� coul� als� se� th� Director� �
Displa� versio� t� wor� wit� Non-Syste� file� b�� default�� whil� �
yo�� coul� se� th� Fil� Nam� Buffe� Facilit� versio� t� wor� wit� �
bot� Non-Syste� an� Syste� files.


    Th� followin� i� � sampl� termina� sessio� whic� illustrate� �
th� us� o� th� XDIR� Fil� Nam� Buffe� Facility��  Comment� ar� �
place� ou� t� th� sid� o� th� command� an� ar� denote� b� "<--".

B7>xdir /fli        <-- Log Files to Disk and Inspect

XDIR III, Version 1.6
Inspection of Files for Logging to Disk
Log  7 DU2     .HLP   to Disk (Y/N/<CR>=Y)? Y
Log  7 S100    .TXT   to Disk (Y/N/<CR>=Y)? N
Log  7 STD     .MSG   to Disk (Y/N/<CR>=Y)? N
Log  7 SYSLIB  .ART   to Disk (Y/N/<CR>=Y)? N
Log  7 TALK    .SUM   to Disk (Y/N/<CR>=Y)? N
Log  7 TEMP    .TXT   to Disk (Y/N/<CR>=Y)? Y
Log  7 XDIR3   .HLP   to Disk (Y/N/<CR>=Y)? Y
Log  7 Z2CON   .WS    to Disk (Y/N/<CR>=Y)? Y
Log  7 Z2CON   .WSH   to Disk (Y/N/<CR>=Y)? Y
Log  7 Z2INS   .WS    to Disk (Y/N/<CR>=Y)? Y
Log  7 Z2INS   .WSH   to Disk (Y/N/<CR>=Y)? Y

Logging File Names to Disk --
        7 File Names to be Logged to Disk
    Horizontal Listing by File Name and Type
U Filename.Typ   U Filename.Typ   U Filename.Typ   U Filename.Typ
- -------- ---   - -------- ---   - -------- ---   - -------- ---
7 DU2     .HLP   7 TEMP    .TXT   7 XDIR3   .HLP   7 Z2CON   .WS
7 Z2CON   .WSH   7 Z2INS   .WS    7 Z2INS   .WSH

B7>xdir /fp         <-- Print out the names of the logged files
XDIR III, Version 1.6

Printout of Recrded File Names --
        7 File Names Recorded
    Horizontal Listing by File Name and Type
U Filename.Typ   U Filename.Typ   U Filename.Typ   U Filename.Typ
- -------- ---   - -------- ---   - -------- ---   - -------- ---
7 DU2     .HLP   7 TEMP    .TXT   7 XDIR3   .HLP   7 Z2CON   .WS
7 Z2CON   .WSH   7 Z2INS   .WS    7 Z2INS   .WSH


B7>era temp.txt          <-- Erase one of the logged files
TEMP    .TXT             <--   for this demo
B7>xdir /fs              <-- Scan the disk

XDIR III, Version 1.6
File Name Scanner
Files Named in FNAMES.DIR missing from Disk --
    Horizontal Listing by Fie Name and Type
U Filename.Typ   U Filename.Typ   U Filename.Typ   U Filename.Typ
- -------- ---   - -------- ---   - -------- ---   - -------- ---
7 TEMP    .TXT
Additional Files on Disk NOT in FNAMES.DIR --
    Horizontal Listing by File Name and Type
U Filename.Typ   U Filename.Typ   U Filename.Typ   U Filename.Typ
- -------- ---   - -------- ---   - -------- ---   - -------- ---
7 FNAMES  .DIR   7 S100    .TXT   7 STD     .MSG   7 SYSLIB  .ART
7 TALK    .SUM
File Scan Complete

:Use of XDIR3 on Secure Systems

    O� Secur� Systems� suc� a� Remot� CP/� Systems� XDIR� ma� b� �
configured�� vi� GENINS�� t� provid� � secur� director�� utility�  �
Som� idea� alon� thi� lin� include:

         . You can install XDIR3 so that it cannot look at any
              directory other than the one it is in
         . You can install XDIR3 so that you can look at the
              current user area on any disk, but not in other
              user areas
         . You can install XDIR3 so that you can look at all
              user areas on the current disk, but not on any
              other disk
         . You can install XDIR3 so that you cannot look at any
              System files
         . You can install XDIR3 so that none of the F options
              are available
         � Yo� ca� instal� XDIR� s� tha� user� ma� lis� th�
              files (FP) or scan the disk (FS), but not log
              files to disk (FL)

    Thes� ar� jus� som� o� th� way� � hav� designe� XDIR� t� b� �
flexibl� i� thes� type� o� environments��  I� � mor� conventiona� �
environment�� suc� a� � softwar� developmen� environment�� yo� �
woul� probabl�� wan� XDIR�� t� giv� yo�� complet� acces� t� �
everything.

    Se� th� nex� sectio� o� installatio� fo� mor� detail� o� �
setting XDIR3 capabilities and defaults.

:Overview of XD

    Wit� usage�� i� ha� bee� note� tha� mos� o� th� mor� exoti� �
feature� o� XDIR� ar� no� use� 99� o� th� time��  I� particular� �
thes� feature� includ� th� Fil� Scanne� an� Dis� Outpu� facility�  �
Becaus� thes� feature� cos� i� term� o� th� siz� o� XDIR.CO� an� �
it� executio� speed�� anothe� versio� o� XDIR.COM� calle� XD.COM� �
has been created.

    XĠ i� completel�� compatabl� wit� XDIҠ i� term� o� th� �
option� i� accept� an� ho� i� operates��  Th� onl�� difference� �
betwee� th� tw� i� tha� th� Fil� Scanne� an� Dis� Outpu� �
facilitie� hav� bee� remove� fro� XD��  Hence�� th� D�� F�� an� � �
option� ar� no� available��  Ever� othe� optio� o� XDI� i� stil� �
intact�� however�� an� perform� i� th� sam� way�  A� � result� X� �
is notable smaller than XDIR.


    XĠ display� t� th� use� informatio� abou� th� file� o� � �
particula� dis� i� al� use� area� o� � particula� use� area��  I� �
give� hi� th� followin� information:

         . Name of File
         . Size of File (in K bytes)
         . Attributes of File (Read/Only or System)
         . Sum of Sizes of All Files Displayed
         . Total Number of Files on Disk
         . Amount of Space Remaining on Disk
         . What Disk and What User Area you are looking at


    XĠ i� quit� human-oriented�� wit� man�� built-i� feature� �
whic� provid� � human-interfac� typ� o� servic� t� th� user�  �
Som� o� thes� include:

         . Named Directories may be specified
         . The file listing is alphabetized by file name and
              type or file type and name, depending on user
              preference
         . The file listing is organized vertically or
              horizontally, depending on user preference
         . Output may also be sent to disk or printer
         � XDIR� i� designe� t� ru� quickly


    XD is invoked by one of the following command lines:

         XD afn oooo... or XD afn /oooo...
and
         XD /oooo...

where all elements after the XD command are optional.

    'afn�� i� a� ambiguou� fil� reference�� a� describe� o� th� �
followin� frames��  'o� i� a� optio� letter� whic� i� on� o� mor� �
o� th� option� describe� o� th� nex� frame��  Not� tha� sinc� � �
slas� denote� tha� a� optio� follows� a� af� ma� no� begi� wit� � �
slash��  Thi� ca� b� change� b� a� equat� i� th� sourc� cod� o� �
XD if desired.


    XD options are:

         Aa - Set the attributes of the files to be displayed
              a=S for System Files, a=N for Non-System Files
              a=A for All Files (Non-System and System)
         N  - Negate Selection; select those files which do NOT
                   match the ambiguous file name
         Oo - Toggle Output Control Options
              o=A for File Attributes, o=F for Form Feed
              o=G for Grouping, o=H for Horiz/Vert Format
         P  - Send Output to Printer
         PF - Same as POF (Abbreviated Form)



:Installation of XDIR3 and XD

    GENINӠ i� th� installatio� progra� whic� come� alon� wit� �
ZCPR�� an� allow� th� use� t� defin� th� basi� capabilitie� an� �
defaul� function� execute� b� � particula� cop�� o� � ZCPR� �
utility��  GENIN� i� awar� o� th� specifi� requirement� o� al� o� �
th� ke� ZCPR� utilities�� includin� XDIR� an� XD�� an� adapt� fo� �
eac� utility'� specifi� needs.

    Whe� GENIN� i� executed�� i� ask� th� use� fo� th� nam� o� �
th� fil� t� b� installed��  Th� use� ma� specif� thi� fil� i� th� �
norma� ZCPR� format:

         dir:filename.typ


    GENINӠ wil� rea� th� firs� bloc� o� thi� file�� whic� �
contain� th� customizatio� information�� an� the� allo� yo� t� d� �
on� o� thre� thing� (it� basi� comman� prompt):

         . Display the Current Features
         . Set the Features of the program to the user's liking
         . Exit and optionally create a new COM file

    Th� feature� whic� ma� b� se� b� th� syste� manage� unde� �
GENINS for XDIR3 and XD are:

         . Whether the user may specify a directory (disk/user)
         . If directory specification is allowed, whether the
              user may specify just disk or just user (but not
              necessarily both)
         . Whether the user may employ any of the F options
         . If the F options may be used, if the user may employ
              the FL option specificially

Features to be Set, Continued:

         . Whether the user may employ the AS option
         . Whether XDIR3 will perform a Directory Display
              of File Name Buffer Facility function by default
         . Whether XDIR3 or XD will display Non-System or System
              files (or both) by default
         . Whether the alphabetization will be by file name and
              type or type and name by default
         . Whether the listing will be vertical or horizontal by
              default
         � Whethe� ZCPR� Externa� Path� ar� available� and� i�
              so, what the base path address is
         . Whether the File Attributes will be included in the
              display by default
         . Whether printer output will be followed by a form
              feed by default


    I� th� use� i� no� runnin� ZCPR2�� h� shoul� disabl� al� o� �
th� ZCPR�� features��  Thi� shoul� b� don� i� th� usua� manne� �
under GENINS (see the GENINS manual).