User manual AMPEX DATA DSTDIS TAPE DRIVE PROGRAMMER S GUIDE, PART NO. 1308911-02

[. . . ] DST/DIS SCSI Tape Drive UNIX Software Programmer's Guide FOR Digital Equipment Corporation Digital UNIX Hewlett-Packard HP-UX IBM AIX Silicon Graphics IRIX Sun Microsystems Solaris ® TM 1308911-02 NOTICE The contents of this technical manual have been checked and are believed to be accurate. However, no responsibility is assumed for any inaccuracies in the information provided herein. Ampex Corporation reserves the right to make changes without notice to improve reliability, function or design. TRADEMARKS AIX is a registered trademark of International Business Machines Corporation. All other trademarks and registered trademarks are the property of their respective holders. COPYRIGHT INFORMATION U. S. [. . . ] To change the tape drive block size or the tape device driver debug level, use the dst_setparam_drive utility. dd2_getparam_drive is available to all users. OPTIONS -f <device_special_file> Specifies the device special file to use for the operation (see Appendix B). -n Prevents a trailing newline from being appended to the output stream. If omitted, the output stream includes a trailing newline. ARGUMENTS -help [ help_type ] Displays help on stderr and invalidates all other options, cancelling any other actions. Valid keywords for the optional help_type specification are: stdout, revision, and v_revision. -stdout <output_spec> Specifies the output fields written to stdout. You must provide a -stdout <output_spec> argument except when using the -help argument. Ampex 1308911-02 6-17 Running Head dd2_getparam_drive Model DD-2 Utilities Manual Pages No. The -stdout <output_spec> argument supports the keywords listed below. Some fields can print in verbose or non-verbose style, depending on the keyword specified. Non-verbose style (%keyword) prints only the returned value; verbose style (%v_keyword) replaces the returned value with a descriptive string. If the data for a particular keyword is not available, na prints instead of the value (or string) for that keyword. Bit mask or string representing the current tape device driver debug level. Zero unless tape device driver debug messages have been enabled; see the dd2_setparam_drive manual page for additional details. Value, 0x00000000, 0x00000001, 0x00000002, 0x00000004, 0x00000008, 0x00000010, 0x00000020, 0x00000040, 0x00000080, 0x00000100, 0x00000200, 0x00000400, 0x00000800, 0x00001000, 0x00002000, 0x00004000, 0x00008000, 0x01000000, 0x02000000, 0x04000000, 0x08000000, Debug Level, DST_DBG_NONE, DST_DBG_MODULE, DST_DBG_AUTOCONFIG, DST_DBG_UNIT_ATTN, DST_DBG_OPEN, DST_DBG_CLOSE, DST_DBG_RW, DST_DBG_IOCTL, DST_DBG_RETRY, DST_DBG_INTERRUPT, DST_DBG_PARAMETERS, DST_DBG_RESULTS, DST_DBG_STATUS, DST_DBG_COMMAND, DST_DBG_ABSTRACT, DST_DBG_LOG_SENSE, DST_DBG_TIMING, DST_DBG_ERROR, DST_DBG_ENTRY, DST_DBG_ARGS, DST_DBG_WARNING, Strings ":No debug messages:" ":Module install/remove messages:" ":Autoconfiguration messages:" ":Unit Attention messages:" ":Open() messages:" ":Close() messages:" ":Read/write messages:" ":Ioctl() messages:" ":Retry messages:" ":Interrupt messages:" ":Print command parameters:" ":Print command result info:" ":Print device status info:" ":Device command messages:" ":Abstract interface messages:" ":Log sense info:" ":Timing messages:" ":show error condition:" ":show entry/leave of functions:" ":show arguments:" ":show warning:" %attrib %v_attrib Parameter, DST_NO_REWIND, DST_NO_FM, DST_NO_RESERVE, DST_NO_FLUSH, DST_NO_OPN_CMD, DST_SBLK_SIZE, DST_REWIND_OPN, DST_SPC_FWD, DST_APPEND_ONLY, DST_BYTE_SWAP, DST_DEF_POS_OPN, DST_NO_REFORMAT, DST_SYNC_WRITE, Bit mask or string representing the current device special file interface parameter settings. Value, 0x00000001, 0x00000002, 0x00000004, 0x00000008, 0x00000010, 0x00000020, 0x00000040, 0x00000080, 0x00000100, 0x00000200, 0x00000400, 0x00000800, 0x00001000, Strings ":Do not rewind on close device:" ":Do not write filemarks on close:" ":Do not reserve unit for excl use:" ":Do not flush drive buffer:" ":Do not issue any commands on open:" ":Force user defined block size on open:" ":Rewind on open to BOP:" ":Space forward on close, if not at EOF:" ":Allow writing at EOD only:" ":Swap bytes of all data transferred:" ":If pos undefined on open, set to BOT:" ":No re-formatting of formatted tapes:" ":Sync buffer after every write:" 6-18 Ampex 1308911-02 DD-2 Utilities Manual Pages dd2_getparam_drive DST_ZERO_ON_FM, DST_ZERO_ON_EW, DST_IGN_FM, DST_OPEN_RDONLY, DST_OBSOLETE, DST_WRITE_PROT, DST_OBSOLETE1, DST_OBSOLETE2, DST_OBSOLETE3, 0x00002000, 0x00004000, 0x00008000, 0x00010000, 0x00020000, 0x00040000, 0x00080000, 0x00100000, 0x00200000, ":Set by the O_SYNC open flag:" ":Report zero bytes for read after FM:" ":Ignore FM on first read after open:" ":Opened for read only:" ":obsolete used to be DST_WRITTEN:" ":Cartridge is Write Protected:" ":obsolete1:" ":obsolete2:" ":obsolete3:" ENVIRONMENT The $TAPE environment variable specifies the tape device to use if the -f <device_special_file> option is omitted. EXIT STATUS The dd2 utilities use the following exit status codes, and may also produce output to -stdout on success: 0 nonzero Operation succeeded. Operation failed. A nonzero return value describes the error encountered error during processing (see "Exit Status" on page 6-5). EXAMPLES Display the tape drive data block size. dd2_getparam_drive -stdout "block Size: %blksize" The above example might produce output like this: Block Size: 8192 SEE ALSO "DD-2 Utilities Overview" on page 6-1, dd2_setparam_drive, dst_getparam() Ampex 1308911-02 6-19 Running Head dd2_getpos_tape Model DD-2 Utilities Manual Pages No. 6. 7 NAME dd2_getpos_tape dd2_getpos_tape - get current position and estimated remaining capacity of partition. SYNOPSIS dd2_getpos_tape -stdout <output_spec> [ -f <device_special_file> ] [ -n ] dd2_getpos_tape -help [ help_type ] DESCRIPTION dd2_getpos_tape reports the current tape drive position and the estimated remaining capacity in the partition past the current position. The current position is the data block address at which the next read or write operation occurs; it can be saved for later use with the dd2_setpos_tape utility. The position returned by dd2_getpos_tape does not necessarily reflect the actual physical tape head position. For example, if there is data in the tape drive buffer that has not yet been written to tape, dd2_getpos_tape returns the next buffer position, not the current tape head position. The DD-2 position form consists of a partition ID (PTID), file section number (FSN), and a logical data block number (LDBN). Associated with a DD-2 position are its parent (tape cartridge) volume ID and its absolute double frame number (ADFN). The token position form contains all the position elements given above, packed into an array. dd2_getpos_tape is available to all users. OPTIONS -f <device_special_file> Specifies the device special file to use for the operation (see Appendix B). [. . . ] Electronics Operational Statistics 2 Log Parameters ­ Log Page 33h (Continued) Parameter Code 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 Description Early Detections of PBDFs Unsuccessfully Written1 Late Detections of PBDFs Unsuccessfully Written1 C1 Symbols Corrected During Unsuccessful PBDF Writes, Channel 11 C2 Symbols Corrected During Unsuccessful PBDF Writes, Channel 11 C3 Symbols Corrected During Unsuccessful PBDF Writes1 C3 Generated Erasures During Unsuccessful PBDF Writes1 PB Checksum Failures During Unsuccessful PBDF Writes1 Parity Errors During Unsuccessful PBDF Writes1, 2 Reserved Unsuccessful Physical Block reads1 C1 Symbols Corrected During Unsuccessful PB Reads, Channel 11 C2 Symbols Corrected During Unsuccessful PB Reads, Channel 1 2 C1/C2 Generated Erasures During Unsuccessful PB Reads, Channels A and B2, 5 C3 Symbols Corrected During Unsuccessful PB Reads1 C3 Generated Erasures During Unsuccessful PB Reads 1 PB Checksum Failures During Unsuccessful PB Reads 1 Parity Errors During Unsuccessful PB Reads 1, 2 Reserved Reserved Reserved C1 Symbols Corrected During Successful PBDF Writes, Channel 11 C1 Generated Erasures During Successful PBDF Writes, Channel 11 Reserved Reserved Reserved C1 Symbols Corrected During Successful PB Reads, Channel 11 C1 Generated Erasures During Successful PB Reads, Channel 11 C2 Symbols Corrected During Successful PB Reads, Channel 11 Ampex 1308911-02 E-5 Running Head Operational Statistics Parameters 2 (Log Page 33h) Model No. Electronics Operational Statistics 2 Log Parameters ­ Log Page 33h (Continued) Parameter Code 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 Description C2 Generated Erasures During Successful PB Reads, Channel 11 C1/C2 Generated Erasures During Successful PB Reads, Channel 11, 5 Tracks with SubArea Checksum Failures, Channel 1 Reserved Reserved C1 Generated Erasures During Unsuccessful PBDF Writes, Channel 11 C2 Generated Erasures During Unsuccessful PBDF Writes, Channel 11 PBDF Re-writes Triggered by Channel 1 Reserved C1 Generated Erasures During Unsuccessful PB Reads, Channel 11 C2 Generated Erasures During Unsuccessful PB Reads, Channel 11 Reserved Reserved C1 Symbols Corrected During Successful PBDF Writes, Channel 21 C1 Generated Erasures During Successful PBDF Writes, Channel 21 Reserved Reserved Reserved C1 Symbols Corrected During Successful PB Reads, Channel 21 C1 Generated Erasures During Successful PB Reads, Channel 21 C2 Symbols Corrected During Successful PB Reads, Channel 21 C2 Generated Erasures During Successful PB Reads, Channel 21 C1/C2 Generated Erasures During Successful PB Reads, Channel 21, 5 Tracks With SubArea Checksum Failures, Channel1 Reserved Reserved C1 Generated Erasures During Unsuccessful PBDF Writes, Channel 21 C2 Generated Erasures During Unsuccessful PBDF Writes, Channel 21 E-6 Ampex 1308911-02 Statistics Operational Statistics Parameters 2 (Log Page Table E-3. Electronics Operational Statistics 2 Log Parameters ­ Log Page 33h (Continued) Parameter Code 80 81 82 83 84 85 86 87 Description PBDF Re-writes Triggered by Channel 2 Reserved C1 Generated Erasures During Unsuccessful PB Reads, Channel 21 C2 Generated Erasures During Unsuccessful PB Reads, Channel 21 Reserved Mass Storage Recorder (MSR) Failures With Subsequent MSR Status Request MSR Failures Without Subsequent MSR Status Request Unsuccessful Automatic Self-test Operations - Self-tests are defined as tests that are initiated by the PCF itself, at power up or after the Electronics has been reset. Unsuccessful Diagnostic Commands - Diagnostics are defined as tests that are run as a result of a Diagnostic Built-in Test command. [. . . ]