NAME
    qprepCommandLineParse: parse command-line arguments of qprep


  USAGE
    $status_code = qprepCommandLineParse(\%state_table,
                                         \%message_table,
                                         \%directives_table,
                                         \%translation_table,
                                          $cmd_line_opts_array_ref,
                                         \@cmd_line_directives) ;


  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_opts_array_ref (in): ref to array of command line args

   \@cmd_line_directives (out): array of directive strings parsed from cmdline


  DESCRIPTION
    This routine parses the command-line arguments of "qprep".

    See the qprep(1) man page for valid syntax of command line.

    This routine extracts from the command line an array of directives,
    which are strings with the format "key=value", and the name of an
    input script file.

    This routine also evaluates parser control directives since they
    could affect how qprep performs subsequent procedures.  Evaluation of
    other directives is not performed here; they simply get stored in
    the cmd_line_directives array.


  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), qprepCommandLineDirectivesParse(3),
    Practical Supercomputing Toolkit web site: https://pstoolkit.nwra.com