CWBTRC - Trace iSeries Access for Linux
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
Defaults shown in bold.
- /DT:0-1 = turn detail trace off/on
- /DPATH:path = detail trace path, default is $HOME/.iSeriesODBC
- /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/.iSeriesODBC /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.csvThe 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 mg file before wrapping. It will also turn on history logging.
cwbtrc /dt:1 /dwrap:10 /hl:1The following command will turn on history log and change the path to /usr/traces
cwbtrc /hl:1 /hpath:/usr/traces
Parent topic:
iSeries Access for Linux utilities