Help for WILDCARD

PURPOSE

This program will find all files in the specified directory (default is current
directory) that match the wildcarded string INP. INP can have multiple
wildcards (each specified by an *). A limit on the returned files can be given
with NAME_LMT (it defaults to 512). The files that match INP will be returned
in the local variable specified by LOCALVAR. LOCALVAR must be previously
defined with a count sufficient to hold all the files. 
.IF UNIX
The directory specified and all subordinate directories will be queried.
.IFEND
 
EXECUTION

.IF VAX_VMS
VICAR>WILDCARD wildcard_input_string local_variable maximum_#_files
.ELSEIF UNIX
VICAR>WILDCARD wildcard_input_string local_variable maximum_#_files directory 
.IFEND
EXAMPLES
        If the default directory contains the files,
		TEST01.IMG
		TEST02.IMG
		TEST03.IMG

	Then the following use of WILDCARD will return the files into local
	storage:

		VICAR>local FILES STRING COUNT=0:3
.IF VAX_VMS
		VICAR>wildcard INP=TEST*.IMG LOCALVAR=FILES NAM=3
.ELSEIF UNIX
                VICAR>wildcard inp="TEST*.IMG" loc=FILES nam=3 dir="."

                NOTE: if more than one file can be found the -  inp="xx"
                      must be specified because of the UNIX name expansion.     
.IFEND

	Of course, any wildcard specification can be used that will uniquely
	find only those files desired.

HISTORY

author: K. K. Anderson & C. C. Meisl, 15-FEB-1988
updated: C. C. Meisl, 15-MAR-1988      added wildcard version number
         RNR (CRI) 5-Sept-1994 MSTP S/W Conversion (VICAR Porting)
            Added proceedure for UNIX FIND, NAWK, and "C" to queue
            to a local variable.
cognizant programmer:  C. C. Meisl

PARAMETERS: