User Guide

5-32 Ampex 1308911-02
Model No.
Running Head
dst_getlog libdd2 API Functions
typedef struct
{
u_int flags; /* Log category mask */
u_int type; /* Log parameter type */
u_int bufunder; /* Buffer underruns */
u_int bufover; /* Buffer overruns */
u_int wrerr; /* Write errors */
u_int wrerrc; /* Write errors corrected */
u_int wrretry; /* Write retries */
u_int wrerru; /* Write errors uncorrected */
u_int rderr; /* Read errors */
u_int rderrc; /* Read errors corrected */
u_int rdretry; /* Read retries */
u_int rderru; /* Read errors uncorrected */
u_int nmerr; /* Non-medium errors */
dst_log_serv_st servstats; /* Service statistics */
dst_log_optm_st optmstats; /* TM operational statistics */
dst_log_opem_st opemstats; /* EM operational statistics */
dst_log_msr_st msrstats; /* MSR diagnostic statistics */
} dst_log_st;
PARAMETERS
flags Specifies the statistics to be retrieved :
DST_LOG_IOERR - get statistics for u_int members only.
DST_LOG_SERV - get statistics for servstats member only.
DST_LOG_OPTM - get statistics for optmstats member only.
DST_LOG_OPEM - get statistics for opemstats member only.
DST_LOG_MSR - get statistics for msrstats member only.
DST_LOG_ALL - get statistics for all members.
type Type of statistics to be retrieved:
DST_LOG_THRESHOLD - threshold values.
DST_LOG_CUMULATIVE - cumulative values.
DST_LOG_DEFAULT_THRESHOLD - default threshold values.
DST_LOG_DEFAULT_CUMULATIVE - default cumulative values.
bufunder Buffer Underruns - A buffer underrun is detected during a write
operation when a buffer empty condition prevents continued transfer of
data to tape from the buffer; this occurs when the initiator does not
transfer data to the buffer fast enough to keep up with writing to tape.
bufover Buffer Overruns - A buffer overrun is detected during a read operation
when a buffer full condition prevents continued transfer of data to the
buffer from tape. This occurs when the initiator does not transfer data
from the buffer fast enough to keep up with reading from tape.
wrerr Write Errors - The total number of write errors encountered, including
those detected during retries.