Content-type: text/html Man page of CDI_TA

CDI_TA

Section: Maintenance Commands (8)
Updated: Dec 11, 01m
Index Return to Main Contents
 

NAME

cdi_ta - get TapeAlert information from or set TapeAlert on a tape device  

SYNOPSIS

cdi_ta
-f device [ -d ] [ -i interval ] [ -l ] [ -m MRIE ] [ -n testflag ] [ -s ] [ -v ] [ -t { s | t | g | n | m | i } ]
 

DESCRIPTION

The cdi_ta program gets from or sets TapeAlert information on a tape device. The cdi_ta program also returns the status of the named SCSI device (specified by the -f option). Note that not all devices support the TapeAlert feature. If the device does not support the TapeAlert feature or the TapeAlert data returned by the device is invalid, cdi_ta will return the status CDI_IOCTL_ERROR (11). The set TapeAlert operation is currently not functional.  

OPERANDS

-f
device
Specifies the device to send the ta SCSI command to.
 

OPTIONS

-d
Set the DExcept field to 1. If set to 1, disable all informational exception operations and ignore the MRIE field. The software must poll the TapeAlert log page. The default value for the DExcept field is 0.
-i
interval
Set the interval timer for reporting exception conditions. If interval is set to 0, report informational exception conditions only once. The default value for the interval timer is 0.
-l
Set what types of exception conditions are logged. If set to 0, which is the default, log only vendor specific exception conditions. This flag sets the log error condition to 1. The default is 0. Currently, only the values 0 and 1 are supported.
-m
MRIE
Define the method used to report informational exception conditions. Values of 0x0 through 0x5 for the MRIE are defined as:


VALUE   METHOD

0x0No reporting

0x1Asynchronous event reporting

0x3Conditionally generate recovered error

0x4Unconditionally generate recovered error

0x5Generate no sense

0x6Only report informational exception conditions on request



Currently, only value 0x0 is supported.  The default value for
the MRIE field is 0.
-n
testflag
Set or clear the TapeAlert test flag in the log page. If testflag is between the values 1 and 64, set the TapeAlert flag in the log page to the value of testflag. If testflag is between the values -1 and -64, clear the TapeAlert flag in the log page to the value of testflag. If testflag is equal to 32727 (0x7FFF), set all TapeAlert flags in the log page. The default value for testflag is 0.
-s
Set TapeAlert data. If this flag is not specified, the program will get TapeAlert data.
-t
Use the -t option to specify the method of tape functions to use for the get/set TapeAlert SCSI command. If the -t option is not specified, the default method is to use the OS tape driver SCSI passthrough functions. Please refer to the libcdi (1m) manpage for the complete list of access methods currently supported by the cdi_ta program.
-v
Run the program in verbose mode. This option will print out the version number of the CDI library used by the program.
 

EXAMPLES

Sample output including drive status information:



% cdi_ta -f /dev/rmt/2cbn
CDI Get_TapeAlert returns:
(only flags that are SET will be shown)
Tape Critical flags:
Tape Warning flags:
Tape Information flags:
Changer Critical flags:
Changer Warning flags:
Changer Information flags:
_info.drivestat is:
status = 1, DRIVE_STATUS_NO_ERROR
msg = Drive reports no error - but state is unknown
 

SEE ALSO

libcdi(1m)


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPERANDS
OPTIONS
EXAMPLES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:37:04 GMT, October 02, 2010