next up previous 204
Next: EMS_RENEW - Renew any annulled message tokens in the current context
Up: Fortran Subroutine Specifications
Previous: EMS_MARK - Start a new error context


EMS_MLOAD - (Deprecated) 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 status argument is not set to SAI__OK on entry, no action is taken except that the values of any existing message tokens are always left undefined after a call to EMS_MLOAD. If the expanded message is longer than the declared length of the supplied character variable, the message is terminated with an ellipsis.

Invocation:
CALL EMS_MLOAD( PARAM, MSG, OPSTR, OPLEN, STATUS )

Arguments:

PARAM = CHARACTER * ( * ) (Given)
The message name.
MSG = 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)
The global status.

Notes:
This routine is now deprecated as the PARAM argument is redundant and the C interface gives no limit for the expanded string size. EMS_EXPND should be used instead.


next up previous 204
Next: EMS_RENEW - Renew any annulled message tokens in the current context
Up: Fortran Subroutine Specifications
Previous: EMS_MARK - Start a new error context

EMS Error Message Service
Starlink System Note 4
P C T Rees
A J Chipperfield
28 September 2001
E-mail:ussc@star.rl.ac.uk

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