EXECUTION (for service)

This EXECUTION element sets the runtime environment for a web service application by specifying parameters for its execution.

Syntax

<EXECUTION [ ForwardOptionsRequest={"TRUE"|"FALSE"} ]
           [ Using=service-component-id ]>
   [<DOCROOT>...</DOCROOT>]
   [<ENVIRONMENT_VARIABLE>...</ENVIRONMENT_VARIABLE>][...]
   [<PATH>...</PATH>]
   [<DVM>...</DVM>]
   [<MODULE></MODULE>]
   [<PARAMETERS>...</PARAMETERS>]
   [<ACCESS_CONTROL>...</ACCESS_CONTROL>]
   [<DELEGATE>...</DELEGATE>]
   [<POOL>...</POOL>]
   [<DELEGATE_OPTIONS>...</DELEGATE_OPTIONS>]
</EXECUTION>
  1. ForwardOptionsRequest attribute takes a boolean. If set to TRUE or not present (default), HTTP requests with the verb OPTIONS will be forwarded to the 4GL service. If set to FALSE, HTTP requests with verb OPTIONS will be replied to by the dispatcher and not forwarded to the 4GL service.
  2. The Using attribute references an execution component, service-component-id, to inherit its parameters. For example, SERVICE_APPLICATION_EXECUTION_COMPONENT

Child elements

Possible execution elements include:

  1. Zero or one DOCROOT element.
  2. Zero or more ENVIRONMENT_VARIABLE elements.
  3. Zero or one PATH element.
  4. Zero or one DVM element.
  5. Zero or one MODULE element.
  6. Zero or one PARAMETERS element.
  7. Zero or one ACCESS_CONTROL element.
  8. Zero or one DELEGATE element.
  9. Zero or one POOL element.
  10. Zero or one DELEGATE_OPTIONS (for a service) element.

Usage

You use this element to set the runtime environment for a web service application by specifying parameters for executing it. Execution settings may be defined by referencing a SERVICE_APPLICATION_EXECUTION_COMPONENT element in its Using attribute, and/or by setting individual execution elements specific to the application.

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

Usage examples referencing components

<EXECUTION Using="cpn.ws.execution.local" />
<EXECUTION Using="cpn.ws.execution.local">
  <ENVIRONMENT_VARIABLE Id="FGLGUI>1</ENVIRONMENT_VARIABLE>
</EXECUTION>

Usage examples using ForwardOptionsRequest

<APPLICATION Parent="ws.default"
   xmlns:xsi="<http://www.w3.org/2001/XMLSchema-instance>"
   xsi:noNamespaceSchemaLocation="<https://4js.com/ns/gas/5.01/cfextws.xsd>">
  <EXECUTION ForwardOptionsRequest = "TRUE">
    <PATH>$(user.service.path)/wsecho</PATH>
    <MODULE>wsecho.42m</MODULE>
  </EXECUTION>
  <HTTP>
    <HEADER Method="OPTIONS" Name="Access-Control-Allow-Origin"><https://foo.example</HEADER>>
  </HTTP>
</APPLICATION>

Parent elements

This element is a child of APPLICATION (for a service) .