# Run command

The `Run` command redirects `ij` processing to read from a specified file.

The command assumes that the value of the specified String is a valid file name. It reads from that file until it ends or an `Exit` command is executed. If the end of the file is reached without `ij` exiting, reading will continue from the previous input source once the end of the file is reached. Files can contain additional `Run` commands.

`ij` prints out the statements in the file as it executes them.

Any changes made to the `ij` environment by the file are visible in the environment when processing resumes.

## Syntax

    RUN String

## Example

    ij> run 'setupMenuConn.ij';
    ij> -- this is setupMenuConn.ij
    -- ij displays its contents as it processes file
    ij> connect 'jdbc:derby:menuDB';
    ij> autocommit off;
    ij> -- this is the end of setupMenuConn.ij
    -- there is now a connection to menuDB and no autocommit.
    -- input will now resume from the previous source.
    ;
    ij>

Parent topic: ij commands and errors reference
Related concepts
ij commands
ij errors
Related reference
Absolute command
After Last command
Async command
Autocommit command
Before First command
Close command
Commit command
Connect command
Describe command
Disconnect command
Driver command
Elapsedtime command
Execute command
Exit command
First command
Get Cursor command
Get Scroll Insensitive Cursor command
Help command
HoldForConnection command
Last command
LocalizedDisplay command
MaximumDisplayWidth command
Next command
NoHoldForConnection command
Prepare command
Previous command
Protocol command
Readonly command
Relative command
Remove command
Rollback command
Set Connection command
Show command
Wait For command
Syntax for comments in ij commands
Syntax for identifiers in ij commands
Syntax for strings in ij commands