Campaign >unicaACListener

Properties in this category specify logging levels, certain access privileges, language encodings, number of operating system threads, and the protocol, host, and port of the Campaign listener. These properties need to be set only once per instance of Campaign; they do not need to be set for every partition.

enableWindowsImpersonation

The enableWindowsImpersonation property specifies whether Windows Impersonation is enabled in Campaign Windows. For more details about Windows Impersonation in Campaign, see the Campaign Administrator’s Guide.

Set the value to TRUE to use Windows Impersonation.

Set the value to FALSE if Windows Impersonation is not used.

Valid values

TRUE | FALSE

Default value

FALSE

enableWindowsEventLogging

The Campaign > unicaACListener > enableWindowsEventLogging property controls logging to the Windows event log. Set this property to TRUE to log to the Windows event log.

Valid values

TRUE | FALSE

Default value

FALSE

serverHost

The serverHost property specifies the name or IP address of the machine where the Campaign listener is installed. If the Campaign listener is not installed on the same machine where IBM Unica Marketing is installed, change the value to the machine name or IP address of the machine where the Campaign listener is installed.

Default value

localhost

logMaxBackupIndex

The logMaxBackupIndex property specifies how many backup files can exist before the oldest one is deleted. If you set this property to 0 (zero), Campaign does not create any backup files and the log file stops logging when it reaches the size you specified in the logMaxFileSize property.

If you specify a number (N) for this property, when the log file (File) reaches the size you specified in the logMaxFileSize property, Campaign renames the existing backup files (File.1 ... File.N-1) to File.2 ... File.N , renames the current log file File.1, closes it, and and starts a new log file named File.

Default value

1 (creates one backup file)

logStringEncoding

The logStringEncoding property controls the encoding used for all log files. This value should match the encoding used on the operating system. For multi-locale environments, UTF-8 is the preferred setting.

If you change this value, you should empty or remove all affected log files to prevent writing multiple encodings into a single file.

*
WIDEUTF-8 is not supported for this setting.
Valid values

See the Campaign Administrator's Guide for a list of supported encodings.

Default value

native

systemStringEncoding

The systemStringEncoding property specifies the encoding(s) used to interpret values coming into Campaign from the operating system (file system paths and filenames, for example), as well as the encoding in which Campaign presents values back to the operating system. This value should be generally be set to native. For multi-locale environments, UTF-8 is the preferred setting.

The value can include more than one encoding, separated by commas: for example,

UTF-8,ISO-8859,CP950

*
WIDEUTF-8 is not supported for this setting.
Valid values

See the Campaign Administrator's Guide for a list of supported encodings.

Default value

native

loggingLevels

The Campaign > unicaACListener > loggingLevels property controls the amount of detail written to the log file.

Valid values
*
*
*
Default value

MEDIUM

maxReuseThreads

The Campaign > unicaACListener > maxReuseThreads property sets the number of operating system threads cached by the Campaign listener process (unica_aclsnr) for reuse.

It is a best practice to use the cache when you want to reduce the overhead of thread allocation, or with operating systems that can exhibit an inability to release threads when asked to do so by an application.

Default value

0 (zero), which disables the cache

logMaxFileSize

The logMaxFileSize property specifies the maximum size, in bytes, that the log file can reach before rolling into the backup file.

Default value

10485760 (10 MB)

windowsEventLoggingLevels

The windowsEventLoggingLevels property controls the amount of detail written to the Windows event log file based on severity.

Valid values
*
*
*
*

The ALL level includes trace messages intended for diagnostic purposes.

Default value

MEDIUM

serverPort

The serverPort property specifies the port where the Campaign listener is installed.

Default value

4664

useSSL

The useSSL property specifies whether to use Secure Sockets Layer for communications between the Campaign listener and the Campaign web application.

Valid values

yes | no

Default value

no

keepalive

Use the keepalive property to specify, in seconds, the frequency with which the Campaign web application server sends keep alive messages on otherwise-inactive socket connections to the Campaign listener.

Using the keepalive configuration parameter enables socket connections to remain open through extended periods of application inactivity in environments configured to close inactive connections between the web application and the listener (for example, a firewall).

When there is activity on a socket, the keep alive period is automatically reset. At the DEBUG logging level in the web application server, the campaignweb.log will show evidence of the keep alive messages as they are sent to the listener.

Valid values

positive integers

Default value

0, which disables the keepalive feature



IBM Unica Campaign
 
8.5.0
For more information, see our support and community site: Customer Central