Message Commands - Ultramarine.com Message Commands

MOSES allows the user to issue messages to both the "output" and "command" channels via internal commands. For the output channel, the messages are limited to two title lines of data which are printed at the top of each page of output. These can be defined via:


     &TITLE, MAIN_TITLE

     &SUBTITLE,  SUBTITLE

Here, MAIN_TITLE is used for the first title line, and SUBTITLE is used for the second title line.

To issue messages to the command channel, one uses the commands:


     &TYPE, MESSAGE

     &CTYPE, MESSAGE

     &CUTYPE, MESSAGE

These commands will write "MESSAGE" to the terminal whenever they are executed. The difference between the commands is that the &TYPE command left justifies the output line, while the other two center the line on the screen. The &CUTYPE command not only centers the line, but also underlines it.

If one is writing macros, it is often necessary to report to the user an error or warning. This is accomplished with the command:


     &ERROR, CLASS ,MESSAGE

Here, CLASS is the class of warning and can be either WARNING, ERROR, or FATAL, and MESSAGE is the message you wish to have printed along with the class. If CLASS is FATAL then the program will terminate after printing the message.

In addition, there is a menu which can be used to define reports:


     &REPORT, HEAD(1), HEAD(2) -OPTIONS

and the available options are


     -HARD

     -BOTH

The report generated will have a primary heading of HEAD(1) and a secondary heading of HEAD(2). If no options are specified, it will be written to the terminal. If -HARD is specified, it will be written to the output file, and if -BOTH then it will be written to both devices. The menu is exited with an END_REPORT command.

Inside this menu, the commands


     TYPE, MESSAGE

     CTYPE, MESSAGE

     CUTYPE, MESSAGE

are available. These commands are exactly the same as those discussed above.