NAME

tkadmin query product - displays the trace masks of each component in a product

SYNOPSIS

tkadmin query product -server servername productname

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. 

productname Specifies product whose tracing mask is desired, for instance, “Encina Server”.  When the product name contains a space character, the product name must be enclosed in quotation marks. 

DESCRIPTION

The tkadmin query product command displays the trace masks associated with each component of the specified product. A component, in Encina software, is a module within a software product. For instance, one Encina product is the Encina Executive. The Encina Executive includes three components: the Distributed Transaction Service, the Thread-to-Tid Mapping Service, and the Transactional RPC Service. Each component has a trace mask, a 32-bit unsigned integer, associated with it. The component’s trace mask determines what, within the component, gets traced. 

Bits in the trace mask enable various types of tracing in components. The first eight bits (0 through 7) represent the standard trace bits which apply to all components. The remaining 24 bits in a component’s trace mask represent events specific to the component.  Contact your product support representative for information regarding component-specific event bits. 

Encina defines the following standard options:

event - (0x00000001) events in all functions

entry - (0x00000002) entry/exit of all exported functions

param - (0x00000004) parameters of all exported functions

internal_entry - (0x00000008) entry/exit of non-exported functions

internal_param - (0x00000010) parameters of non-exported functions

NOTES

The tkadmin query product command is obsolete and will be discontinued in future versions of Encina. The tkadmin query trace command should be used instead of the tkadmin query product command. 

EXAMPLES

The following command displays trace masks for the “Encina Executive” product:

% tkadmin query product “Encina Executive”

Encina Executive:
  tran:  none

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 trace

  —  March 1997