next up previous 211
Next: MSG_OUT - Output a message
Up: Subroutine Specifications
Previous: MSG_IFSET - Set the filter level for conditional message output


MSG_LOAD - Expand and return a message

Description:
Any tokens in the supplied message are expanded and the result is returned in the character variable supplied. If the expanded message is longer than the length of the supplied character variable, the message is terminated with 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 any existing message tokens.


Invocation:
CALL MSG_LOAD( PARAM, TEXT, OPSTR, OPLEN, STATUS )

Arguments:

PARAM = CHARACTER * ( * ) (Given)
The message name.
TEXT = CHARACTER * ( * ) (Given)
The raw message text.
OPSTR = CHARACTER * ( * ) (Returned)
The expanded message text.
OPLEN = INTEGER (Returned)
The length of the expanded message.
STATUS = INTEGER (Given and Returned)
The global status.



next up previous 211
Next: MSG_OUT - Output a message
Up: Subroutine Specifications
Previous: MSG_IFSET - Set the filter level for conditional message output

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