[ Previous | Next | Contents | Home | Search ]
AIX Version 4.3 Understanding the Diagnostic Subsystem for AIX

dt

Purpose

Writes diagnostic trace information to a file.

Syntax

#include     <diag/diag_trace.h>

void dt ( dt_id, dt_type [,val, ...])
char *dt_id;
int  dt_type;

Description

The dt subroutine allows trace information to be written to a file. If the file /tmp/.DIAG_TRACE exists, trace information will be written to a file specified by the dt_id argument. The default is to overwrite existing trace information. To append to the trace file, export DIAG_TRACE=APPEND.

Parameters

dt_id Used to uniquely identify the trace file. The resulting trace file will be called .dt.'dt_id' in the /tmp directory.
dt_type The type of trace function to perform.
DT_TMI Trace initialization for Diagnostic Applications (DA). Information from the TMInput structure will be written to the trace file.
DT_BEGIN Trace initialization for Service Aids (SA).
DT_DEC Trace an integer variable in decimal.
DT_MDEC Trace multiple integer variables in decimal.
DT_HEX Trace an integer variable in hexadecimal.
DT_MHEX Trace multiple integer variables in hexadecimal.
DT_LDEC Trace a long integer variable in decimal.
DT_MLDEC Trace multiple long integer variables in decimal.
DT_LHEX Trace a long integer variable in hexadecimal.
DT_MLHEX Trace multiple long integer variables in hexadecimal.
DT_MSTR Trace multiple string variables.
DT_MSG Trace a simple message such as "hello."
DT_BUFF Trace a data buffer.
DT_SCSI_TUCB Trace SCSI TUCB structure information.
DT_SCSI_TUCB_SD Trace SCSI TUCB Sense Data information.
DT_END Write "end of trace" identifier to the trace file.
val Variable arguments which may include the number of multiple variables to trace, the trace labels, and the information to trace.

Return Value

There is no return code.

[ Previous | Next | Contents | Home | Search ]