Execution

The MAPGEN program may normally be run from any EGRET cluster directory in a windowing environment. The user should type:

mapgen

This command assumes the most normal situation where the output report goes to the screen, the program runs in foreground and the path is properly set. The program may also be run under a number of other options as listed

below.

Running the program in background

mapgen &

Routing the program report to a file

mapgen > filename

Routing the program report to a file even if the file exists

mapgen >! filename

Running the program if the path isn't set

/analysis/bin/mapgen

Running the program under a lower priority

nice +priority mapgen

Changing the programs' priority

renice priority processid

Changing the priority is not crucial in the case of MAPGEN because the program usually runs in a short time and does not use excessive amounts of memory. To get the program's process id, the user should use the top or ps -aux command. Zero is the highest priority and 20 the

lowest.

Suspending execution

^z

Resuming execution

%

Aborting

^c

Another program feature is the ability to bypass the input phase which is useful when a windowing environment is not accessible. To do that, the user should edit an existing namelist file (namelist.map) and put it in the current directory. Then the command mapgen.exe should be executed. However, this has to be done with great care since all the error checking from the windows won't apply and the user must know the meaning of the namelist variables. It is therefore not the recommended way to execute the program.