SETUP

SETUP [application-name] [command-name] [I]

This command is used to define applications to which control is to be returned using the RETURN command. This allows you to easily transfer from one application to another during a Natural session.

This document covers the following topics:

Syntax Explanation
SETUP/RETURN Example

Application programming interface: USR1026N. See SYSEXT - Natural Application Programming Interfaces in the Utilities documentation.

Syntax Explanation

The command syntax and the parameters that can be issued with the SETUP system command are explained below. If a parameter is to be omitted, you may use the input delimiter character to mark the beginning of the following parameter(s).

`SETUP`	If `SETUP` is issued without parameters, a menu will be displayed for the purpose of entering the command information.
`application-name`	The name of the application to which control is to be returned. A maximum of 8 characters may be used (A8). If `application-name` is blank, a `LOGON` command will not be issued. This permits multiple return points within the same application. If `application-name` is "", the current setting of the system variable `LIBRARY-ID` (that is, at the time `SETUP` is issued) is used to create the `LOGON` command when `RETURN` is issued.
`command-name`	The name of the command which is to be executed when control is returned to the application. A maximum of 60 characters may be used (A60). If `command-name` is blank, no command will be issued after the `LOGON`. This is useful for applications under Natural Security for which a startup program has already been defined. If `command-name` is "", the current setting of the system variable `STARTUP` (that is, at the time `SETUP` is issued) is used as the startup command when `RETURN` is issued.
`I`	If the `I` option is specified, all return points defined with previous `SETUP` commands will be deleted and the application specified with `SETUP I` will be defined as the new initial application. In a non-Security environment, if you log on from library `SYSTEM` to another library and no return point has been set, this other library will automatically be set as initial return point.

SETUP/RETURN Example

User starts Natural session (default application is APPL1).

Return point APPL1 is defined on Level 1.
User issues command LOGON APPL2.
User executes a program which stacks two commands (establish return point and go to another application):
```
SETUP *,MENU
LOGON APPL3
```
Return point APPL2, STARTUP MENU is defined on Level 2.
User issues command LOGON APPL4 (user selects another application).
User presses a PF key which has the setting RETURN. Natural will issue for the user:
```
LOGON APPL2
MENU
```
Return to APPL2, delete Level 2.
User executes a program which stacks:
```
SETUP *,MENU
LOGON APPL5
```
Return point APPL2, STARTUP MENU is defined on Level 2.
User executes a program which stacks:
```
SETUP *,MENU
LOGON APPL6
```
Return point APPL5, STARTUP MENU is defined on Level 3.
User executes a program which stacks:
```
SETUP *,MENU
LOGON APPL7
```
Return point APPL6, STARTUP MENU is defined on Level 4.
User executes a program which stacks:
```
SETUP *,MENU
LOGON APPL8
```
Return point APPL7, STARTUP MENU is defined on Level 5.
User executes a program which stacks:
```
SETUP *,MENU
LOGON APPL9
```
Return point APPL8, STARTUP MENU is defined on Level 6.
User issues command RETURN 2 (return two levels back).

Natural will return user to APPL7, since that was the second previous session (all information for APPL8 is now lost). Level 6 (APPL8) is deleted, Level 5 (APPL7) is activated and level deleted.
User issues command RETURN.

Level 4 (APPL6) is activated, level deleted. Natural will return user to APPL6, since that was the session previous to APPL7.
User issues command RETURN.

Level 3 (APPL5) is activated, level deleted. Natural will return user to APPL5, since that was the session previous to APPL6.
User issues command RETURN I.

Level 2 (APPL2) is deleted, Level 1 (APPL1) is activated.