MSG_OUT

Output a message

Description:

Any tokens in the supplied message are expanded and the result is output to the user unless the conditional output filter is set to MSG__QUIET. All existing message tokens are then annulled. If the expanded message exceeds the maximum allowed size, it will be terminated by an ellipsis (i.e. “...”) but no error results.

If STATUS is not set to SAI__OK on entry, no action is taken except to annul existing message tokens.

If an output error occurs, an error is reported and STATUS is returned set to MSG__OPTER.

A call to MSG_OUT is equivalent to a call to MSG_OUTIF with the message output priority set to MSG__NORM.

Invocation

CALL MSG_OUT( PARAM, TEXT, STATUS )

Arguments

PARAM = CHARACTER $\ast$ ( $\ast$ ) (Given)
The message name.
TEXT = CHARACTER $\ast$ ( $\ast$ ) (Given)
The message text.
STATUS = INTEGER (Given and Returned)
The global status.