Installation guide

4: Commands and Responses
DC 900-1564A 53
4.5 Trace Category
4.5.1 Link Trace Data
The DLI_PROT_LINK_TRACE_DATA response contains one or more trace report entries.
Each report entry contains an
event_header_struct structure (Figure 4–11), followed
by a 16-bit sample size, a 16-bit packet size, and an optional data trace field.
Each trace report (Figure 4–12) begins on a 32-bit boundary within the data area. If the
optional data trace (of the preceding trace report entry) does not end on a proper
boundary, the trace report is padded to the next 32-bit bound.
In the client software directory for the SLC protocol, the
slc_trac.h file identifies these
two structures. The client program
slc_trac.c provides an example of how to access
the SLC protocol line tracing capability.
typedef struct event_header_struct
{
INT8 channel; /* 0 == All network channels
N == Nth network channel */
INT8 code;
INT8 id;
INT8 status;
UINT32 msTimeStamp;
} EVENT_HEADER_TYPE;
Figure 4–11: SLC Trace Event Header “C” Structure
typedef struct event_report_struct
{
struct event_header_struct event;
INT16 sample_size; /* Sample size sent to client */
INT16 packet_size; /* Packet size received on data link */
char sample[4]; /* Run-time dimension == sample_size */
/* Padded to next LONG bound */
} EVENT_REPORT_TYPE;
Figure 4–12: SLC Trace Report “C” Structure