CWBTRC - Trace Application Package

Use this command from a console prompt to configure tracing.

Syntax

cwbtrc [/DT:0-1] [/DPATH:path] [/DWRAP:0-4000] [/DFLTR:0-1] [/DTICK:0-1] [/DFRMT:0-1] [/HL:0-1] 
[/HPATH:path] [/HWRAP:0-4000] [/HFLTR:0-1] [/HTICK:0-1]

Parameters

Note: Defaults shown in bold.
  • /DT:0-1 = turn detail trace off/on
  • /DPATH:path = detail trace path, default is $HOME/.iSeriesAccess
  • /DWRAP:0-4000 = detail trace wrap size (MB), default is 1. An <EOF> symbol will be placed after the last record.
  • /DFLTR:0-1 = detail trace filter off/on
  • /DCOMP:abc,abc = filter component list. Where components are: Configuration, Communication, Comm-API, Comm-SPI, Comm-System, Comm-Base, License Management, NLS, ODBC, ODBC-Error, Emulator, Remote Command, Service, Security.
  • /DTICK:0-1 = timestamp or tick count in trace entries
  • /DFRMT:0-1 = limit tcp hex data off/on
  • /HL:0-1 = turn history log off/on
  • /HPATH:path = history log path, default is $HOME/.iSeriesAccess /HWRAP:0-4000 = history log wrap size (MB), default is 1. An <EOF> symbol will be placed after the last record.
  • /HFLTR:0-1 = history log filter off/on
  • /HCOMP:abc,abc = filter component list. Where components are: Configuration, Communication, Comm-API, Comm-SPI, Comm-System, Comm-Base, License Management, NLS, ODBC, ODBC-Error, Emulator, Remote Command, Service, Security.
  • /HTICK:0-1 = timestamp or tick count in traces entry

Running CWBTRC without any parameters will show the command syntax and the current status of each parameter.

The output from CWBTRC will have the following naming convention: 

cwbdetail-<process name>-<pid>.csv

cwbhistory-<process name>-<pid>.csv

The output files will be in semicolon separated record format, suitable for input into spreadsheets for viewing.

Examples

The following command will turn on detail trace and allow it to grow to a 10 megabyte file before wrapping. It will also turn on history logging. 

cwbtrc /dt:1 /dwrap:10 /hl:1

The following command will turn on history log and change the path to /usr/traces 

cwbtrc /hl:1 /hpath:/usr/traces