Administration Guide > Utilities > AE LogMix > Combining Report, Log and Trace Files

Combining Report, Log and Trace Files

All components write information about their activities to reports, log and trace files. There is no common overview which makes analyses more difficult. This becomes obvious in server processes which are usually distributed among several computers.

The utility AE.LogMix supports the generation of one common file from several report, log or trace files. The individual file entries are newly arranged in chronological order.

Trace files are only to be activated by the Automic Support team.

Reports of objects or log entries of server processes and agents can be unloaded from the AE databaseA database is an organized collection of data including relevant data structures. using the utility AE DB Archive. AE.LogMix is able to process these reports, log and trace files.

Procedure

Unloading reports upon request

AE DB Archive provides parameters which can be used 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 to be combined on the basis of this name prefix. The full name also includes the object name and time of report creation.

Example:

server_UC4#WP001_20070215_123045.txt

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

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

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

More detailed information is provided in the documentation about start parameters.

The progress of file creation is output in the utility's log file in percent.

As a result, the directory specified when calling the utility now contains several report files.

Generating a common file

AE.LogMix is able to integrate 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 selecting the files.

More detailed information about start parameters is provided in the documentation.

The result of this generation is a common file which contains the selected files in chronological order. This file starts with a list of all files including numbers in order to ensure that the original files are traceable although all entries have been rearranged. Each line starts with the number of the file from which the entry has been taken.

There can be time differences between the computers on which the components run. A message entry is made in the report, log or trace file when such a time difference has been identified. AE.LogMix considers this deviation in time in its chronological order. The entry's time stamp is not changed but a "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 found in file processing counts. This first identified time difference is used for the chronological order even if there is a PWP change to a different work process within the files.

Return Codes

AE DB Archive:

Return code

Description

1

Parameter -C is missing

2

Parameter -N is missing

3

A wrong date has been specified.

4

The file cannot be created because the name is too long on account of the defined prefix.

5

A file of the same name already exists.

6

More than 99 statistical records were found in the specified period.

AE.LogMix:

Return code

Description

1

None of the files meets the selection criteria.

2

More than 99 files were found.

3

The parameter -L has not been specified and no INI-file values have been defined.