Automation Engine Script Guide > Ordered by Function > System Conditions and Settings > CHANGE_LOGGING

CHANGE_LOGGING

Script Function: Causes the log file to be changed

Syntax

CHANGE_LOGGING (Component)

Syntax

Description/Format

Component

Name of the componentA component is a single deployable application artifact. As an example, this can be yourfile.war to be deployed into a Tomcat container. Each component has different properties which determine where to get it from, how to configure it, etc. You will need one component per application artifact: e.g., one for the application tier and one for the database backend. whose log file should be changed
Format: AE name or script variable 

The following components can be specified:


Return code

"0" - The log file has successfully been changed.
"20223" - The specified agent groupAn agent group combines agents of the same platform. The agents that should be included in an agent group are specified by entering the agent name or via filters. A task that runs in an agent group is processed on one or all of the agent group's agents, depending on the specified mode. A particular Automation Engine object type. does not exist.
"20722" - The indicated server processThe core of the component Automation Engine. Different types are available: communication, work and dialog processes, as well as nonstop processes., agentA program that enables the de-centralized execution of processes (such as deployments) on target systems (computers or business solutions) or a service that provides connectivity to a target system (such as for databases or middleware). An agent is also an object type in the Automation Engine. [Formerly called "Executor."] See also: host or agent group does not exist or is inactive.

Comments

This scriptA particular Automation Engine object type. functionPre-defined run book template in the Automation Engine. One single step only, e.g. Start Windows Service, Copy file,… prompts the log file to be changed.

In the variableIt stores or retrieves values dynamically at runtime. An individual Automation Engine object type. UC_SYSTEM_SETTINGS, the administrator can set system-wide specifications for the number of days or the size of the log file (in MB). The log file is changed if the specified values are met. It is also possible to specify temporary changes which apply until the system is restarted. Do so in the Properties tab of the System Overview. The place of storage for log files is determined in the server's or agent's INI file.

If a agent group is specified, the log files of all corresponding agents changes. An error number is not returned if one of the agents is inactive and the log file cannot be changed.

Keep in mind that changing the logging of one work processA part of the component Automation Engine. It is responsible for an Automation Engine system's processes (see also 'Primary work process'). automatically applies to all work processes.

Example

In the following example, the log file of all work processes is changed.

:SET &RET# = CHANGE_LOGGING ("AE#WP001")

 

See also:

Script Elements - System Conditions and Settings

About Scripts
Script Elements - Alphabetical Listing

Script Elements - Ordered by Function

 


Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support

Copyright © 2016 Automic Software GmbH