AE.LogMix - Combining Report, Log and Trace Files

Administrators use the AE.LogMix utility to combine reports, logs and trace files that all components write about their activities. These files are often distributed among several computers. AE.LogMix generates one common file. This makes analyzing tasks easy as all the file entries are newly arranged in a chronological order.

This page includes the following:

Overview

You can unload reports of objects, or log entries of server processes and agents from the AE database by using the AE DB Archive utility. AE.LogMix can process these reports, log and trace files.

Unload Reports upon Request

The AE DB Archive utility provides parameters that you can use to limit the report selection. You can filter by object names, server processes or agents, or the period of report creation. The utility searches reports that were completely or partially created during the specified interval and unloads the respective complete report content to a log file. A separate file is created for each report.

The generated files obtain special names. The prefix can be freely selected and AE.LogMix retrieves the files that should be combined based on this name prefix. The full name also includes the object name and time of report creation.

Example

server_UC4#WP001_20070215_123045.txt

Important: The utility aborts if the output directory already contains a file of the same name.

To unload the reports, call the AE DB Archive utility with the following command-line syntax:

UCYBDBAR -B -Xreport -CClient -NServer names [-D1Start date and time] [-D2End date and time] [-PPath and file prefix]

For more information, see Start Parameters - Utilities.

The progress of file creation is output in the utility's log file in percent. Finally, the directory that was specified when calling the utility contains several report files.

Generate a Common File

AE.LogMix is used to combine several report, log or trace files into one file.

Use the following command-line syntax to call the utility AE.LogMix:

UCYBLGMX -B [-LPath and name of the files ] [-FPath and file name of the target file ]

The advantage of a defined name prefix now becomes obvious when you select the files.

For more information, see AE.LogMix.

The result is a common file that contains the selected files in a chronological order. The new file starts with a list of all files including numbers to ensure that the original files can be traced although all entries have been re-arranged. Each line starts with the number of the original file from which the entry has been taken.

Important: Only CA Support should activate trace files.

There can be time differences between the computers on which the components run. A message entry is included in the report, log or trace file if such a time difference has been identified. AE.LogMix considers this deviation in time in its chronological order. The entry's timestamp is not changed but the letter T is used to flag the relevant lines.

Example

Trace 01: C:\AUTOMIC\REPORTS\TRACES\WPSRV_TRC_001_##.TXT
Trace 02: C:\AUTOMIC\REPORTS\TRACES\WPSRV_TRC_002_##.TXT
Trace 03: C:\AUTOMIC\REPORTS\TRACES\WPSRV_TRC_003_##.TXT

02 - 20060620/163723.373 -  U0003450 TRACE file was opened using the switches '2400090000000000'.
01 - 20060620/163723.373 -  U0003491 Time difference '0/00:02:11' or '131' seconds to the Primary Server  
03 T 20060620/163723.373 -  U0009909 TRACE: (BINDPAR:  MQSRV_System      )            F074F57D 000008

Time-difference calculations are always based on the primary work process (PWP). The first PWP that is found in file processing is the one that counts. This first identified time difference is used for the chronological order even if the PWP changes to a different work process within the files.

Return Codes

AE DB Archive:

AE.LogMix: