Administration Guide > Diagnostic Tools > Logging/Trace

Logging/Trace

All AE programs write information about their activitiesDeployment-related activities to logs. The use of particular settings facilitates the output of extended information in a trace. This is particularly useful when searching for and/or correcting an error.

INI-file settings:

Section

Name

Description

Required

[GLOBAL]

logging=

Name of the log file

Yes

[GLOBAL]

logcount=

Number of historical log files

No (00)

[Trace]

file=

Name of the trace file

Yes

[Trace]

trccount=

Number of historic trace files

No (00)

[Trace]

diverse

Control of the trace extent

No (0)

Log Files of the Utilities

If the parameter logging= is not defined, the utilitiesUtilities support the execution of administrative tasks in an Automation Engine system (such as reorganizing and archiving the Automation Engine database). create the following log files by default:

Windows: .\UCYBDBxx_LOG_##.TXT
UNIX:
./UCYBDBxx_LOG_##.TXT

xx stands for the particular utility.

Abbreviation

Utility

AR

AE DB ArchiveThe utility AE DB Archive can be used to remove the increasing amounts of data from the Automation Engine database.

CC

AE DB Client CopyUtility for copying and deleting clients

LD

AE DB LoadThe utility DB Load can be used to load data into the Automation Engine database.

RE

AE DB ReorgData can be reorganized by using the utility DB Reorg. It marks data records with a deletion flag in accordance with the settings that have been specified.

UN

AE DB UnloadUtility for unloading the Automation Engine database.

The same is true if the INI file cannot be found because it does not exist in the specified folderTop level entities such as Environment, Deployment Target, Activity, … are stored in folders. The permissions a user has on an entity depend on the permissions that are set on the folder for the entities. (see start parameter -I).
Hence a log file is even created if incorrect settings were made.

Job States in Log Files

During the execution of jobs, messages providing information about jobAn Automation Engine object type for a process that runs on a target system. states are written to the logs. The following states exist:

Job Status

Description

A - Status ended

Job ended with a return codeThe value that represents the result of tasks and script functions. that is not equal 0.

E - Status ended

Job ended on statusThis represents the condition of a task (such as active, blocked, generating). ENDED_OK.

R - Status running

This status is written to the log file periodically while the job is being executed.

V - Status vanished

This status only occurs when the 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 cannot find a job anymore that it has started (see also: Finding Jobs after Agent Downtimes).

W - Status waiting

Job has not yet started and is in a waiting condition.

 

See also:

Job - Execution

 


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

Copyright © 2016 Automic Software GmbH