Use this utility to set the global trace mask of ctdaemon while it is active.
setctatrace [options]
where options are the following values:
|
Option |
Use this option to... |
|
-? or -h |
Access Help and terminate setctatrace. |
|
-s host_name |
Specify the name or IP address of the server to monitor. If unspecified, the default is localhost. |
|
-m mask |
Specify the global trace mask for ctadaemon. |
where mask values are:
|
String |
Constant |
Hex value |
|---|---|---|
|
all |
CTA_TRACEMASK_ALL |
0xff7f |
|
allcmd |
CTA_TRACEMASK_ALL_COMMANDS |
0x5015 |
|
allevt |
CTA_TRACEMASK_ALL_EVENTS |
0xa02a |
|
drvcmd |
CTA_TRACEMASK_DRIVER_COMMANDS |
0x0001 |
|
drvevt |
CTA_TRACEMASK_DRIVER_EVENTS |
0x0002 |
|
dispcmd |
CTA_TRACEMASK_DISP_COMMANDS |
0x0004 |
|
dispevt |
CTA_TRACEMASK_DISP_EVENTS |
0x0008 |
|
apicmd |
CTA_TRACEMASK_API_COMMANDS |
0x0010 |
|
apievt |
CTA_TRACEMASK_API_EVENTS |
0x0020 |
|
apierr |
CTA_TRACEMASK_API_ERRORS |
0x0040 |
|
svcerr |
CTA_TRACEMASK_SVC_ERRORS |
0x0080 |
|
dbgbit0 |
CTA_TRACEMASK_DEBUG_BIT0 |
0x0100 |
|
dbgbit1 |
CTA_TRACEMASK_DEBUG_BIT1 |
0x0200 |
|
dbgbit2 |
CTA_TRACEMASK_DEBUG_BIT2 |
0x0400 |
|
dbgbit3 |
CTA_TRACEMASK_DEBUG_BIT3 |
0x0800 |
|
cltcmd |
CTA_TRACEMASK_CLNT_COMMANDS |
0x1000 |
|
cltevt |
CTA_TRACEMASK_CLNT_EVENTS |
0x2000 |
|
svrcmd |
CTA_TRACEMASK_SRVR_COMMANDS |
0x4000 |
|
svrevt |
CTA_TRACEMASK_SRVR_EVENTS |
0x8000 |
|
none |
CTA_TRACEMASK_NONE |
0x0000 |
When you use setctatrace to set the global trace mask of ctadaemon, you do not have to stop ctdaemon. setctatrace sets the global trace mask of ctdaemon dynamically, while ctdaemon is active.
To run setctatrace, enter the following command at the prompt:
setctatrace [-s host_name] [-m mask] [-h]
Specify the trace mask as a sequence of strings, constants, decimal values, or hex values delimited by + signs (with no spaces). To specify a hex value, prefix the value with 0x. Enter -? or -h at the interactive command prompt to see recognized names for setting the trace mask.
Trace messages display only if the trace mask corresponding to the specific type of message is enabled. setctatrace sets the trace mask for all processes that enabled tracing with ctaInitialize. To be more selective in tracing, use ctaSetTraceLevel from the application itself to set the trace mask for a service on a specific context.
For example, if you enter:
setctatrace -m apievt+CTA_TRACEMASK_API_ERRORS+0x0001
setctatrace sets the trace mask for API events, API errors, and driver commands.
Call setctatrace -m 0 to disable the global trace mask.