Web Services Point Manager Parameters

The Platform Services Configuration utility allows changes to advanced runtime parameters for the Web Services runtime.

 

Advanced Runtime Parameters for Web Services Runtime

 

The parameter list shown in the utility may not necessarily contain all the possible parameters. Parameters that are not in the list can be manually added to the FwxServers.PointManagers.config file and then modified using the form displayed above.

 

The following table contains the complete list of available parameters and their effect on the Web Services runtime. Please note that changes to any of these parameters requires restarting the ICONICS Web Services Point Manager service.

 

Parameter Name

Default Value

Description

CacheMaxSizeItems

400

Defines how the maximum number of items (individual results from calls to web methods) to keep in the Web Services runtime cache. If the cache is full, existing results are evicted from the cache by LRU (Least Recently Used).

ItemCacheSlidingExpirationMins

10

Defines a sliding window of inactivity.  If a cached result is not accessed in inactivity window, it will be dropped from the cache.

SupportedSecurityProtocols

Tls12

Defines all the security protocols that can be used by the Web Services runtime when connecting to services. The possible values (case sensitive) are:

 

Tls12

Tls11

Tls

Ssl3

 

Which correspond to:

 

TLS 1.2

TLS 1.1

TLS 1.0

SSL3

 

Protocols must be enabled individually. To enable more than one protocol at the time, use comma to separate the values. For example:

Tls12,Tls11

 

For security reasons, it is recommended to use the default value of Tls12 and only enable other security protocols if strictly necessary.

OperationRetryIntervalMsec

1000

Defines the delay after which to retry a call if the previous call to a web method completed in error.

 

The Web Service runtime uses exponential backoff by doubling this delay for each retry, up to the maximum number of retries configured by OperationRetryCount.

OperationRetryCount

5

Defines how many times to retry a call to a web method when the call fails.

GCCollectScheduleMinutesAfterMidnight

-1

Instructs the server to manually run a forced Garbage Collection with Large Object Heap compaction. When set to a negative value (default) this feature is disabled. A value greater than or equal to 0 specifies the number of minutes after local midnight to wait before scheduling the garbage collection.

IgnoreCertificateErrors

False

Instructs the server to ignore any certificate error. This setting applies to all services configured.

 

For security reasons, it is highly recommended to leave this value to the default of False.

EnableArraySubscription

False

When true, exposes single column datasets as FrameWorX arrays.

EnableInlineDataManipulatorParameters

True

When true, automatically adds parameters to the data manipulator tags browsed via the Unified Data Browser.

EnableErrorDetailsDiagnosticPoints

False

When true, the @@LastError point will be available in runtime under the @@Diagnostics folder.