HP-UX SNAplus2 CSV Programmer's Guide

Common Service Verbs Reference

DEFINE_TRACE (HP-UX Systems Only)

Chapter 2 53

DEFINE_TRACE

(HP-UX Systems Only)

The DEFINE_TRACE verb enables or disables tracing for speciﬁed

Application Program Interfaces (APIs).

The trace ﬁles must be set up before the application which issues this

verb is started, using the SNATRC environment variable. For information

about how to control API tracing, refer to the HP-UX SNAplus2

Diagnostics Guide.

The operation of this verb is affected by the SNACTL environment

variable (for more information, see “SNACTL Environment Variable”).

VCB Structure

struct define_trace

{

unsigned short opcode; /* Verb identifying operation code. */

unsigned char opext; /* Verb extension code - reserved. */

unsigned char reserv2; /* Reserved. */

unsigned short primary_rc; /* Primary return code from verb. */

unsigned long secondary_rc; /* Secondary (qualifying) return code.*/

unsigned char reserv3[8]; /* Reserved. */

unsigned char dt_set; /* Trace state to be set (on/off). */

unsigned char appc; /* Tracing for APPC. */

unsigned char nof; /* Tracing for NOF API. */

unsigned char srpi; /* Reserved. */

unsigned char sdlc; /* Reserved. */

unsigned char tkn_rng_dlc; /* Reserved. */

unsigned char pcnet_dlc; /* Reserved. */

unsigned char dft; /* Reserved. */

unsigned char acdi; /* Reserved. */

unsigned char reserv5; /* Reserved. */

unsigned char comm_serv; /* Tracing for Comm_Serv_API. */

unsigned char ehllapi; /* Tracing for HLLAPI. */

unsigned char x25_api; /* Reserved. */

unsigned char x25_dlc; /* Reserved. */

unsigned char twinax; /* Reserved. */

unsigned char ms; /* Tracing for MS API. */

unsigned char rui; /* Tracing for RUI interface of LUA */

unsigned char etherand; /* Reserved. */

unsigned char subsym; /* Reserved. */

unsigned char reserv7[8]; /* Reserved. */

unsigned char reset_trc; /* Flag to reset the trace files. */

unsigned short trunc; /* Truncation size for trace records. */