Administration Guide > Diagnostic Tools > TRACE

TRACE

Script functionPre-defined run book template in the Automation Engine. One single step only, e.g. Start Windows Service, Copy file,…: Outputs values to a trace file

Syntax

TRACE (Trace option, trace level, trace output)

Syntax

Description/Format

Trace option

Trace setting
Format: script variable or number

Allowed values:

"1" - TCP/IP
"2" - Database
"4" - Srcall
"5" - Memio
"6" - JCL
"7" - Memsv
"8" - SNMP
"9" - Zuxml
"10" - Cache
"12" - Ucds
"13" - Xscript
"14" - UC4global
"16" - Minimal

Trace level

Trace size
Format: script variableA placeholder for a value within a script. or number

The allowed values depend on the selected trace option.

Trace output

Any text that serves as trace output

Format: script literal or script variable


Return codes

"0" - The trace was successful.
"20208" - The trace level is not within the allowed range.

Comments

This scriptA particular Automation Engine object type. function only serves diagnostic purposes and must only be used in close cooperation with the support team!

To enable trace output, keep the following instructions in mind:

The trace output is written to the file specified in the INI file of the Server (see [TRACE] section).

Example

In the following example, a trace for the content of a script variable is activated. The trace is successful when a databaseA database is an organized collection of data including relevant data structures. trace with at least one of four trace levels was activated in the properties of the server processes.

:SET &NUMBER# = 10
:
SET &RET# = TRACE(2,4,"The variable NUMBER has the value: &NUMBER#")

 

See also:

Script element Description

LOG_DUMP

Outputs values of the memory range to a log file

TRACE_DUMP

Outputs values of the memory range to a trace file

About Scripts
Script Elements - Alphabetical Listing

Script Elements - Ordered by Function

 


Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support

Copyright © 2016 Automic Software GmbH