# Run command

#### Syntax

    RUN String

#### Description

Assumes that the value of the string is a valid file name, and redirects `ij` processing to read 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 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.

#### 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
Last command
LocalizedDisplay command
MaximumDisplayWidth command
Next 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