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. DEC is a trademark of Digital Equipment Corporation. [. . . ] String that returns the default cumulative parameter values. String that returns the threshold parameter values. String that returns the cumulative parameter values. Specifies service statistics (see Appendix E, Table E-1). Specifies transport module operational statistics (see Appendix E, Table E-2). Specifies electronics module operational statistics (see Appendix E, Table E-3). Specifies diagnostic status (see Appendix D). 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). Ampex 1308911-02 6-15 Running Head dd2_getlog_drive Model DD-2 Utilities Manual Pages No. EXAMPLE Obtain the cumulative value of service operational data from the drive and store it in the file log. ser. dd2_getlog_drive -log :Cumulative: -stdout %optm > log. ser The output file might look something like: OSP_1:Small Cassette Loads/Unloads OSP_1:Medium Cassette Loads/Unloads OSP_1:Large Cassette Loads/Unloads OSP_1:Scanner Timeouts OSP_1:Cleaning Cassette Operations OSP_1:Tape Threaded Forward OSP_1:Tape Threaded Reverse OSP_1:Tape Unthreaded Forward OSP_1:Tape Unthreaded Reverse OSP_1:Tape In Data Transfer OSP_1:Tape Position Start/Stops OSP_1:Tape Data Transfer Start/Stops OSP_1:Positioning And Address Errors OSP_1:Missing Control Track Pulses OSP_1:Physical Addr Track CRC Failures OSP_1:Logical Addr Track CRC Failures = = = = = = = = = = = = = = = = 1370 1 51 0 0 0 FT 0 FT 0 FT 0 FT 0 FT 0 0 0 0 0 0 SEE ALSO "DD-2 Utilities Overview" on page 6-1, dd2_clrlog_drive, dst_getlog() 6-16 Ampex 1308911-02 DD-2 Utilities Manual Pages dd2_getparam_drive 6. 6 NAME dd2_getparam_drive dd2_getparam_drive - get tape drive data block size, tape device driver debug level, and device special file interface parameter settings. SYNOPSIS dd2_getparam_drive -stdout <output_spec> [ -f <device_special_file> ] [ -n ] dd2_getparam_drive -help [ help_type ] DESCRIPTION dd2_getparam_drive reports the current tape drive data block size, tape device driver debug level, and device special file interface parameter settings. The interface parameters specify default behavior for the tape drive. They are set according to the device special file selected. 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. %blksize %dbglevel %v_dbglevel Data block size in bytes. The block size does not include the two-byte checksum, if any. [. . . ] There may be several attempts required by the MSR to do so, all resulting in the recording of PBDFs. When the last attempt is successful according to the rewrite criteria, the data received by the MSR has been recorded as a single PB to tape. A recorded PB is included in the number of recorded PBDFs. To retrieve data from a recorded PB, the MSR may have to read several PBDFs, of which the last one only contains the data returned to the MSI for a successfully retrieved PB. [. . . ]