HP-UX SNAplus2 CSV Programmer's Guide

Common Service Verbs Reference

COPY_TRACE_TO_FILE (HP-UX Systems Only)

Chapter 2 49

COPY_TRACE_TO_FILE

(HP-UX Systems Only)

The COPY_TRACE_TO_FILE verb copies the current contents of the

API trace ﬁle or ﬁles to a new ﬁle, and clears the trace ﬁles. This enables

you to save a copy of the current trace data for this application. For more

information about API tracing, refer to the HP-UX SNAplus2

Diagnostics Guide.

All API tracing on this application (for any of the SNAplus2 APIs) must

be stopped before you issue COPY_TRACE_TO_FILE. If any tracing is

active, use the DEFINE_TRACE verb to stop it before using this verb.

VCB Structure

struct copy_trace_to_file

{

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 file_name[64]; /* Trace file name. */

unsigned char file_option; /* File options. New or overwrite. */

unsigned char reserv4[12]; /* Reserved. */

};

Supplied Parameters

The program using this verb supplies the following parameters:

opcode

SV_COPY_TRACE_TO_FILE

file_name

The name (and optionally the path) of the ﬁle to hold

the trace information of up to 64 characters. If the ﬁle

is not in the current directory, specify the full path;

ensure that it is a valid path on any computer to which

this verb is issued.

If you set the

file_option

parameter to SV_NEW, the

ﬁle name speciﬁed must not be the name of an existing

ﬁle.