|
Property label
|
Property name
|
Default value
|
Description
|
|
Stale object timeout
|
stale04GLObject Timeout
|
0
|
The maximum duration (in seconds) that a service object (AppObject, SubAppObject, or ProcObject) can be idle before it is released.
As part of managing certain service objects with OpenEdge, clients explicitly create them using factory methods before invoking other methods on them. When the client no longer requires the object, it has the responsibility to release the object from the service runtime context. However, if this time-out expires before the client releases the object, the OpenEdge Adapter assumes that the client application no longer requires access to the object, and deletes it from the service run-time context automatically. In effect, the adapter uses this time-out to provide garbage collection on service objects that client applications stop referencing and fail to release in the specified period of time. Any subsequent attempt by a client to access this object returns an error from the adapter.
|
|
Request wait timeout
|
requestWait Timeout
|
-1
|
Determines how the adapter handles requests when the service connection pool is full. The connection pool is full when the number of active sessions is equal to the value of the maxSessions property and all sessions are currently running requests.
 For value equal to -1, the OpenEdge adapter queues the request indefinitely till an AppServer session is available.
For value equal to 0, the OpenEdge adapter rejects the request and returns an error message to the client indicating that there are too many concurrent requests.
For value greater than 0, the OpenEdge adapter queues the request for the maximum number of seconds specified by the value till an AppServer session is available. If no session is made available in that time, the adapter returns an error to the client.
|
|
NameServer client min port
|
nsClientMinPort
|
0
|
The minimum value for the adapter to specify for the UDP port number used to communicate with the NameServer. The value must be less than or equal to the value of the nsClientMaxPort property. For value equal to 0, the OpenEdge adapter chooses the NameServer client port number randomly. This property applies only to services that use a NameServer to access application services (an AppServer).
|
|
NameServer client max port
|
nsClientMaxPort
|
0
|
The maximum value for the adapter to specify for the UDP port number used to communicate with the NameServer. The value must be less than or equal to the value of the nsClientMaxPort property. For value equal to 0, the OpenEdge adapter chooses the NameServer client port number randomly. This property applies only to services that use a NameServer to access application services (an AppServer).
|
|
NameServer client port retry
|
nsClientPortRetry
|
3
|
The maximum number of requests that the adapter makes for a valid local UDP port number when attempting to communicate with the NameServer. This property applies only to services that use a NameServer to access application services (an AppServer).
|
|
NameServer client port retry interval
|
nsClientPortRetry Interval
|
200
|
The interval (in milliseconds) that the adapters waits between requests to get a valid UDP port number when attempting to communicate with the NameServer. This property applies only to services that use a NameServer to access application services (an AppServer).
|
|
Service logging level
|
serviceLogging Level
|
2
|
The amount and type of information written by the adapter to the service log for each log entry. Logging levels range from 1 to 4.
For logging level equal to 1, the OpenEdge adapter logs the errors internally detected by the adapter only.
For logging level equal to 2, the OpenEdge adapter logs additional errors that result in SOAP faults returned to the client.
For logging level equal to 3, the OpenEdge adapter logs additional debugging information useful to the publisher.
For logging level equal to 4, the OpenEdge adapter logs additional debugging information useful for Progress support services and engineering.
|
|
Service logging entry types
|
serviceLogging EntryTypes
|
-
|
Specifies the type of information recorded when performing diagnostic logging. The value is a comma-separated list of valid entry types. It is also possible to specify a different logging level for each entry type. For example: "ENTRY:2", where the number following the colon is the level. Levels for types must be greater than 1.
|
|
Service fault level
|
serviceFaultLevel
|
2
|
The amount (level) of information returned to the client for a SOAP Fault as determined by an integer value. A level of 2 returns basic information in the <FaultCode> and <FaultString> elements for each SOAP Fault message, which is suitable for normal production environments. A level of 3 returns more detailed information that is suitable for development environments. Other values provide varying levels of diagnostic information, and are reserved for use by Progress Technical Support and Engineering.
|
|
Wait if service is busy
|
waitIfBusy
|
0
|
An integer value that determines how to handle client requests to a service that is busy processing a prior request. If the value is 1, the OpenEdge Adapter queues multiple requests for this service and executes them one at a time until the queue is empty. If the value is 0 and the adapter is executing a prior request for the service, each subsequent request for the same service fails until the adapter completes the request it is currently executing.
|
|
Connection lifetime
|
connectionLifetime
|
0
|
The maximum lifetime (in seconds) of AppServer connections in the connection pool for this service. If the value is 0, then the lifetime of these connections is unlimited, unless they are disconnected according to the requirements of other property settings, such as idleSessionTimeout. If the value is greater than 0, then the OpenEdge adapter maintains any AppServer connections for this service for the specified number of seconds. Thus, when the idleSessionTimeout interval expires, the adapter trims the connections in the connection pool beginning with those whose connectionLifetime interval has expired. However, the adapter maintains the connections for all services whose connectionLifetime interval has not yet expired regardless of other property settings.
|
|
No host verification
|
noHostVerify
|
0
|
If the value is set to 1, turns off host verification for an SSL Web service connection (specified by the appServiceProtocol property). If cleared, the adapter compares the host name of the connecting AppServer with the Common Name specified in the server digital certificate, and raises a Web service error if they do not match. With this parameter specified, the Web service never raises the error.
|
|
No session reuse
|
noSessionReuse
|
0
|
If set to 1, the Web service connection does not reuse the SSL session ID when reconnecting to the same AppServer for an SSL Web service connection (specified by the appServiceProtocol property).
|
|
AppServer keep alive
|
appServer KeepAlive
|
denyClient ASK, allowServer ASK
|
Indicates if the client would employ the AppServer Keepalive protocol on this connection, if supported and enabled by the AppServer. To enable the protocol, specify the value as allowServerASK. To disable the protocol, specify the value as denyServerASK.
The absence of this property indicates that the default value for the ServerASK protocol is used on this connection.
|
|
Client ASK activity timeout
|
clientASKActivity Timeout
|
60
|
Determines the time interval the AppServer takes active steps to determine if the client is still connected. The ClientASK protocol denotes that the direction of the keepalive messages is from the client to the servers.
|
|
Client ASK response timeout
|
clientASKResponse Timeout
|
60
|
Determines the time interval the AppServer can receive messages from the server. The ClientASK protocol denotes that the direction of the keepalive messages is from the client to the servers.
|
|
SSL Ciphers
|
sslcipher
|
Default
|
This parameter determines the encryption to be used to connect to the AppServer. The default value is "Default" and it stands for TLSv1.
|
|
SSL Protocol
|
sslprotocol
|
Default
|
This parameter determines the security protocol to be used to connect to the AppServer. The default value is "Default" and it stands for TLSv1.
|
|
Properties available only for "Session-free" session model
|
|||
|
Minimum number of sessions
|
minSessions
|
1
|
The minimum number of connected sessions allowed in the connection pool. The OpenEdge adapter attempts to keep at least this many sessions connected to the application service (AppServer).
|
|
Maximum number of sessions
|
maxSessions
|
0
|
The maximum number of connected sessions allowed in the service connection pool. Once the number of sessions in the pool reaches this limit, the OpenEdge adapter creates no additional sessions for this service, and handles all requests for this service according to the requestWaitTimeout property setting. A value of 0 indicates that the size of the connection pool is unlimited.
|
|
Initial number of sessions
|
initialSessions
|
1
|
The number of network sessions to be created (and shared by all clients) when the service connection pool is initialized by the adapter. This value must be between the value of the minSessions property and the maxSessions property, inclusive, unless maxSessions is set to 0. If maxSessions is set to 0, the initialSessions value must only be greater than or equal to minSessions.
|
|
Idle session timeout
|
idleSessionTimeout
|
0
|
The duration (in seconds) between attempts by the adapter to shut down extra network connections to the AppServer, based on the client demand. The adapter monitors the maximum number of sessions needed since the last time-out, then disconnects any connections in excess of that number.
A value of 0 indicates that the adapter will never disconnect idle sessions unless the connectionLifetime interval has expired.
|
|
NameServer client pick list size
|
nsClientPicklistSize
|
8
|
The number of available AppServer options (the broker pick list) that the adapter requests from the NameServer each time it looks up a given application service name.
This property applies only to services that use a NameServer to access application services (an AppServer).
|
|
NameServer client pick list expiration
|
nsClientPicklist Expiration
|
300
|
The maximum duration (in seconds) that the adapter retains a list of AppServer options (pick list) for an idle application service. A value of 0 indicates that the pick list never expires.
This property applies only to services that use a NameServer to access application services (an AppServer).
|
|
Minimum idle connections
|
minIdleConnections
|
0
|
If set to 1, turns off host verification for an SSL Web service connection (specified by the appServiceProtocol property). If cleared, the adapter compares the host name of the connecting AppServer with the Common Name specified in the server digital certificate, and raises a Web service error if they do not match. With this parameter specified, the Web service never raises the error.
|