;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^.