NAME

tkadmin list trace - lists components and their corresponding trace masks

SYNOPSIS

tkadmin list trace -server servername [-product productName] [-component 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. 

[-product productName]
Specifies the product name, such as “Encina Executive”, for which trace masks are displayed.  Product names containing spaces must be enclosed in quotation marks. The following aliases are also valid product names: all, client, exec, server, tpm, ts, sfs, rqs, ppc, and private. For example, exec (Encina Executive) includes several components such as threadTid, trdce and trpc. 

[-component componentName]
Specifies the component name for which trace masks are displayed.

DESCRIPTION

The tkadmin list trace command displays trace masks for all components in a server, a specific component, or all components within a product. A trace mask is a variable that controls the amount of tracing for a component. If the command is used without options, the trace masks for all components in the server are displayed. If the -product option is used, the trace masks for all of the components belonging to the specified product are displayed. If the -component option is used, the trace masks for the specified component are displayed. 

The tkadmin list trace command displays the trace mask as a string of one or more trace options, such as trace_entry or trace_param. To display a component’s trace mask in hexadecimal form, use the tkadmin query trace command. Note that it may be possible to represent the same trace mask value with more than one string of trace options. Only one of the possible strings is displayed for each trace mask. 

EXAMPLES

The following command lists the trace masks for all components in the server:

% tkadmin list trace

Encina Executive:
  epm=0
  admin=default
  tran=trace_entry+trace_param
  trpc=default
  trdce=default
  threadTid=0
Encina BDE:
  bde=0
vendor_bpg:
  vendor_bpg=0

The following command lists the trace masks for all components in the Encina Executive using the exec alias:

% tkadmin list trace -product exec

epm=0
  admin=default
  tran=trace_entry+trace_param
  trpc=default
  trdce=default
  threadTid=0

The following command displays the trace mask for the tran component:

% tkadmin list trace -component tran

tran=trace_entry+trace_param

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 query component

tkadmin query product

tkadmin query trace

tkadmin trace specification

  —  March 1997