next up previous 211
Next: MSG_OUTIF - Conditionally deliver the text of a message to the user
Up: Subroutine Specifications
Previous: MSG_LOAD - Expand and return a message


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 * ( * ) (Given)
The message name.
TEXT = CHARACTER * ( * ) (Given)
The message text.
STATUS = INTEGER (Given and Returned)
The global status.



next up previous 211
Next: MSG_OUTIF - Conditionally deliver the text of a message to the user
Up: Subroutine Specifications
Previous: MSG_LOAD - Expand and return a message

MERS (MSG and ERR) Message and Error Reporting Systems
Starlink User Note 104
P C T Rees
A J Chipperfield
22 October 2001
E-mail:ussc@star.rl.ac.uk

Copyright © 2001 Council for the Central Laboratory of the Research Councils