2.2.1 Attribute Semantics

TA_INSTANCEID
Gateway instance identifier. This attribute value may contain a maximum of 12 characters (excluding the terminating NULL character). The identifier value must be unique within the SALTDEPLOY file
TA_TLOGDEVICE
One attribute "location" describes the location of the Transaction file. This is required if WS-TX transaction support is required.
TA_TLOGNAME
One attribute "id" describes the name of the transaction log inside a Transaction file. This is required if WS-TX transaction support is required.
TA_WSATENDPOINT
One attribute "address" describes the WS-AT protocol end point.
TA_MAXTRAN
One attribute "value" describes the maximum number of concurrent WS-TX transactions allowed. This is bounded by Oracle Tuxedo MAXGTT.
TA_SOCKSADDRLIST
String type containing a list of proxy server URLs. For example: proxy.server1.com,10.123.1.1:1080
TA_MAXCONTENTLENGTH
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:
Integer number in bytes. No suffix means the unit is bytes.
Float number in kilobytes. The suffix must be 'K'. For instance, 10.4K, 40K, etc.
Float number in megabytes. The suffix must be 'M'. For instance, 100M, 20.6M, etc.
TA_THREADPOOLSIZE
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.
TA_NWTIMEOUT
Specifies the network time-out value, in seconds.
TA_MAXBACKLOG
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.
TA_ENABLEMULTIENC
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.
TA_ENABLESOAPVAL
Toggles on/off XML Schema validation for inbound SOAP request messages if the corresponding Tuxedo input buffer is associated with a customized XML Schema.
TA_PRIVATEKEY
Oracle SALT does not have the concept of a security principal name like Oracle Tuxedo does, so the Wallet is located in the specified directory and not in a sub-directory. When using an Oracle wallet, specifies the location of a directory that contains an Oracle Wallet.

This element is mandatory if the parent ;Certificate; element is configured.

Note:

To configure server identity certificates (SALT deploy configuration file <PrivateKey> element), it is required that the root certificate authority be present in the SSL configuration file. Proper configuration is:

root CA certificate

intermediate certificate(s) (if any)

server certificate

server private key

in PEM format.

When using the legacy security credentials format, specifies the PEM format private key file. The key file path is specified as the text value for this element. The server certificate is also stored in this private key file. The value of this element may contain a maximum of 256 characters (excluding the terminating NULL character).

With either security credential format, the password for the Oracle Wallet or the GWWS private key file is specified in the TUXCONFIG file using the SEC_PRINCIPAL_PASSVAR= environment_variable_name" parameter. The TUXCONFIG file must also set the SEC_PRINCIPAL_NAME= any_non-null_string(not_used) parameter so that SEC_PRINCIPAL_PASSVAR will be properly processed in the configuration file.

TA_VERIFYCLIENT
Optional.
Specifies if Web service clients are required to send a certificate via HTTP over SSL connections. The valid element values are "true" and "false".
TA_TRUSTEDCERT
Optional.
Specifies the file name of the trusted PEM format certificate files. The value of this element may contain a maximum of 256 characters (excluding the terminating NULL character).
TA_CERTPATH
Specifies the local directory where the trusted certificates are located. The value of this element may contain a maximum of 256 characters (excluding the terminating NULL character).
This element is optional.

Note:

If TA_VERIFYCLIENT is set to "true", or if WS-Addressing is used with SSL, trusted certificates must be stored in the directory setting with this element.
TA_PLUGINLIBRARIES
Comma-separated list of local shared library file paths.
TA_PLUGINPARAMS
Comma-separated list specifying string values that are passed to the library when initialized by the GWWS server at boot time.
Each item in the list is passed in order to the corresponding item in the TA_PLUGINLIBRARIES attribute.

Note:

The statistics fields below may not be present if no corresponding action has been performed. For example if no one-way call has been made T_WS_ONEWAYDONE will not be returned.
TA_WS_REQREPDONE
Number of inbound request-reply calls performed.
TA_WS_REQREPFAIL
Number of inbound failed request-reply calls.
TA_WS_ONEWAYDONE
Number of inbound one-way calls performed.
TA_WS_ONEWAYFAIL
Number of inbound failed one-way calls.
TA_WS_OUTBOUNDDONE
Number of outbound request-reply calls performed.
TA_WS_OUTBOUNDFAIL
Number of outbound failed request-reply calls.
TA_WS_OUTBOUND_ONEWAYDONE
Number of outbound one-way calls performed.
TA_WS_OUTBOUND_ONEWAYFAIL
Number of outbound failed one-way calls.
TA_WS_INBOUNTIME
Average processing time of inbound calls.
TA_WS_OUTBOUNTIME
Average processing time of outbound calls.
TA_WS_THREADS
Number of active threads.
TA_WS_TOTALPENDING
Total average processing time across all SOAP services.
TA_RESTINBOUNDDONE
Number of successful inbound REST calls.
TA_RESTINBOUNDFAIL
Number of failed outbound REST calls.
TA_RESTINBOUNDTIME
Total average processing time for inbound REST calls.
TA_RESTOUTBOUNDDONE
Number of successful inbound REST calls.
TA_RESTOUTBOUNDFAIL
Number of failed outbound REST calls.
TA_RESTOUTBOUNDTIME
Total average processing time for inbound REST calls.
Limitations
None