Logging/Trace

All AE programs write information about their 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.

All logging/trace settings are found in the INI file (see below).
By default, the files (log and trace) are overwritten every time the system is restarted. In order to keep older files for later use, you can specify the number of history files that should be kept with log count and trccount. The file name has to contain the string ## . It is replaced by 00 in the actual file name. The history files are then named 01, 02 etc. They are moved with every restart. The oldest file (with the highest number) is deleted and all other files are renamed (number is increased by 1).
Logging information is also stored in the AE database and can be retrieved using statistics/logging.

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 utilities 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 ArchiveL'utilitaire AE DB Archive exporte, afin de la sécuriser, la quantité sans cesse croissante de données de la base de données Automation Engine.
CC	AE DB Client CopyUtilitaire de copie et suppression de clients
LD	AE DB LoadPour réaliser différents objectifs, l'utilitaire DBLoad charge des données dans la base de données Automation Engine.
RE	AE DB ReorgUtilitaire de réorganisation de la base de données Automation Engine. Les enregistrements reçoivent une marque de suppression en raison de certains réglages.
UN	AE DB UnloadUtilitaire de déchargement de la base de données Automation Engine.

The same is true if the INI file cannot be found because it does not exist in the specified folder (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 job states are written to the logs. The following states exist:

JobTraitement sur un système cible. Egalement un type d'objet distinct dans l'Automation Engine. Status	Description
A - Status ended	Job ended with a return code that is not equal 0.
E - Status ended	Job ended on status 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 agent"Programme permettant l'exécution de Traitements sur des systèmes cible comme un ordinateur ou des solutions d'entreprise. Egalement un type d'objet distinct dans l'Automation Engine. [Anciennement appelé ""Exécuteur de tâches"".]" 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.