Chapter 4: Configuration Options Custom Server Options
Custom Server Options
Note:
For information on deploying Custom Server, see the Universal
Routing 7.6 Deployment Guide, Chapter 5.
There are two sections in the Custom Server
Application object: default
and log
. See Universal Routing 7.6 Deployment Guide, Chapter 9 for information on the log section. The options for the default
section are described below.
async
Location in Configuration Layer by precedence
: Custom Server
Default value: false
Valid values: true, false
Value changes: take effect immediately for new requests only
The async
option tells Custom Server to call the
R_CUSTOMER_PROCEDURE
of the
RCP module in either synchronous or asynchronous mode.
•
A value of true
tells Custom Server to interact in asynchronous mode.
•
A value of false
tells Custom Server to interact in synchronous mode.
The default value is false
.
buffer_size
Location in Configuration Layer by precedence
: Custom Server
Default value:
4096
Valid values: any non-negative integer
Value changes: take effect immediately
The buffer_size option specifies the maximum size of the buffer (in bytes) that contains the result of
R_CUSTOMER_PROCEDURE
. The default (and minimum) value is
4,096
bytes. The actual size of the buffer cannot be reduced. A new size can only be made greater than the old size, but cannot be less than 4K.
Otherwise the value change has no effect and generates a warning.
frequency
Location in Configuration Layer by precedence
: Custom Server
Default value:
1000
Valid values: any non-negative integer
Value changes: take effect immediately
The frequency
option is valid for asynchronous mode only. This option specifies the time interval in milliseconds that Custom Server waits between
Reference Manual 593
Chapter 4: Configuration Options Custom Server Options two consecutive
R_CUSTOMER_PROCEDURE
calls related to the same incomplete request. The default value is
1000
milliseconds. This option takes effect for all requests.
hide_private_data
Location in Configuration Layer by precedence
: Custom Server
Default value: false
Valid values: true, false
Value changes: take effect immediately
Note:
URS also provides this option (see
), however it works a little differently when used with Custom Server. This is because Custom
Server does not print T-Library events or the results of database access in the log.
If set to true this option prevents Custom Server from showing Universal
Routing Server request parameters in the log.
life_time
Location in Configuration Layer by precedence
: Custom Server
Default value:
600
Valid values: any non-negative integer
Value changes: take effect immediately
The l ife_time
option specifies the time interval, in seconds, during which the requests sent to a custom procedure are assumed to be valid. The default value is
600
seconds. This option takes effect for all requests.
new_parsing
Location in Configuration Layer by precedence
: Custom Server
Default value: true
Valid values: true, false
Value changes: take effect immediately
This option provides advanced parsing ability. Use when parameters of requests that Custom Server receives from URS can contain a single quote (').
Its default value is true so the advanced parsing is switched on by default. If set to false
, Custom Server parses data using the previous 5.x/6.x/7.x parsing rules.
594 Universal Routing 7.6
