drun

Starts or restarts processes

Format:

drun [ cmd_arguments ] [ in_operation infile ]
    [ out_operations outfile ]
    [ error_operations errfile ]

Arguments:

cmd_arguments

The argument list passed to the process.

operations

The in_operation, out_operations, and error_operations are discussed in the Description section.

infile

If specified, indicates a file from which the launched processes will read information.

outfile

If specified, indicates the file into which the launched processes will write information.

errfile

If specified, indicates the file into which the launched processes will write error information.

Description:

The drun command launches each process in the current focus and starts it running. The command arguments are passed to the processes, and I/O redirection for the program, if specified, will occur. Later in the session, you can use the drerun command to restart the program.

The arguments to this command are similar to the arguments used in the Bourne shell.

The in_operation is as follows:

< infile

Reads from infile instead of stdin.

The out_operations are as follows:

> outfile

Sends output to outfile instead of stdout.

>& outfile

Sends output and error messages to outfile instead of stdout and stderr.

>>& outfile

Appends output and error messages to outfile.

>> outfile

Appends output to outfile.

The error_operations are:

2> errfile

Sends error messages to errfile instead of stderr.

2>>errfile

Appends error messages to errfile.

In addition, the CLI uses the following state variables to hold the default argument list for each process.

ARGS_DEFAULT

The CLI sets this variable if you use the -a command-line option when you started the CLI or TotalView. (This option passes command-line arguments that TotalView will use when it invokes a process.) This variable holds the default arguments that TotalView passes to a process when the process has no default arguments of its own.

ARGS(n)

An array variable containing the command-line arguments. The index n is the process ID n. This variable holds a process's default arguments. It is always set by the drun command, and it is also contains any arguments you used when executing a drerun command.

If more than one process is launched with a single drun command, each receives the same command-line arguments.

In addition to setting these variables by using the -a command-line option or specifying cmd_arguments when you use this or the drerun command, you can modify these variables directly with the dset and dunset commands.

You can only use this command to tell TotalView that it should execute initial processes because TotalView cannot directly run processes that your program spawns. When you enter this command, initial process must be have terminated; if it was not terminated, you are told to kill it and retry. (You can, of course, use the drerun command.)

The first time you use the drun command, TotalView copies arguments to program variables. It also sets up any requested I/O redirection. If you reenter this command for processes that TotalVIew previously started--or issued for the first time for a process that was attached to using the dattach command--the CLI reinitializes your program.

Issues When Using IBM's poe

Both poe and the CLI can interfere with one another because each believes that it owns stdin. Because poe is trying to manage stdin on behalf of your processes, it continually reads from stdin, acquiring all characters that it sees. This means that the CLI will never see these characters. If your target process does not use stdin, you can use the -stdinmode none option. Unfortunately, this option is incompatible with poe's -cmdfile option that is used when specifying -pgmmodel mpmd.

If you encounter these problems, you should redirect stdin within the CLI. For example:

drun < in.txt

Command alias:

You may find the following alias useful:

Alias	Definition	Meaning
r	{drun}	Starts or restarts processes.

Examples:

drun

Tells the CLI to begin executing processes represented in the current focus.

f {p2 p3} drun

Begins execution of processes 2 and 3.

f 4.2 r

Begins execution of process 4. Note that this is the same as f 4 drun.

dfocus a drun

Restarts execution of all processes known to the CLI. If they were not previously killed, you are told to use the dkill command and then try again.

drun < in.txt

Restarts execution of all processes in the current focus, setting them up to get standard input from file in.txt.