Processing math: 100%

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.