The MLSDISPLAY statement displays a message on the Operator Display Terminal (ODT) and prints the message in the job summary listing.
<MLSdisplay statement>
── MLSDISPLAY ── ( ──<output message array identifier>── [ ────────────► ►─┬───────────────────────────────┬─<arithmetic expression>── ] ───────► └─<language specification>── , ─┘ ►─┬──────────────────────────────┬─ ) ─────────────────────────────────┤ │ ┌◄─────────────────────────┐ │ └─┴─ , ──<parameter element>─┴─┘
MLSDISPLAY Options
The MLSDISPLAY statement displays the specified message on the ODT and prints the message between the beginning-of-task (BOT) and end-of-task (EOT) messages on the job summary listing. If the program that invokes the statement was started with either the CANDE RUN or START command, and if the MESSAGES option is currently set to TRUE for the session, the text is also displayed on the user terminal.
The output message array identifier indicates the output message array that contains the message to be displayed.
The language specification defines the language to be used for the messages displayed on the user terminal. If the specified language does not exist or if the specified message number does not exist in that language, then the error message "OUTPUT MESSAGE NUMBER <n> WAS NOT FOUND" is displayed.
The arithmetic expression indicates the message number of the output message to be displayed. It cannot be a double-precision value.
Each parameter element contains the actual value of a parameter that was specified in the declaration of the requested output message. The first parameter element refers to parameter 1, the second to parameter 2, and so on.
No more than 430 characters can be displayed.
The MLSDISPLAY statement returns a Boolean result. If an error occurred, a result of TRUE is returned. For some errors, the MLSDISPLAY statement displays text in the English language to describe the error instead of displaying the requested message.
For additional information on output messages, refer to MESSAGESEARCHER Statement.
