NAME

tkadmin dump product - dumps the state of all components in the specified product

SYNOPSIS

tkadmin dump 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 the name of the server product for which state information is dumped (for example, the Encina Server Core). A list of all products running in a server can be displayed by the tkadmin list trace command. Use “ ” (quotation marks) around product names that contain a space. 

DESCRIPTION

The tkadmin dump product command dumps the state of all components in the specified product. A component, in Encina software, is a module within a software product.  For instance, the Encina Executive product includes the Distributed Transaction Service (TRAN), the Thread-to-Tid Mapping Service (threadTid), and the Transactional Remote Procedure Call Service (TRPC). 

By default, dump output is directed to the trace ring buffer. The destination of dump output can be changed by using Enconsole, the tkadmin redirect trace command, or the -T option of the server start-up command. 

CAUTIONS

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

EXAMPLES

Enter the following command to dump the state of all components in the Encina Server Core product:

% tkadmin dump product “Encina Server Core”

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 component

tkadmin list trace

tkadmin redirect trace

  —  March 1997