
This is a program to copy a random text file in a directory matching
a wildcard specification to an output file.

The theoretical limit is 500 wildcard files. The maximum tested by
the author is 120.

Usage is RANDOM [d:][\path\]wildcard   [d:][\path\]output_filename

Where:
      d: is the drive(s) - optional
      \path\ is the directory(s) - optional
      wildcard is the standard DOS wildcards, * & ?
      output_filename is any DOS legal name.

Examples:
         RANDOM  *.txt  out.txt
         RANDOM  *.asc  c:\qbbs\text\hello.asc
         RANDOM  c:\ansi\*.ans  d:\out\today.ans

Both command line parameters are mandatory. Omitting one or both or
using a non-existence drive and/or path will display the help screen
and halt the program with errorlevel 255.
At least 2 files in the directory must match the wildcard specification,
or the program will halt with the help screen and exit with errorlevel 255.

Other errorlevel numbers:
        2  -  No such filename in directory  
        3  -  No such directory path  
        4  -  Too many files opened simultaneously  
        5  -  File access denied for intended operation  
        6  -  Unrecognized file handle  
       12  -  Attempted file access with wrong filemode  
       15  -  Invalid drive number used in getdir  
       16  -  Directory cannot be removed by rmdir  
       17  -  Drives specified by rename cannot differ  
      100  -  Attempted read past end of file  
      101  -  Disk data area is full  
      102  -  Cannot attempt I/O without assigning file  
      103  -  File not prepared with reset or rewrite  
      104  -  File not prepared to be read from  
      105  -  File not prepared to be written to  
      106  -  Illegal numeric format in data  
      150  -  Attempt to read write-protected disk  
      151  -  Unit is unknown  
      152  -  Disk drive is not ready  
      153  -  Command is unknown  
      154  -  Error in cyclical redundancy check  
      155  -  Invalid drive request structure length  
      156  -  Seek error on disk  
      157  -  Media type is unknown  
      158  -  Disk sector not found  
      159  -  Printer is out of paper  
      160  -  Write fault on I/O device  
      161  -  Read fault on I/O device  
      162  -  General hardware failure 

This program has not been extensively tested. Determine is suitability
for you usage before committing it to unattended batch file use on
your system.


