NAME

tkadmin dump ringbuffer - dumps the trace ring buffer

SYNOPSIS

tkadmin dump ringbuffer -server servername filename [-binary] [-overwrite]

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. 

filename Specifies a destination for trace output (either an operating system file or standard input/output stream). A complete or relative pathname can be specified. If relative, the pathname is interpreted within the context of the server’s working directory. 

[-binary] Causes the trace output to be unformatted. 

[-overwrite] Causes the output file to be overwritten rather than appended. 

DESCRIPTION

The tkadmin dump ringbuffer command dumps the contents of the ring buffer into an operating system file. The main memory ring buffer captures trace data. The tkadmin dump ringbuffer command formats the trace data and appends it to the specified file. If the -binary option is used, the trace information is not formatted. If the -overwrite option is used, the file is overwritten rather than appended. 

NOTES

The tkadmin dump ringbuffer command should be used only as a diagnostic tool. Using this command during normal server operation can degrade performance. 

EXAMPLES

The following command dumps the ring buffer to the file named ringbuffer.out :

% tkadmin dump ringbuffer ringbuffer.out

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

  —  March 1997