Recipe Exchange Service properties

After installation, the web service properties have initial values. Leave the property values at their initial values unless you have a valid reason to change them. If you clear a property value and apply the change, the property assumes its default value. 

Note

Changing the Protection property requires that web service clients be recompiled.

Table: Recipe Exchange Web Service Initial Properties
Property Name Description Valid Values Service Restart Required?
Buffers, Timeouts, and ReaderQuotas

CloseTimeout

Specifies the time interval (days.hh:mm:ss) for a close operation to complete.

0.00:00:00 through 24 days (approximately)

Yes

InactivityTimeout

Specifies the time interval (days.hh:mm:ss) for a close operation to complete.

0.00:00:00 through 24 days (approximately)

Yes

MaxArrayLength

Specifies the maximum allowed array length.

0 through 2147483647

Yes

MaxBytesPerRead

Specifies the maximum allowed bytes returned per read

0 through 2147483647

Yes

MaxReceivedMessageAndBufferSize

Specifies the maximum size for a received message that is processed by the binding and maximum number of bytes that are used to buffer incoming messages in memory.

0 through 2147483647

Yes

MaxStringContentLength

Specifies the maximum string length returned by the reader.

0 through 2147483647

Yes

OpenTimeout

Specifies the interval of time (days.hh:mm:ss) provided for an open operation to complete.

0.00:00:00 through 24 days (approximately)

Yes

ReceiveTimeout

Specifies the interval of time (days.hh:mm:ss) provided for a receive operation to complete.

0.00:00:00 through 24 days (approximately)

Yes

SendTimeout

Specifies the interval of time (days.hh:mm:ss) provided for a send operation to complete.

0.00:00:00 through 24 days (approximately)

Yes

Logging Properties

LogDebugEntries

Specifies if the debug entries are logged

True

False

Yes

Standard Properties

Authentication

Specifies how the service enforces role-based security.

Open - No role-based security enforced 

Secured - only members of the DeltaV role can use the service.

Disabled - calls to the service throw a security exception.

Yes

BindingsEnabled

Note

This property must be True to retrieve a service description. Set this property to False after retrieving the web service description information to prevent unauthenticated access to the service.

Specifies whether metadata exchange is enabled.

You cannot query for service metadata if this is disabled.

True 

False

Yes

HttpPort

The number of the port that hosts the WSHttp binding for the service

Service clients may not be able to connect to services when pointed to the wrong port.

Yes

NetTcpPort

The number of the port that hosts the net.tcp binding for the service

Service clients may not be able to connect to services when pointed to the wrong port.

Yes

Protection

Note

Changing this property requires that web service clients be recompiled.

The message security level enforced for the service.

None - Authentication only. 

Sign - Sign data to ensure the integrity of transmitted data. 

EncryptAndSign - Encrypt and sign data to ensure the confidentiality and integrity of transmitted data.

Yes

ServiceMetricsEnabled

Specifies if performance metrics are collected for this service.

View the performance metrics from the Performance Monitor.

True - Metrics are collected

False - Metrics are not collected

Yes

Throttling Properties

MaxConcurrentCalls

The number of concurrent calls to a single service instance

Increasing concurrent calls may degrade performance. 

Yes

MaxConcurrentInstances

The maximum number of concurrent service instances

Increasing concurrent service instances may degrade performance. 

Yes

MaxConcurrentSessions

The maximum number of concurrent connections to a single service

Increasing concurrent connections may degrade performance. 

Yes