.;Create ^M^aster ^D^irectory ^L^isting
^%                                   MAKMDL                                  %^
%                             James A. Jarboe IV                            %

  ^MAKMDL^ is a quick  and  easy  way  to  create  a ^M^aster ^D^irectory ^L^isting
  similar  to  the ^AMOS^ command ^DIR/V/H/D^. ^MAKMDL^  will  also  include  the
  creation date  and  time,  the name of the user that created the listing,
  (provided  that  user name is  set),  and  the  current  version  of  the
  operating system.

  If the sequential file ^SYSNAM^.^DAT^ is on DSK0:[1,4] the data in that file,
  usually the system name, will also be included in the directory listing.

  The directory listing created with ^MAKMDL^ can be verified with ^VERDIR.LIT^
  available on the AMUS Network. Directory listings created with ^MAKMDL^ can
  also be verified with AMOS's VERIFY  if  the  /^AMOS^  switch  is used. All
  comments will be excluded from the directory listing with this switch.

  ^MAKMDL^ will display, each file  as  it  is processed and display the hash
  total and version number (if one exists), unless the /^NODISPLAY^ switch is
  used.



     ^% MAKMDL - Create Master Directory Listings %^         Screen 2 of 9


.R 0
  %USAGE:
.R %

   ^MAKMDL {Output filespec =} Input filespec{/Switches},Input filespec^

% Where: %

 ^Output filespec^   Optional name of file that filenames  will be output to.
                   Defaults  to  ^MDLLST.DIR^.  Extension defaults to ^.DIR^ if
                   filename is given with no file extension.


 ^Input filespec^    Name   of  file  or  files  to create a ^M^aster ^D^irectory
                   ^L^isting   from.    Input   file  specifications  can  be
                   ^wildcarded^.   Defaults  to  ^*^.^*^   if   no   input   file
                   specification is given.





     ^% MAKMDL - Create Master Directory Listings %^         Screen 3 of 9

% Switches: %

  /^HELP^ or ^?^       Displays the switch options and if a ^.HLP^ file exists in
                   the  same  ^PPN^ or in the ^HLP:^ account, the user will  be
                   prompted to display the additional help information.

  /^QUERY^           Will query user for files to include into listing.

  /^AMOS^            Creates an output that is the  same  as  the output file
                   created  with  ^DIR/V/H/D^.  Comments and date/time stamps
                   will not be included in the output file.

  /^KILL^            Will ^delete^ the output file if it already exists.

  /^DISPLAY^         Will display  each  file,  hash and/or version number as
                   it is processed. ^/NODISPLAY^  will  silence all output to
                   terminal.




     ^% MAKMDL - Create Master Directory Listings %^         Screen 4 of 9


  /^WAIT^            Will wait for a file locked by LOKSER to become unlocked
                   before  attempting  to process. If the ^NO^WAIT switch  is
                   set and a file is locked  by  LOKSER,  ^MAKMDL^ will alert
                   the user and bypass including this file. The output file
                   will  contain  the  message  "file  in use -  Bypassed".
                   ^VERDIR^ and AMOS's VERIFY will both process this listing.

  /^NO^switch        ^MAKMDL^ uses CMDLIN.SYS for wildcarding. Using the prefix
                   ^NO^, with  any  switch,  will  negate  the  action of the
                   specified switch.










     ^% MAKMDL - Create Master Directory Listings %^         Screen 5 of 9

  ^MAKMDL^  will  separate,  with  a  comment character, the different  PPN's
  encountered while creating a directory listing and the files  on a command
  line that are separated by commas. Example:

  ^MAKMDL MDLLST.DIR=MAKMDL.*[],VERDIR.*[]^

  The output file will look like:

^;*; MDL created on Monday, May 27, 1991 at 09:47:48 AM by James A. Jarboe I V^
^;*; On Educational Video Network, Inc. AMOS/L Version 1.3D(165)-3^
^;^
^WRK0:MAKMDL.LIT[001,004]              1.0(105)          366-370-231-524^
^;^
^WRK0:MAKMDL.HLP[007,001]                                358-087-234-766^
^WRK0:MAKMDL.T[007,001]                                  589-789-324-110^
^;^
^WRK0:VERDIR.LIT[001,004]              1.1(115)          450-061-274-006^
^;^
^WRK0:VERDIR.HLP[007,001]                                660-124-244-874^
^WRK0:VERDIR.T[007,001]                                  226-665-568-774^

     ^% MAKMDL - Create Master Directory Listings %^         Screen 6 of 9


  Example:

  ^MAKMDL MDLLST.DIR=WRK0:*.*[]^

  The output file will look like:

^;*; MDL created on Monday, May 27, 1991 at 09:55:48 AM by James A. Jarboe I V^
^;*; On Educational Video Network, Inc. AMOS/L Version 1.3D(165)-3^
^;^
^WRK0:MAKMDL.LIT[001,004]              1.0(105)          366-370-231-524^
^WRK0:VERDIR.LIT[001,004]              1.1(115)          450-061-274-006^
^;^
^WRK0:MAKMDL.HLP[007,001]                                358-087-234-766^
^WRK0:MAKMDL.T[007,001]                                  589-789-324-110^
^WRK0:VERDIR.HLP[007,001]                                660-124-244-874^
^WRK0:VERDIR.T[007,001]                                  226-665-568-774^




     ^% MAKMDL - Create Master Directory Listings %^         Screen 7 of 9

% Characteristics and advantages %

^o^    Output file  defaults  to  ^MDLLST.DIR^ if ^=^ is used with no output file
     specification.

^o^    Output file defaults to ^.DIR^ file extension.

^o^    Can  create ^MDL^'s of  multiple directory listings at one time as input
     filespec can contain wildcards or multiple directory specifications.

^o^    Can create directory listings across ^Networks^.

^o^    Terminal output display is pretty.

^o^    Output  file will always default to include time and date stamps, name
     of user who created  the  output  file,  (if user name is set) current
     system and version number.




     ^% MAKMDL - Create Master Directory Listings %^         Screen 8 of 9


^o^    If the system contains SYSNAM.DAT  in  DSK0:[1,4], that data will also
     be included in the output file.

^o^    Works on all versions of AMOS.
















     ^% MAKMDL - Create Master Directory Listings %^         Screen 9 of 9

     To convert this to an ^AMOS^ style help file use ^DSH2AM.LIT^
     available on the AMUS Network.

     Any ^comments^, ^suggestions^, for ^MAKMDL^ should be made to:

     ^James A. Jarboe IV^
     Educational Video Network, Inc.
     1401 19th Street
     Huntsville, Texas 77340

     (^409^)^295^-^5767^

     Send Email to ^GR^/^AM^ on the ^AMUS Network^.





.
