EXECUTION (for an application)

This EXECUTION element sets the runtime environment for an application by specifying parameters for executing it.

It is defined by referencing in its Using attribute a predefined WEB_APPLICATION_EXECUTION_COMPONENT to inherit runtime environment settings, and/or by setting individual execution elements specific to the application.

When settings are inherited from a WEB_APPLICATION_EXECUTION_COMPONENT, settings you define locally within the EXECUTION element override the component settings.

Syntax

<EXECUTION [Using="web_application_execution_component_id" ] 
   [ AllowUrlParameters="[TRUE|FALSE]" ] [ AllowUnsafeSession="[TRUE|FALSE]"] >
  [<ENVIRONMENT_VARIABLE Id="envId">env</ENVIRONMENT_VARIABLE>][...]
  [<PATH>path</PATH>] 
  [<DVM>dvm</DVM>] 
  [<MODULE>module</MODULE>]
  [<PARAMETERS>...</PARAMETERS>]
  [<ACCESS_CONTROL>...</ACCESS_CONTROL>]
  [<DELEGATE>...</DELEGATE>]
  [<WEB_COMPONENT_DIRECTORY>webComponent[;...]</WEB_COMPONENT_DIRECTORY>]
</EXECUTION>

Syntax notes

Attributes for this element include:
  1. Using - References an execution component identified by its Id attribute.
  2. AllowUrlParameters - Defines whether parameters set in the application URL at the command line should be ignored ("FALSE", default value) or provided to the DVM ("TRUE").
  3. AllowUnsafeSession - Defines whether safe session management is active ("FALSE", default value) or deactivated ("TRUE"). Safe session management is a transparent session check based on session cookies, to secure the application session tracking. You should deactivate (set to "TRUE") only if you encounter issues when migrating to version 2.50.20 or greater.

Child elements

Important: Element order. If child elements are present, they must be set in the order listed or as shown.
All child elements are optional and are passed as parameters to the REST service if present. See How to implement delegation.

When working with a single sign-on solution, child elements of the DELEGATE element will be specific to the identity provider (IdP). You will need to add the appropriate tags to work with your IdP. These tags are documented by your IdP.

The EXECUTION element may contain the following child elements:

  1. Zero to many ENVIRONMENT_VARIABLE elements.
  2. Zero or one PATH element.
  3. Zero or one DVM element.
  4. Zero or one MODULE element.
  5. Zero or one PARAMETERS element.
  6. Zero or one ACCESS_CONTROL element.
  7. Zero or one DELEGATE element.
  8. Zero or one WEB_COMPONENT_DIRECTORY element.

For more information on defining execution components, see Web Application Execution Component and Service Application Execution Component.

Usage examples

<EXECUTION Using="cpn.wa.execution.local" />
<EXECUTION Using="cpn.wa.execution.local">
  <ENVIRONMENT_VARIABLE Id="FGLGUI">1</ENVIRONMENT_VARIABLE>
</EXECUTION>
<EXECUTION AllowUrlParameters="TRUE">
  <PATH>/home/examples/BuiltIn/Arguments</PATH>
</EXECUTION>

Parent elements

This element is a child of the APPLICATION (for an application) element.