EXECUTE

#### Search Results

Search

# EXECUTE

| `EXECUTE` | [`REPEAT`] |  | program-name |  | [library-id] |
program-name [parameter ...]

This command is used to execute a Natural object module of type program or of type dialog. The object module must have been cataloged (that is, stored in object form) in the Natural system file or linked to the Natural nucleus. The execution of an object module does not affect the source code currently in the editor work area.

This document covers the following topics:

- EXECUTE Syntax Explanation

- Examples of EXECUTE Command

See also Executing Objects in Using Natural Studio.

## EXECUTE Syntax Explanation

`EXECUTE` | The keyword `EXECUTE` is optional; it is sufficient to specify program-name, i.e. the name of the program or dialog to be executed.
`REPEAT` | If the program or dialog being executed produces multiple screen output and you wish the screens to be output one after another without intervening prompts, you specify the keyword `REPEAT` together with the keyword `EXECUTE`.
`program-name` | The name of the program or dialog to be executed. If you do not specify a library-id, Natural can only execute the specified program or dialog if it is stored either in your current library or in the current steplib library (the default steplib is `SYSTEM`).
`library-id` | If the program or dialog is stored in another library, specify the library-id of that library. In this case, the program or dialog can only be executed if it is actually stored in the specified library. A library-id that begins with `SYS` must not be specified (except `SYSTEM`).
`parameter` | When you execute a program by specifying the program name without the keyword `EXECUTE`, you may pass parameters to the program. These parameters will be read by the first `INPUT` statement in the executed program. You can specify the parameters as positional parameters or as keyword parameters, with the individual specifications separated from one another by blanks or the input delimiter character (as specified with the session parameter `ID`). Note If one of the parameters passed contains blanks or is a string which contains blanks, the transfer will only be executed if directly after the program name an input delimiter is set.

## Examples of EXECUTE Command

    EXECUTE PROG1

    EXECUTE PROG1 ULIB1

    PROG1

    PROG1 VALUE1 VALUE2 VALUE3

    PROG1 VALUE1, VALUE2, VALUE3

    PROG1 PARM1=VALUE1, PARM2=VALUE2, PARM3=VALUE3

    PROG1 PARM3=VALUE3 PARM1=VALUE1 VALUE2

    PROG1,ab cd ef,gh,de fg,ab

### On this page

- EXECUTE Syntax Explanation
- Examples of EXECUTE Command