;

               Directory Display Utilities

    -- Summaries --               -- XDIR Details --
    0 - Overview                  B - Basic Use
    1 - XDIR                      F - File Selection
    2 - XD                        N - File Name Scan
    3 - DIR                       O - Output Control
    4 - RCP DIR
    5 - ZCPR3 DIR


                   -- Special Note --
                   S - Secure Systems

:0
                                                            Overview

    Ther� ar� fiv� director� displa�� utilitie� provide� �
wit� th� ZCPR� System��  Eac� provide� th� use� wit� th� �
basi� functio� o� displayin� th� name� o� file� i� � logica� �
dis� director� (� dis� an� use� area).

    Th� first�� an� simplest�� utilit� i� buil� int� th� �
ZCPR� Comman� Processor��  Thi� utility� invoke� b� th� nam� �
o� DIR� i� ver� primitive� displayin� jus� th� fil� name� i� �
whatever order they reside on disk.

    Th� secon� utilit� i� availabl� a� � utilit� withi� th� �
standar� Residen� Comman� Package�  Thi� utility� als� name� �
DIR, displays the file names sorted in alphabetical order.

    Th� thir� utilit� i� DIR.COM�� � smal� 2ˠ transien� �
whic� display� fil� name� (sorte� b� fil� nam� an� typ� o� �
b� typ� an� name� an� fil� sizes.

                                                            Overview
    Sinc� al� thre� o� thes� utilitie� ar� name� DIR�� i� �
make� sens� t� enabl� onl� on� o� the� pe� system��  Th� �
trad� of� o� utilit� fo� dis� spac� i� th� basi� choic� t� �
be made.

    Th� las� tw� utilitie� ar� X� an� XDIR��  X� i� � fast� �
4ˠ utilit�� whic� provide� � usefu� se� o栠 function� �
includin� horizonta� an� vertica� displa�� formats�� outpu� �
sorte� b� fil� nam� an� typ� o� typ� an� name�� R/� an� SY� �
flags, and printer output.

    XDI� i� 8� i� siz� an� provide� al� o� th� feature� o� �
XĠ plu� th� abilit� t� writ� it� displa� t� dis� an� � fil� �
scanner.

    Th� ZCPR�� Syste� use� ma� fin� us� fo� al� o� thes� �
utilitie� o� hi� system��� dependin� o� hi� need� an� �
preference��  Th� smalle� utilitie� ma� d� th� jo� i� mos� �
cases, and they load faster than the full-featured XDIR.
                                                            Overview

    Al� o� thes� utilitie� ar� designe� t� b� ru� unde� �
ZCPR� exclusively�  The� wil� no� functio� correctl� unde� � �
conventional CP/M 2.2 system.

    Thes� utilitie� automaticall� adap� t� an� Org-� ZCPR� �
System�� regardles� o� th� siz� o� it� disks�  The� rea� th� �
dis� paramete� bloc� informatio� fro� th� operatin� syste� �
t� determin� wha� th� attribute� o� th� dis� the�� ar� �
workin� wit� are�� an� the� the� presen� thei� displa� �
information.


                    Comparison Matrix

Attribute           Z3 DIR    RCP DIR   DIR  XD   XDIR
---------           ------    -------   ---  ---  ----
Size                N/A       N/A       2K   4K   8K
Sort File Names     No        Yes       Yes  Yes  Yes
Select Sort Order   N/A       No        Yes  Yes  Yes
Select SYS Files    Yes       Yes       Yes  Yes  Yes
Select All Files    Yes       Yes       Yes  Yes  Yes
Negate File Select  No        No        No   No   Yes
Displ File Attr     No        No        No   Yes  Yes
Horiz/Vert Format   No        No        No   Yes  Yes
Printer Output      ^P        ^P        No   Yes  Yes
 Form Feed         No        No        No   Yes  Yes
Select All Users    No        No        No   No   Yes
Disk Output         No        No        No   No   Yes
File Scanner        No        No        No   No   Yes


:1
Command:  XDIR 2.0

Syntax:
    XDIR dir:afn ooo...
or
    XDIR /ooo...

Function:
    XDIҠ display� � dis� director� t� th� use� an� act� a� �
a file name scanner.

Options:
    Aa - Indicate attributes of files to be selected
         a=A for All Files (System and Non-System)
         a=N for Non-System Files [default]
         a=S for System Files
    �  - Sen� Outpu� t� Dis� Fil� XDIR.DIR
    Ff - Enable a File Scanner Function
         f=L to Log File Names to FNAMES.DIR
         f=P to Print File Names Stored in FNAMES.DIR
         f=S to Scan Disk and Compare to FNAMES.DIR
    I  - Inspect Logged Files (use with FL option only)
    N  - Negate Selection of Files
    Oo - Select Output Features
         o=� t� Disabl� Displa� o� Fil� Attribute� (R� S)
         o=F to Form Feed Printer when Display Done
         o=G to Group Files by Name and Type
         o=H to Display Files in Horizontal Format
    P  - Send Display to Printer
    PF - Send Display to Printer with Trailing Form Feed
    U  - Select All User Areas

Comments:

    XDIR is on the order of 8K in size.

    Th� principa� reason� t� us� XDIҠ ove� th� othe� �
director� displa� utilitie� are:
         1. XDIR is able to send its output to disk
         2. XDIR provides the File Scanner Function
         3. XDIR can display all user areas of a disk

    I� th� defaul� attribute� o� XDI� ar� no� t� th� user'� �
likin� (eg�� � listin� b� fil� nam� an� typ� i� preferred)� �
there are three alternatives:

         1. XDIR can be reassembled
         2�� th� attribute� ca� b� patche� vi� DDԠ (the� �
start at the 6th byte from the front of the program)
         3�� a� ALIAӠ ca� b� create� whic� select� th� �
desired attributes for the user

Selected Error Messages:

    "TP�� Error� indicate� memor� overflow�� ther� wa� no� �
enoug� memor�� availabl� i� th� TP�� t� loa� th� dis� �
directory

Examples of Use:

    XDIR
         -- display� � listin� o� th� non-syste� file� i� �
th� curren� director� i� th� followin� fashion:

              1. Sort is by File Type and Name
              2. Listing is in a Vertical Format
              3. Attributes of Each File (R/O, SYS) shown
              4. File Sizes in K
              5. Total of Sizes of All Files


    XDIR /AA
         -- lik� th� firs� example� bu� bot� non-syste� an� �
system files are displayed

    XDIR /OH
         -- lik� th� firs� example�� bu� Listin� forma� i� �
Horizontal

    XDIR /OG
         -- lik� th� firs� example�� bu� Sor� i� b�� Fil� �
Nam� an� Type

    XDIR *.COM /NFL
         -- th� name� o� al� non-syste� file� whic� d� no� �
match *.COM are stored on disk in a file named FNAMES.DIR


:B



                       XDIR Summary



    XDIR runs in two basic modes:
         . as a directory display utility
         . as a file scanner utility

                                                            XDIR Summary
    A� � director�� displa��� utility��� XDIҠ� display� �
informatio� abou� th� file� o� � particula� dis� i� al� use� �
area� o� � particula� use� area��  I� provide� 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 is being displayed

    A� � fil� scanne� utility� i� doe� th� following:
         . Logs a group of selected files to disk
         . Prints the contents of such a log file
         � Scan� � lo� fil� an� compare� i� wit� th� file�
              selected by the user, telling him what files
              are missing and what files are additional
                                                            XDIR Summary
    XDIҠ 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

:O

                   XDIR Output Control

    The Output Control options of XDIR 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

    I� Р i� specified�� th� outpu� goe� t� you� printe� �
(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.

                                                            XDIR Output

    O�� allow� th� use� t� selec� th� displa� t� omi� 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� i� Non-System.

    OƠ allow� th� use� 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� th� for� fee� �
function).
                                                            XDIR Output

    OǠ allow� th� use� t� selec� hi� displa�� t� b� �
alphabetize� b� fil� nam� an� type��  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� XDIR.� files)�� whil� b� fil� typ� an� �
nam� group� file� o� th� sam� typ� togethe� (F� fields� lik� �
al� *.TX� files).

    O� allow� th� use� t� selec� hi� alphabetize� file� t� �
