This page refers to an older version of the product.
View the current version of the online Help.

 

Environment Manager Log File Conversion

The Environment Manager Log File Conversion tool (Etl2Txt) is a command line driven tool to convert ETL log files to text files.

It is recommended that the Environment Manager Monitor is used to view and analyze ETL log files. For further information, see Environment Manager Monitor.

The Environment Manager Log File Conversion tool is located in the Tools installation folder and is run from the command prompt.

To run the Environment Manager Log File Conversion tool:

  1. Open the Run dialog and enter cmd.exe.
  2. Using the command prompt, navigate the Tools installation folder - %ProgramFiles%\AppSense\Environment Manager\Tools\.

  3. Run the Etl2Txt.exe, together with the appropriate parameters as detailed in the following table:

    Parameters Input Arguments Parameter Details
    -?

    -help

    		n/a Outputs the help text to the console.
    -f

    --filename

    		filename Specify the name of the source ETL file to convert.

    This is a required parameter.
    -c

    --components

    		components Specify the name of the Environment Manager components to include in the conversion:
    • EmUser
    • EmCoreService
    • EmSystem
    • EmUserLogoff
    • Other

    Separate multiple components with a space.

    If the parameter is not specified, all components are included by default.

    -s

    --split_output

    		 yes or no Specify whether output log files are split or collated:
    • yes - Output log files split by Environment Manager component.
    • no - Output a single collated log file for all Environment Manager components.

    If the parameter is not specified, the argument defaults to yes.
    -i

    --include_events

    		yes or no Specify whether trace events are included in the output:
    • yes - Output trace events with the raw log lines.
    • no - Output raw log lines only.

    If the parameter is not specified, the argument defaults to no.
    -e

    --events_only

    		yes or no Specify whether trace events are output:
    • yes - Output trace events only.
    • no - Output raw log lines and, if --include_events is set to yes, trace events.

    If the parameter is not specified, the argument defaults to no.

    -o

    --output_dir

    		path Specify the directory for the output files.

    If the parameter is not specified, the current directory is used for the output.
    -t

    --text_levels

    		yes or no Specify how log levels are displayed:
    • yes - Output log levels as text.
    • no - Output log levels as numbers.

    If the parameter is not specified, the argument defaults to no.