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