User Guide

Ampex 1308911-02 5-31
libdd2 API Functions dst_getlog
5.8 dst_getlog
NAME
dst_getlog() - get tape drive error, operational, service, and diagnostic statistics.
SYNOPSIS
#include <dd2.h>
int dst_getlog(int fd, dst_log_st *log);
DESCRIPTION
dst_getlog() retrieves error and operational statistics from tape drive integer counters. This
information is intended to aid service personnel in diagnosing and correcting problems.
The tape drive increments a given counter every time the associated event occurs. An
exception is registered if a counter’s threshold value is exceeded.
You can use dst_clrlog() to reset the error and operational statistics counters to their starting
values (usually zero). The service statistics counters cannot be reset.
dst_getlog() is available to all users
PARAMETERS
fd The file descriptor returned by the open call.
*log Pointer to a structure of type
dst_log_st.
USAGE
dst_getlog() uses the *log structure for both input and output. Before calling dst_getlog(),
initialize the *log structure
flags and type members to indicate which information to
retrieve.