User Guide

Ampex 1308911-02 5-61
libdd2 API Functions dst_status
DST_BUFDTA_VALID
DST_RPCAP_VALID
DST_WRBLK_VALID
DST_FILEBLK_VALID
minblksz Minimum data block size (in bytes) supported by the tape drive.
maxblksz Maximum data block size (in bytes) supported by the tape drive.
drvblksz Current data block size (in bytes) reported by the tape drive.
wrblksz Data block size used when new files are written.
state Tape drive state expressed as a bit-mask. The following definitions
apply:
DST_READY
DST_PRESENT
DST_LOADED
DST_WR_PROTECT
DST_AT_BOP
DST_AT_BOT
DST_AT_EOP
DST_AT_EOT
DST_AT_EOD
DST_FILEMARK
DST_EW
DST_DOUBLE_DENSITY
DST_UNKNOWN_FMT
DST_QUAD_DENSITY
results Result of the last I/O operation (provides more information than
errno). Each result consists of a result code, a result class and a
printable message describing the result (see the
dstio.h file for
details).
format Current tape format; see dst_format() for details.
lpos Current tape drive position; see “DST API Overview” on page 5-1 for
information on the
dst_position_st structure that lpos points to.
obsolete1 Not used; retained only for compatibility with existing applications.
bufdata Number of data bytes in tape drive buffer. So, the unit should be number
of bytes. When zero, it indicates the last flush (write filemark or unload)
command is successful and data is physically written to tape. When
non-zero after a close or write filemark, then the last command is
buffered (data is not written to tape yet).
Note: Although you cannot use API to retrieve the data in the buffer, you can use
passthrough to retrieve it!
fileblksz Block size of file at current position on tape.