CADSMCMD Command Line Interface › The command cadsmcmd › The Trace Option

The Trace Option

The CLI offers a trace for debugging the CLI internal workflow in case of problems. By default, the trace is off. It should only be activated on request of CA support. The trace is driven by the environment variables SDCMD_TRACE and SDCMD_FILE. On Windows, the syntax for setting SDCMD_TRACE is as follows:

set SDCMD_TRACE={all | file | screen}

and on Linux for the bash:

export SDCMD_TRACE={all | file | screen}

If “screen” is coded, the CLI will record its trace entries on stdout i.e. the console from where it has been started.

If “file” is coded for the environment variable, then the CLI records into a file.

This file is specified by SDCMD_FILE variable and can be specified as follows:

set SDCMD_FILE=<file name> 

on Windows

and

export SDCMD_FILE=<file name> 

on Linux bash

If SDCMD_FILE is not set then the CLI writes into the file cadsmcmd.log of the Client Automation log directory.

In case of “all” the trace is written into the specified file and on stdout.

To turn off an activated trace, enter the following commands:

set SDCMD_TRACE=
set SDCMD_FILE=

for Windows and

unset SDCMD_TRACE
unset SDCMD_FILE

for Linux bash.

Whether a trace is activated for the CLI is recorded at the CLI start.

c:\>cadsmcmd verbose

CA IT Client Manager r12
ITCM Command Line Version 12.8.0.xxxx
Copyright (c) 2014 CA. All rights reserved.

Trace mode: FILE
Trace file name: c:\temp\tst.txt

Connecting to manager "<default manager>" as user "<default user>" ...OK.

In case of “Trace mode” SCREEN the “Trace file name” line is omitted. If no active trace, the following is recorded:

c:\>cadsmcmd verbose

CA IT Client Manager r12
ITCM Command Line Version 12.8.0.xxxx
Copyright (c) 2014 CA. All rights reserved.

Trace mode: Off

Connecting to manager "<default manager>" as user "<default user>" ...OK.