NAME

tkadmin query trace - lists trace mask and trace options for the specified component

SYNOPSIS

tkadmin query trace -server servername componentName

ARGUMENTS

-server servername Specifies the server affected by the command. The server name is the name that is registered with the DCE Directory Service. If the server name is not specified in the command line, it is retrieved from an environment variable, ENCINA_TK_SERVER. 

componentName Specifies the component name for which trace options are displayed. Use the tkadmin list trace command to obtain a list of components in a server. 

DESCRIPTION

The tkadmin query trace command lists the current trace mask (in hexadecimal form) and all valid trace options for the specified component. A trace mask is a variable that controls the amount of trace output for a component. Trace options are identified by string names and their corresponding hexadecimal values. These trace options can be used with commands such as tkadmin trace specification to control the amount of tracing for a component. 

To display a component’s trace mask in string form, as used by the tkadmin trace specification command, use the tkadmin list trace command. 

EXAMPLES

The following command displays the current value of the trace mask variable for the tmxa component and trace options recognized for the tmxa component:

% tkadmin query trace tmxa

0x00000401: tmxa_traceMask
0x00000100: xa
0x00000200: lock
0x00000400: callback
0x00000800: xa90
0x00001000: init

PRIVILEGE REQUIRED

Encina Monitor query (q) permission to the server

Encina RQS query (q) permission to the RQS server

Encina SFS query (Q) permission to the SFS server

RELATED INFORMATION

tkadmin list components

tkadmin list products

tkadmin list trace

tkadmin query component

tkadmin query product

tkadmin trace specification

  —  March 1997