b� liste� acros� th� scree� (horizontally)��  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.

                                                            XDIR Output

    XDIҠ provide� suc� � wid� variet� o� outpu� display� �
tha� i� i� recommende� tha� th� use� experimen� wit� th� �
variou� XDIҠ option� t� se� whic� forma� o� display� h� �
prefers��  Th� defaul� setting� fo� th� variou� option� ca� �
b� change� b� intelligen� us� o� DD� o� b� reassembl� o� th� �
XDIR.MAà sourc� i� th� use� prefer� � differen� se� o� �
defaults.

:F

                   XDIR File Selection

    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
         U  - Select All User Areas

    Th� � optio� negate� a� 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.

                                                            XDIR File Select

    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.

    Th� � optio� select� al� file� whic� d� no� matc� th� �
ambiguou� fil� name��  Th� scop� o� th� � optio� i� withi� �
th� attribute� selected�� s� i� th� attribute� ar� AS�� onl� �
system files are shown.

    Th� ՠ optio� select� al� use� area� o� th� dis� �
selected��  Fil� name� ar� displaye� wit� th� numbe� o� th� �
user area they reside in front of their names.

:N

                  XDIR File Name Scanner

    Th� option� o� XDI� whic� dea� wit� th� Fil� Nam� �
Buffe� Facilit� 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 for 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.

                                                            XDIR File Scan

    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� file� i� use� b� th� F� an� F� options.

    Th� � optio� (fo� inspect� allow� th� use� t� manuall� �
approv� eac� fil� befor� it� nam� i� place� int� FNAMES.DIR.

    Th� F� optio� 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� i� find� i� o� reache� th� en� o� th� path.

                                                            XDIR File Scan

    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� printe� a� a� additiona� �
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� file� wil� com� u� missin� whil� �
thi� i� no� necessaril� true.

:S

                      Secure Systems

    O� Secur� Systems�� suc� a� Remot� CP/͠ Systems�� th� �
variou� director� displa� utilitie� ma� b� se� t� recogniz� �
onl� th� DI� for� o� director� reference��  Thi� i� don� a� �
installation time.

    Associate� wit� eac� director� nam� i� � password��  I� �
thi� passwor� i� blank�� fre� acces� t� th� director�� i� �
granted��  I� i� i� non-blank� however� th� use� i� prompte� �
fo� th� passwor� b� ZCPR3��  I� h� doe� no� giv� th� correc� �
password�� ZCPR�� reference� hi� curren� directory�� an� an� �
director�� displa� utilit� wil� onl� sho� th� file� i� hi� �
current directory.

:2

                       XD Overview

    Wit� usage�� i� ha� bee� note� tha� mos� o� th� mor� �
exoti� feature� o� XDI� ar� no� use� mos� 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� ha� bee� 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� i� smalle� tha� XDIR.


Command:  XD 1.2

Syntax:
    XD dir:afn ooo...
or
    XD /ooo...

Function:
    XĠ display� � formatted�� alphabetize� listin� o� th� �
contents of a disk directory.


Options:
    Aa - Indicate attributes of files to be selected
         a=A for All Files (System and Non-System)
         a=N for Non-System Files [default]
         a=S for System Files
    Oo - Select Output Features
         o=� t� Disabl� Displa� o� Fil� Attribute� (R� S)
         o=F to Form Feed Printer when Display Done
         o=G to Group Files by Name and Type
         o=H to Display Files in Horizontal Format
    P  - Send Display to Printer
    PF - Send Display to Printer with Trailing Form Feed


Comments:

    X� i� smalle� tha� XDI� (4� v� 8K)� and� a� such� ha� � �
large� memor� buffe� i� whic� t� loa� files�  I� i� possibl� �
fo� ver�� larg� har� dis� system� tha� XDIҠ ma�� no� hav� �
enough buffer space to perform its function, but XD may.

    Th� default� o� X� ca� b� change� i� th� sam� fashio� �
a� thos� fo� XDIR��  Se� th� "Comments� sectio� o� th� XDI� �
command for details.

Selected Error Messages:

    "TP�� Error�� mean� tha� ther� wa� no� enoug� roo� i� �
memory to load the disk directory.


Examples of Use:

    XD
         -- displa�� th� non-syste� file� i� th� curren� �
directory in the following fashion:
              1. sorted by file type and name
              2. vertical format
              3. R/O and SYS attributes included

    XD *.COM AAOA
         -- displa�� bot� non-syste� an� syste� file� whic� �
match *.COM in the following fashion:
              1. sorted by file type and name
              2. vertical format
              3. no attributes included in display

    XD ROOT:*.COM AAOA
         -- like above, but files in directory named ROOT

:3

Command:  DIR 1.0

Syntax:
    DIR dir:afn o...

Function:
    DIҠ display� � formatted�� alphabetize� listin� o� th� �
files in a disk directory.

Options:

    A - Display both non-system and system files
    S - Display only system files
    T - Display files sorted by file type and name
         (sort by name and type is default)


Comments:

    DIR is not compatible to XDIR and XD in syntax!

    DIҠ i� onl� 2� i� size��  DI� i� designe� t� b� smal� �
an� fast�� providin� mor� utilit� tha� th� ZCPR3-residen� o� �
RCP-resident counterparts.

    I� th� use� wishe� t� us� a� option�� th� AF� mus� b� �
fille� wit� *.� - otherwise�� th� optio� wil� b� interprete� �
as a file specification.

    �� slas� a� � delimite� (DIҠ /A��� fo� instance� �
automatically displays the built-in documentation.


Selected Error Messages:

    "Ovfl�� mean� tha� ther� wa� no� enoug� buffe� spac� i� �
the TPA to contain the disk directory.

Examples of Use:

    DIR
         -- display� al� non-syste� file� i� th� curren� �
directory in the following fashion:

              1. Horizontal display
              2. Sorted by file name and type

    DIR *.* A
         -- lik� above�� bu� bot� non-syste� an� syste� �
files are selected

:4

Command:  DIR (provided in SYS.RCP)

Syntax:
    DIR dir:afn o...

Function:
    Display a sorted disk directory to the user.

Options:
    A - Select both non-system and system files
    S - Select only system files

Comments:

    Thi� comman� i� bette� tha� th� DI� i� ZCPR� i� tha� i� �
sorts the file listing.

    Horizontal display format is used.


Selected Error Messages:

    None

Examples of Use:

    DIR
         -- display� al� non-syste� file� i� th� curren� �
directory in a sorted fashion (by file name and type)

    DIR *.* A
         -- display� bot� non-syste� an� syste� file� i� �
current directory

    DIR ROOT:*.* A
         -- display� bot� non-syste� an� syste� file� i� �
ROOT directory

:5

Command:  DIR (provided within ZCPR3 Command Processor)

Syntax:
    DIR dir:afn o...

Function:
    Display a disk directory to the user.

Options:
    A - Select non-system and system files
    S - Select system files only

Comments:
    None

Selected Error Messages:
    None


Examples of Use:

    DIR
         -- displays non-system files in current directory

    DIR *.* A
         -- display� bot� non-syste� an� syste� file� i� �
current directory