CHANGE_LOGGING Parameters

Systemwide variables that determine the period and size after which the log files are changed.

As a system administrator, you can change the log files to ensure that you system runs smoothly during high workload times for the Automation Engine and the Agents. The log files can be changed after a certain period of time, or after they have reached a certain size (in MB). You can also archive and reorganize this data in the Automation Engine database, even if the Automation Engine and the agents are active for several months without interruption. For more information, see AE DB Archive and AE DB Reorg.

For work processes, you use CHANGE_LOGGING_MIN_TIME to define a minimum period of time between to log changes. This allows you to avoid a lot of log changes in a short time, for example on very high load.

Also, you can specify temporary log file changes in the Administration perspective and specify server settings for the log file change of work processes, see Processes and Utilization. These modifications are valid until the system reboots. Use the script element CHANGE_LOGGING to trigger a forced log file change.

To avoid endless reports for events, Remote Task Managers, Sync objects, and Schedule objects, their reports are also changed and a new statistical record begins. In this case, only the setting of CHANGE_LOGGING_DAYS is relevant.

Important! CHANGE_LOGGING_MB only works if the setting LOG_TO_DATABASE is set to Y. For the Automation Engine, define this setting in the UC_SYSTEM_SETTINGS variable. For agents use the UC_HOSTCHAR_DEFAULT - Host Characteristics variable. CHANGE_LOGGING_DAYS does not depend on this option.

The log files of all work processes are automatically changed if the logging of a work process (WP, DWP, PWP) changes. The logging of tasks that start on a recurring basis is changed on a daily basis or if the period settings are modified.

CHANGE_LOGGING_DAYS

  • Description: Defines the time period in days after which the log files are changed.

  • Allowed values: 1 to 32767

  • Default value: 14

  • Restart required: No

CHANGE_LOGGING_MB

  • Description: Defines the size in MB after which the log files are changed.

  • Allowed values: 1 to 32767

  • Default value: 20

  • Restart required: No

CHANGE_LOGGING_MIN_TIME

  • Description: Defines the minimum time period in minutes between two log changes. If there is another log change triggered, it is skipped. This applies to work processes only.

  • Allowed values: 0 to 1440

  • Default value: 0

  • Restart required: No

See also:

UC_SYSTEM_SETTINGS - Systemwide Settings