MSG_IFGET - Get the filter level for conditional message output from the ADAM parameter system

Description:

Obtain a value for the named parameter and use it to set the value for the filter level for conditional message output. It is recommended that one parameter name is used universally for this purpose, namely MSG_FILTER, in order to clarify the interface file entries. The parameter must be of type _CHAR and the three acceptable strings it may take are:

• QUIET - representing MSG__QUIET;

• NORMAL - representing MSG__NORM;

• VERBOSE - representing MSG__VERB.

• DEBUG - representing MSG__DEBUG.

MSG_IFGET accepts abbreviations of these strings; any other value will result in an error report and the status value being returned set to MSG__INVIF. If an error occurs getting the parameter value, the appropriate status value is returned and an additional error report is made.

Invocation:

CALL MSG_IFGET( PNAME, STATUS )

Arguments:

PNAME = CHARACTER $*$ ( $*$ ) (Given)

The filtering level parameter name.

STATUS = INTEGER (Given and Returned)

The global status.