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:
Application programming interface: USR1026N
. See SYSEXT - Natural Application Programming
Interfaces in the Utilities documentation.
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 If application-name is
"*", the current setting of the system variable
|
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 If command-name is "*",
the current setting of the system variable |
I |
If the In a non-Security environment, if you log on from library |
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.