EXECUTE

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

This command is used to execute a Natural object module of type program. 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

EXECUTE Syntax Explanation

`EXECUTE`	The keyword `EXECUTE` is optional; it is sufficient to specify `program-name`, i.e. the name of the program to be executed.
`REPEAT`	If the program 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 to be executed. If you do not specify a `library-id`, Natural can only execute the specified program 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 is stored in another library, specify the `library-id` of that library. In this case, the program 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