ROUTINE
-------

INT_ ug_read_param_file (char ***argv,
                         int *argc,
                         INT_ Message_Flag,
                         UG_Param_Struct * UG_Param_Struct_Ptr)

DESCRIPTION
-----------

Read an input parameter file (*.par) and add the arguments read to the beginning
of the input argument vector.

INPUT ARGUMENTS
---------------

argc              : Pointer to input argument count.
argv              : Pointer to pointer to input argument vector.
Message_Flag      : Message flag.
                    If Message_Flag >= 1 then progress information is written to
                    standard output.

UG_Param_Struct   : UG parameter structure.

OUTPUT ARGUMENTS
----------------

argc              : Pointer to new argument count.
argv              : Pointer to pointer to new argument vector (containing
                    entries in the parameter file).

RETURN VALUE
------------

0                 : Arguments were read and added successfully.
>400              : An error occurred reading the parameter file or
                    re-allocating argument vector.
