Using the INVOKING

Panel and function installation files can include an entry that allows the automatic integration of applications on existing panels. This entry is valid when you are adding and upgrading installation files. The INVOKING_PANEL entry can appear in the file as many times as is necessary to cause the installed application to become an option on panels.

Use INVOKING_PANEL entries to do the following:

Specify the name and language of the panel on which the application is to become an option.
Assign a selection identification to the option.
Designate the location of the option among the existing options.

The following example shows the keywords that are required when using the INVOKING_PANEL entry.

*INVOKING_PANEL    panel-name
 panel-appl-language
 selection-id
*AFTER application-name
 application-language

OR

*INVOKING_PANEL    panel-name
 panel-appl-language
 selection-id
*POSITION number

The following list describes the keywords on the INVOKING_PANEL entry:

panel-name: specifies the name of an existing panel that will include this application as an option. Because attachment is allowed only on panels, no application type is required. If you specify a panel-name that does not exist, you receive an error message.
panel-appl-language: specifies the language of the existing panel. This information is required because two panels may exist with the same names but different languages.
selection-id: specifies the selection identification for this application that will appear on the invoking panel. The placement of the option on the panel can be specified using either the *AFTER or the *POSITION keywords.
application-name/application-language: Use the *AFTER keyword to specify the name and language of an existing option on the invoking panel.
number: Use the *POSITION keyword to specify the numeric position of the application to be installed on the panel. If the *POSITION number specified is greater than the number of existing options, the application is placed at the end of the list.

Three conditions must be verified before each INVOKING_PANEL entry is successfully processed. If any of the required conditions are not satisfied, the installation proceeds but the application does not become an option on the specified invoking panel. These conditions are:

The specified invoking panel must exist on the same administration level as the administrator initiating the installation.
The selection identification must be unique on the invoking panel.
The application name and language, used with the *AFTER keyword for placement of the option, must represent an existing option on the invoking panel.

For more information about creating an installation file, see z/OS TSO/E Customization.