NAME
    qprepCommandLineDirectivesParse: parse and evaluate command-line directives


  USAGE
    $status_code = qprepCommandLineDirectivesParse(\%state_table,
                                                   \%message_table,
                                                   \%directives_table,
                                                   \%translation_table,
                                                   \@cmd_line_directives_array,
                                                    $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

   \%translation_table (in): table of directive translation rules

   \@cmd_line_directives_array (in): array of directive strings

   $output_stream (in/out): file handle to output script


  DESCRIPTION
    This routine parses directives previously extracted from the
    qprep command-line arguments.

    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