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:

See also Executing Objects in Using Natural Studio.

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