NAME
    qprepInputScriptFileParse: parse script file preamble


  USAGE
    $status_code = qprepInputScriptFileParse(\%state_table,
                                             \%message_table,
                                             \%directives_table,
                                              $input_stream,
                                              $output_stream) ;


  ARGUMENTS
   \%state_table (in/out): reference to hash table of qprep options

   \%message_table (in): nested hash table of error messages and codes.
      (See qprepMessageTableInitialize(3))

   \%directives_table (in): table of valid directives

   $input_stream (in): file handle for input script

   $output_stream (in): file handle for output script



  DESCRIPTION
    This routine parses directives in the preamble of a qprep script.

    See the qprep(1) man page for valid syntax directives.

    This routine extracts directives from the script preamble,
    which are pseudo-comments of the form
      #PSTQ key=value .

    This routine evaluates those qprep control directives,
    and calls qprepPreTranslationCallback.


  RETURN VALUES
    Returns 0 if no errors occurred.
    Returns non-zero if error occurred.


  AUTHORS
    Written by Michael J. Gourlay
    in collaboration with Joe Werne, Chris Bizon and others.


  SEE ALSO
    qprep(1),
    Practical Supercomputing Toolkit web site: https://pstoolkit.nwra.com