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>
- ForwardOptionsRequest attribute takes a boolean. If set to
TRUE
or not present (default), HTTP requests with the verbOPTIONS
will be forwarded to the 4GL service. If set toFALSE
, HTTP requests with verbOPTIONS
will be replied to by the dispatcher and not forwarded to the 4GL service. - 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:
- Zero or one DOCROOT element.
- Zero or more ENVIRONMENT_VARIABLE elements.
- Zero or one PATH element.
- Zero or one DVM element.
- Zero or one MODULE element.
- Zero or one PARAMETERS element.
- Zero or one ACCESS_CONTROL element.
- Zero or one DELEGATE element.
- Zero or one POOL element.
- 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) .