&DEVICE, -OPTIONS

and the available options are

     -BATCH, YES/NO

     -LIMERROR, ERLIM

     -US_DATE, YES/NO

     -SET_DATE, DATE

     -CONT_ENTRY, The Entry You Want

     -NAME_FIGURE, NAME

     -FIG_NUM, YES/NO, NUMBER

     -G_DEFAULT, GLDEVICE

     -OECHO, YES/NO

     -MECHO, YES/NO

     -IDISPLAY, YES/NO

     -SILENT, YES/NO

     -FN_LOWER, YES/NO

     -COMIN, FILE_NAME

     -ICOMIN, FILE_NAME

     -AUXIN, FILE_NAME

     -IAUXIN, FILE_NAME

These options can be roughly divided into several classes. The -BATCH option defines when the program will terminate abnormally. Here, YES/NO should be YES if one wishes to set the mode to batch, and NO if one wishes the execution mode to be interactive. The -LIMERROR option defines the error limit. If the program is in the "interactive" mode, it will terminate when the error limit, ERLIM, is reached. This limit is defined by the -LIMERROR option. In the "batch" mode, MOSES will terminate when any error is encountered.

The next set of options define the way dates and figures are printed. The -US_DATE controls the style of the date which will be printed on the output reports. If YES/NO is YES, the date will be the month, followed by the day, followed by the year. If YES/NO is NO, then the day will be printed first, followed by the month, followed by the year. The -SET_DATE options allows one to actually set the date string to the string which follows. The -CONT_ENTRY option allows one to define the next entry which will be added to the table of contents. If the string following the option key word is blank, then MOSES will revert to the default behavior. The -NAME_FIGURE option allows one to define the string which will be put on graphics along with a figure number. The default here is "FIGURE". The -FIG_NUM option instructs MOSES whether or not to put figure numbers on plots, and perhaps what number to use. If YES/NO is YES, then "Figure XX" will be placed in the lower left corner of all plots not directed to the screen. Here, XX is a number which will be 1 for the first plot, 2 for the second, etc. If YES/NO is NO, no figure numbers will be plotted. If "NUMBER" is specified, then the next figure plotted will have the number specified.

The next option is used to alter the destination of graphic output. There are two places where graphics can be deposited: the primary place and the secondary one. When a PICTURE or PLOT command is issued, the results are automatically written to the primary place and when a SAVE is issued, the results are written to the secondary place. The -G_DEFAULT option defines the default logical device for graphics. Here GLDEVICE must be either SCREEN, or FILE, which will define either the SCREEN, or GRA_DEVICE logical device to be the device where default graphics is written.

The next class of options controls the type of output which is received. The -OECHO option is used to control the listing of output. If the YES/NO following this option is YES, then each record from the input file is written to the output file as the record is read. Conversely, if YES/NO is NO, the echo will not occur. The -MECHO option will instruct MOSES to echo commands which are being executed as part of a macro to be echoed to either the terminal (and therefore the log file), or to the output file. Macros being used in the input data will be echoed in the output file if the -OECHO YES/NO is YES. The options -IDISPLAY, and -SILENT control the default displays. The option -IDISPLAY controls whether or not the valid internal commands will be displayed whenever valid commands are listed. The -SILENT option suppresses most of the terminal output, and is useful in macros. For all of these options, the action will be taken if YES/NO is YES, and not if YES/NO is NO.

The -FN_LOWER option controls the way MOSES looks at the directory structure. If YES/NO is NO then the directory structure is viewed as case sensitive. In some operating systems it really does not matter even if then results appear in upper and lower case. In other words a file COW.TXT is a different file from cow.txt. One may not want this behavior (transferring files from a WINDOWS machine to a UNIX one for example). In this case one can use the option with a YES/NO of YES. Now the complete path of the file will be treated as being lower case.

The final class of options controls where the program obtains its information. In general, commands enter through the "command channel", TERM, and data enters through the "input channel", INPUT. With the -COMIN option MOSES gets command data from the file, FILE_NAME, until either an end of file is encountered, MOSES finishes, or another -COMIN command is specified. The -AUXIN option functions as the -COMIN option except that it redirects the flow of information on the INPUT channel. With both of these options, if FILE_NAME is &E then MOSES returns to the default channel. With these two options, a fatal error occurs if the file specified does not exist. If one does not desire an error if the file does not exist, then he can use either -ICOMIN or -IAUXIN. With these two options, the command is simply ignored if the files fail to exist. In some cases, one does not know whether he wishes to redirect the input or the command channels, but instead he wishes to redirect the "current" channel. This can be accomplished by using the command:

     &INSERT, FILE_NAME

Here, the current information channel will obtain its data from the file FILE_NAME as discussed above.