Help for LABVFY

PURPOSE

    labvfy verifies that the label of an image contains a specified
string, and thus is actually the desired image.  It is meant to
be used in TCL procedures.


EXECUTION 

    local  flag  integer

    labvfy  IMAGE.IMG  KEYWORD="LAB01"  LABEL="218S11" RESULT=FLAG
or
    labvfy  IMAGE.IMG  TASK="CONVIM" KEYWORD="LAB01" LABEL="218S11" RESULT=FLAG

    if (FLAG = 0)
	write "Wrong image!"
    end-if

OPERATION

    labvfy matches the string specified by the LABEL parameter with
the value of the string keyword specified by the KEYWORD parameter.
If the TASK parameter is given then the match is only performed for
the first instance of that task in the history labels.  If the TASK
parameter is defaulted then all tasks are used for the match.  If
the LABEL string is found in any of the tasks then a match will be 
indicated.  The results of the matching are returned to an integer
TCL variable whose name is specified with the RESULT parameter.
A result of 1 is returned for a match, and 0 for no match.


Original Programmer:	Frank Evans		June 1986

Cognizant Programmer:	Frank Evans

Made Portable For UNIX: CRI                     05-SEP-94