NAME

tkadmin dump component - dumps the state of the specified component

SYNOPSIS

tkadmin dump component -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 server component (such as tran, rec,lock) whose state is to be dumped. A list of all components in the Toolkit server can be obtained using the tkadmin list trace command. 

DESCRIPTION

The tkadmin dump component command dumps the state of the specified component. 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. 

The destination of the dump output is defined at server startup (usually defaulted to the ring buffer) and can be redirected at any time via the tkadmin redirect trace command. 

CAUTIONS

This command should only be used as a diagnostic tool. It should not be used during normal server operation. 

EXAMPLES

The following command dumps the state of the Recovery Service component:

% tkadmin dump component rec

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 dump product

tkadmin list trace

tkadmin redirect trace

  —  March 1997