.; Use ^DIR^ to find files on the system
.;.>...|...|...|...|...|...|...|...|...|...|...|...|...|...|...|...|....<..|
  %                      *** The DIR Command ***                         %


                           Table of Contents

      ^Basics in using DIR^                                 Page ^2^

      ^Using Wildcards with DIR^                            Page ^4^

      ^Writing a directory to a file^                       Page ^5^

      ^Writing a directory to user memory^                  Page ^6^

      ^Writing a directory to a printer^                    Page ^7^

      ^Directory Switches^                                  Page ^8^





                             Page ^1^ of ^9^
  %                      *** The DIR Command ***                         %

                           ^Basics In Using DIR^

   ^DIR^ is a monitor command and you must be at ^AMOS monitor^ in order to
   use it.  Refer to HELP AMOS if you are unfamiliar with AMOS monitor.

   In using DIR, remember the following format:

               ^DIR {Directory Filespec =} Filespec/Switches^

   The  {Directory Filespec =} anly applies when  writing  a directory to
   a  file,  user  memory, or a printer.  You do not need to specify  the
   Directory Filespec  and  the equal sign when you wish the directory to
   appear on your CRT screen.

   For more help with Filespec, refer to HELP FILES.

   ^Switches^  are options which extend to power of finding files.  For a
   further explanation of switches, refer to HELP SWITCH.

                             Page ^2^ of ^9^
  %                      *** The DIR Command ***                         %

                           ^Basics In Using DIR^

   To find a file on the system, use the following steps:

   ^1^.  Decide  how  much of the system  you wish  to look through for the
       file(s).   The  system  consists  of more than one disk device and
       PPN; limit you searching to a single  device   or  PPN.   If   you
       can't seem to  find  a  file  that  you KNOW is on the system, you
       may need to expand the area you are looking through

   ^2^.  Decide  where  you  want  the directory  sent to (your CRT screen,
       a file, a printer).

   ^3^.  Determine the filespec  which best represents  the file(s) you are
       looking for.  This will help you find what you  are looking for in
       the shortest amount of time.



                             Page ^3^ of ^9^
  %                      *** The DIR Command ***                         %

                         ^Using Wildcards with DIR^

   Wildcards  enable  you  to  look  for  more  than  one file at a time.
   Wildcards can be very useful if you do not remember all of a filespec.

   For example:
       Find all files on the current PPN  with the first three letters of
       the filename = OLD;
       Type : ^DIR OLD*.*^

       Find all files on the current Disk  Device  with  filenames  three
       letters or less; Extension = OLD;
       Type : ^DIR ???.OLD[]^

       Find all files on system with filename URGENT;
       Type : ^ALL:URGENT.*[]^

   For more help with Wildcards refer to HELP WILD.

                             Page ^4^ of ^9^
  %                      *** The DIR Command ***                         %

                      ^Writing a directory to a file^

   Writing a directory  to  a file involves creating a file that does not
   already exist.  If you attempt  to  write  a  directory to a file that
   alrady exists, you will be reminded that the file  already  exists and
   you will be unsuccessful.

   You  may only write a directory to a file in the PPN you are currently
   in.  This  means  you  may  not  create  a file in another PPN or Disk
   Device.

   Here is an example:
       Files with ^T^ extension; Directory Filespec = ^FILES.DIR^;
       Disk Device = ^DSK1:^; PPN = ^5,51^;
       Type : ^DIR FILES.DIR=DSK1:*.T[5,51]^

   The file  FILES.DIR  will  VUE  format  file  and  its  contents  will
   be identical to a directory sent to a CRT screen.

                             Page ^5^ of ^9^
  %                      *** The DIR Command ***                         %

                    ^Writing a directory to user memory^

   You may wish to write the directory to user memory because it you will
   may not wish  to create a file and it is easy to look at the directory
   in user memory if you move to another PPN or Disk Device.

   Writing a directory to  user  memory  is  exactly  the  same  steps as
   writing a directory  to  a  file,  except  for  one  change.   The one
   difference  is  in  the  Directory  Filespec.  You  must  type  ^MEM:^
   immediately before the filename of the file

   Here is an example:
       Files with T extension; Directory Filespec = ^FILES.DIR^;
       Disk Device = DSK1:; PPN = 5,51;
       Type : ^DIR MEM:FILES.DIR=DSK1:*.T[5,51]^

   You  may not modify this 'file'.  You may only look at it.  To look at
   it, you must enter the following at monitor : ^TSV MEM:FILES.DIR^

                             Page ^6^ of ^9^
  %                      *** The DIR Command ***                         %

                     ^Writing a directory to a printer^

   Writing a directory to a terminal is very much like copying to a file.
   The difference lies in the name that you give the Directory Filespec.

   To write a directory to a terminal, use the following format:

                   ^DIR TRM:Terminal name=Filespec^

   Terminal  name  is the name of the terminal  you  wish  to  copy  to.
   Terminal names can be found by typing ^TRMDEF^ at AMOS Monitor.

   If  the  terminal  you  wish to copy to is a printer, the name of the
   printer can be found by typing ^PRINT^ at AMOS Monitor.

   For Example:
       Terminal = ^CITOH^; Filespec = ^OLDONE.*[]^
       Type : ^DIR TRM:CITOH=OLDONE.*[]^

                             Page ^7^ of ^9^
  %                      *** The DIR Command ***                         %

                            ^Directory Switches^

   There  are  a number of switches you can use with DIR.  By and  large,
   you will find  one switch very useful while the others will rot by the
   wayside,  waiting for you to use them.  If you wish to learn about the
   other  switches,   you  may  brave  the  either  HELP DIR, the System
   Commands Reference Manual or you may ask the system operator  and  run
   the  risk of ticking him off. (only joking!!!?)

   The  one  switch that you will find useful  is  ^/W^.  This  prints  the
   directory four  columns wide on the screen or terminal you are sending
   the directory to.

   If  you  wish  to  make  best  use  of  computer  paper when sending a
   directory to a printer, use the following switches:
                        ^/W:5^  for regular white paper
                        ^/W:10^ for green bar.
   If you don't understand what a switch is, refer to HELP SWITCH.

                             Page ^8^ of ^9^
  %                      *** The DIR Command ***                         %


   If you still do not know how to do a directory,  go  over   this  help
   file  again   and  make a list of the terms or phrases that you  don't
   fully understand.






                       % May the Force be with You %








                             Page ^9^ of ^9^
END OF DIR HELP FILE

.
