Controlling Execution Controlling Execution

The user also has the ability to control the various parameters which effect the execution of MOSES and the various files which will be used. Perhaps the most useful of these commands is:


     &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

     -CLIENT, Name on Top of Page

     -FN_LOWER, YES/NO

     -COMIN, FILE_NAME

     -ICOMIN, FILE_NAME

     -AUXIN, FILE_NAME

     -IAUXIN, FILE_NAME

     -LICENSE, LICENSE_LEVEL

     -PROJ_ID, CONNECT_PROJECT

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. Finally the -CLIENT option is used to define the name which will be printed at the top of each page of output.

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 next 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.

The -LICENSE option allows Bentley SELECT Licensing users to set the desired MOSES license suite for the current run of MOSES only. Here LICENSE_LEVEL must be either AUTOMATIC, STANDARD, ADVANCED or ENTERPRISE. If set to AUTOMATIC the lowest required license level will be used. When a command requiring a higher license level is issued the license level will be automatically elevated. Upon elevation a notification will be printed to the log window followed by a warning that the elevated license will log usage against the higher license level. If at any stage the required license is not available then MOSES may terminate.

The default license setting is read from the .moses.ini file (located in the users's home directory) at startup using the variable LICENSE which can be AUTOMATIC, STANDARD, ADVANCED or ENTERPRISE. If the user owns a single license of MOSES, for example just MOSES Advanced, then the variable LICENSE should be set to ADVANCED in the .moses.ini file. Note that if STANDARD or ADVANCED are specified, then MOSES Enterprise features will not be available (Jacket Launch, Generalized Degrees of Freedom). If the user owns multiple license levels then AUTOMATIC may be more appropriate. The default license setting can be modified using the preferences dialog or by editing the .moses.ini file directly (a restart of MOSES is required for the change to be effected).

Finally, the -PROJ_ID option allows the Bentley CONNECT Project identification code to be read by the MOSES Solver. Users should not need to modify this option and the unique project identifier as this is handled by the CONNECTION Client.