Debug Logging Command-Line Options

Note:  For more detailed information on using these options, see the following sections in the System Coupling User's Guide:

OptionDescription

-l

--logLevel

Description

Specifies the log file verbosity.

Arguments

Accepts an integer value indicating the level of verbosity.

Available values:

  • 0: No log output

  • 1: Log remote process communication (RPC) calls

  • 2: Log additional diagnostics related to each RPC call (for example, arguments, lightweight data, and heavyweight data snippets/statistics)

  • 3 and higher: Log advanced diagnostics.

Usage


-l<LogLevel>

--logLevel=<LogLevel>

Examples


-l3

--logLevel=1

-logDir

Description

Applicable when the -l or --logLevel option is set to a value of 1 or higher.

Specifies the directory to which log files are written. Defaults to System Coupling's current working directory.

Arguments

Accepts a writeable Unicode directory path. The path must contain only ASCII characters and must use forward slashes (/) as separators. It may be either absolute or relative to System Coupling's working directory. If the directory does not exist, an error is issued.

Usage

The following usage examples use relative paths:


--logDir=<LogDirectory>

--logDir=<SyC/LogDirectory>

--logDir=../<LogDirectory>

--logMaxArrayElements

Description

Applicable when the -l or --logLevel option is set to a value of 2 or higher.

Specifies the maximum number of heavyweight data array elements to be written to the log file.

Defaults to a value of 5.

Arguments

Accepts an integer value.

Usage


--logMaxArrayElements=<NumberOfArrayElements>

Example


--logMaxArrayElements=3