# Set global trace mask of ctdaemon utility: setctatrace

Use this utility to set the global trace mask of ctdaemon while it is active.

#### Usage

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

#### Description

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.

#### Procedure

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.