NAME

tkadmin untrace product - turns off tracing in all components of a product

SYNOPSIS

tkadmin untrace product -server servername productname {options...}

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 the server product for which tracing should be enabled (for example, Encina Executive). A list of all products in the server can be obtained using the tkadmin list products command. Use quotes around product names that contain a space. 

{options...} Lists of one or more options that designate the type of tracing to turn on. The type of tracing is defined as a union of the trace options specified. The standard options are event, param, internal_param, entry, internal_entry. Another valid trace option is any 32-bit hex value, for example: 0x000000FF. If no options are specified, all standard tracing is turned off. 

DESCRIPTION

The tkadmin untrace product command disables the trace statements in each component of the specified product that are governed by the trace mask values (options) specified.  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 that 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 for the tkadmin untrace product command:

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

The tkadmin untrace product command can be used as a shorthand for repeated invocations of the tkadmin untrace component command to set the standard trace masks in each component of a product.  Generally, it does not make sense to supply nonstandard trace masks to this command because the nonstandard trace masks can have different meanings in each of the components of the product. 

NOTES

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

EXAMPLES

The following command turns off entry/exit tracing and parameter tracing in all components of the Encina Server Core product, that is, entry/exit tracing and parameter tracing are disabled in rec, tran, lock, and vol:

% tkadmin untrace product “Encina Server Core” entry param

PRIVILEGE REQUIRED

Encina Monitor administer (a) permission to the server

Encina RQS administer (a) permission to the RQS server

Encina SFS administer (A) permission to the SFS server

RELATED INFORMATION

tkadmin trace component

tkadmin trace product

tkadmin trace specification

tkadmin untrace component

  —  March 1997