;
                                   ADIR.COM                                   

             Size (recs) CRC   Version    Author/Latest Issue      Disk
ADIR22IN.COM   4k (30)   0934  2.2        Greg Miner 1/89          Z3COM1
ADIR22EX.COM   4k (32)   1E99  2.2        Greg Miner 1/89          Z3COM1

   1- Syntax  2- Notes  3- Patch Table  4- Error Message                      

   ADIR provides  a sorted list in a directory format of all Aliases contained
in the ALIAS.CMD file.   ALIAS.CMD must be located in the ROOT directory,  the
last element along your search path.   Alternatively, the Drive/User to search
in the form DU: or DIR:, may be entered on the command line.

   ADIREX.COM is for use with an External Environment.   If using ZCPR3.3, you
may use the program  as is.   For ZCPR3.0,  simply patch the  address  of your
External Environment at locations 0109h and 010Ah or use Z3INS.
   ADIRIN.COM is  for systems  which do  not support  an external environment.
Use Z3INS to install your environment.
:1

       Syntax:  ADIR du:filename.typ /oo   <-- produces directory of
            or  ADIR dir:filename.typ /oo           ALIAS.CMD file 

      Options:  N   <-- No page pause
                S   <-- Display hidden
                P   <-- Send output to LST:

   The use of filename.typ is wheel dependent to prevent use of the program to
peek  into  other,  possibly  restricted  text  files.   ADIR has  no means of
distinguishing an ALIAS file from any other,  nor does it test the system file
attribute as  the  ALIAS.CMD file will usually  be SYS.   If 'filename.typ' is 
omitted, ALIAS.CMD is used.  If '.typ' is  omitted,  the extention  CMD is the
default.

   When ALIAS.CMD,  or the selected file,  is located in  a password-protected
directory,  either by  path  search or  by user selection,  the Wheel  byte is 
checked  and,  if not set,  the user is requested  for the directory password.
An invalid entry terminates the program. 
:2

ADIR Notes:

   a. ADIR assumes that the ALIAS.CMD file adheres to a few simple rules:

      1.  ADIR ignores any line  beginning  with  a space.   Aliases beginning
          with  a  punctuation  character  are  special  cases.   The  leading 
          character is normally ignored  and the alias is  displayed as though 
          it did not exist.

              Thus the line:
                             :default Z3ERROR
              is ignored, while
                             :DEFAULT Z3ERROR
              would be displayed as:
                              DEFAULT

          If the  /S switch were used in the above example,  then both aliases
           would be displayed as found, including the leading colons.



ADIR Notes (cont'd):

      2.  ADIR assumes that any alias beginning with a lower case letter (a-z)
          is "system" or hidden.   These are not displayed nor included in the 
          final tally (see switch /S). Thus the lines:

             PACK ROOT:;PUBLIC /CA;PACK2;PUBLIC /DAU8;%D0%U0:
             pACK2 LX SAP;LX PACK10

          produce only one entry,  "PACK" in the  directory.   The rest of the
          alias name may be in either upper or lower case.



ADIR Notes (cont'd):

      3.  No case switching is performed by ADIR.   If you want your directory
          in upper case, then the alias names must appear in the file in upper
          case.   The exception is  the first character which  is used  as the 
          display/hide switch explained  above.   A  very nice  display can be 
          produced if  all entries  in  your ALIAS.CMD  file  which  you  want 
          displayed are in upper case,  and those which are not normally to be 
          displayed are in lower case.   In this way,  when  the /S  switch is 
          used, hidden aliases appear distinctly in the display.  This feature
          may  be overridden  by setting  the capitalization flag in the patch 
          table located at the beginning of the program to TRUE (0FFH).



ADIR Notes (cont'd):

      4.  "Equated" aliases are treated as separate entries. 

          ie.  SD=?DIR=D=dIR/? produces two entries: SD and D, while
          ?DIR and dIR/? are ignored as explained above.

      5.  Finally, ADIR assumes by default that the maximum length of an alias
          name will be nine characters.  This allows room for a colon, etc. in
          the  case  of  a  Directory  name  (PERSONAL:)  or  the  '.'  in  an 
          abbreviated alias (PERS.ONAL).  Both of these types are displayed as
          found.
                   PERSONAL:   PERS.ONAL

:3

ADIR Patch Table - configure to suit

                            Location
LABEL     Function    Default   ADIR22EX  ADIR22IN    Comments
 -------------------------------------------------------------
CAPSON   Capitalize      0       10BH      202H        Note 1
TLINE    Chars/Line   50H/80     10CH      203H        Note 2,3
PLINE    Lines/Page   16H/24     10DH      204H        Note 2
ALENTH   Default Len. 0AH/10     10EH      205H        Note 3

NOTE 1
   Capitalization Flag.   Default is OFF to display Aliases as found.   If set
TRUE (0FFH),  all  aliases,  including hidden  if  the /S switch  is used, are 
displayed in Upper Case.

NOTE 2
   Terminal characters  per line  and lines per page.   Congigure to suit your 
hardware, or preference (See Note 3).


ADIR Patch Table (cont'd):

NOTE 3
   Set ALENTH to the  maximum number of characters in  an alias name.   If any 
alias exceeds this length, you'll have trouble.  The number of aliases printed
on  a line is  a function of ALENTH and TLINE.   With the default settings the 
display is  eight columns wide.   The formula for the number of columns is the  
integer of TLINE divided by ALENTH.  Thus if you want a display of six columns
on  an  eighty character terminal,  set TLINE to 50H  and ALENTH to 0DH.   The 
display would then be left justified with 13 chars allotted to each entry.
 
   As a footnote, it should be remembered that the larger ALENTH is, the fewer
actual records ADIR will be able to handle.   This will not  be  a problem  in 
most cases  as ADIR uses all  of available memory for the data table up to the 
location of the CCP.  This means that with the default setting ALENTH=10, over 
4400 Aliases could be accomodated.  Not a very likely case, eh?
:4



Error Message:  

   "File A15:ALIAS.CMD not found."                                
