3.3.3.2.1.7.1 Property

Specifies one GWWS property.

Table 3-13 GWWS Property Attributes

Attribute Description Required
name Specifies the property name. Table B‑14 lists all the GWWS server properties. Yes
value Specifies the property value. Yes

Table 3-14 GWWS Property List

Property Description Values
jwtConfigFileLoc Enables customization of response messages upon JWT authentication failures and facilitates handling of additional JWT error codes. The path to SALT JWT Configuration location.
max_content_length Enables the GWWS server to deny the HTTP requests when the content length is larger than the property setting. If not specified, the GWWS server does not check for it. The string value can be one of the following three formats:
  1. Integer number in bytes. No suffix means the unit is bytes.
  2. Float number in kilobytes. The suffix must be ‘K’. For instance, 10.4K, 40K, etc.
  3. Float number in megabytes. The suffix must be ‘M’. For instance, 100M, 20.6M, etc.
The equivalent byte size value must be in [1 byte, 1G byte] range.
thread_pool_size Specifies the maximum thread pool size for the GWWS server.

Note:

This value defines the maximum possible threads that may be spawned in the GWWS server. When the GWWS server is running, the actual spawned threads may be less than this value.
The valid value is in [1, 1024].

Default value: 16

timeout Specifies the network time-out value, in seconds. The valid value is in [1, 65535]

Default value: 300

max_backlog Specifies the backlog listen socket value. It controls the maximum queue length of pending connections by operating system. Note: Generally no tuning is needed for this value. The valid value is [1-255].

Default value: 16

enableMultiEncoding Toggles on/off multiple encoding message support for the GWWS server. If multiple encoding support property is turned off, only UTF-8 HTTP / SOAP messages can be accepted by the GWWS server. The valid values are “true”, “false”.
enableSOAPValidation Toggles on/off XML Schema validation for inbound SOAP request messages if the corresponding Tuxedo input buffer is associated with a customized XML Schema. The valid values are “true”, “false”.

Default value: false

internalEncoding Mutually exclusive with enableMultiEncoding.

Allows one-byte encodings such as the ISO-8859 series to map to non-MBSTRING types.

When it is set to a value other than "keepSame", SALT converts text in payloads to/from the specified encoding between the Tuxedo side (encoding translated based on the value of internalEncoding attribute) and the network side (SOAP or REST).

This property must not be used with multi-byte encodings and in conjunction with MBSTRING buffers or fields; otherwise, a runtime error is thrown.

The valid values are "keepSame", one-byte encoding name such as the ISO-8859.
wsrm_acktime Specify the Reliable Messaging Acknowledgment message reply policy. GWWS servers support replying acknowledgment messages either after receiving the SOAP request from network immediately or after the Oracle Tuxedo service returns the response message. The valid values are “NETRECV”, “RPLYRECV

Default value: “NETRECV”
enableCustomHTTPHeaders Enable support for WEB WRITE/READ HTTPHEADER, interoperate with servers or clients that use HTTP headers to transmit data. The valid values are “true” and “false”.

Default value: false
enableHTTPRequestLine Description: Enable support for WEB READNEXT FORMFIELD, WEB EXTRACT HTTPMETHOD /QUERYSTRING/...If its value set to "true", GWWS will add the Request-Line and URL-Protocol to request buffer Meta TCM. The valid values are “true”, “false”. Default value: false
enableTPurcode By default, this property is set to 'true' to enable tpurcode return HTTP error status for inbound SOAP cases. Set this property to 'false' will prevent tpurcode from returning any HTTP status. Set this property to 'outbound_rest' will enable tpurcode to return any HTTP status in outbound REST cases. Set this property to 'all' will enable the default behavior('true') and 'outbound_rest' behavior. The valid values are "false", "true", "outbound_rest", "all" Default value: "true"
propagateECID Toggles on/off ECID propagation support for the GWWS server. If propagate ECID support property is turned off, GWWS server will not propagate ECID. The valid values are “true”, “false”. Default value: "true"
tuxedo_timeout This property can be set to the maximum number of seconds that is allowed when an inbound request invokes a Tuxedo service. When invoking the Tuxedo service, the timeout will be the lesser of the tuxedo_timeout and any service level blocktime that is specified for the service. The valid values are are from 0 to 65535. A value of 0 indicates that there is no Tuxedo timeout.

The default value is 0.