tapealert(1) General Commands Manual tapealert(1) NNAAMMEE ttaappeeaalleerrtt - TapeAlert log page retrieval utility SSYYNNOOPPSSIISS ttaappeeaalleerrtt [--dd _d_e_v_i_c_e_n_a_m_e] _o_p_t_i_o_n_(_s_) _._._. DDEESSCCRRIIPPTTIIOONN ttaappeeaalleerrtt is used to report errors from a tape device. If _d_e_v_i_c_e_n_a_m_e is not specified, a platform specific device file is used. For more details on TapeAlert, please see the SureStore DDS Tape User Manual or HP DDS Technical Manual (Volume 3) as appropriate. ttaappeeaalleerrtt accepts the following _o_p_t_i_o_n_s _-_d Specifies a different device from the platform default (see be- low for defaults) _-_o Reports any errors found to _s_t_d_o_u_t _-_e Reports any errors found to _s_t_d_e_r_r _-_b Reports any errors found to both _s_t_d_e_r_r and _s_t_d_o_u_t _-_f _f_i_l_e Reports any errors found into _f_i_l_e_, appending if already present _-_m _p_e_r_s_o_n_@_h_o_s_t Mails any errors found to _p_e_r_s_o_n_@_h_o_s_t _-_h Print command line usage and exit ttaappeeaalleerrtt returns EXIT_SUCCESS (0) exit status when there were no TapeAl- ert logs found set, EXIT_FAILURE (1) in the case that an internal opera- tion failed and -1 if any TapeAlert logs were found to be set. By default, if no other output medium is specified, then errors are re- ported back via the syslog interface at the levels LOG_INFO, LOG_WARNING, LOG_CRIT for increasing severity. FFIILLEESS Appropriate device files for a given platform are suggested below: HP-UX _/_d_e_v_/_r_m_t_/_* Default is /dev/rmt/c0t3d0BESTnb Sun Solaris _/_d_e_v_/_r_m_t_/_[_0_-_9_]_* Default is /dev/rmt/0bn IBM AIX _/_d_e_v_/_r_m_t_[_0_-_9_]_._[_0_-_9_] Default is /dev/rmt0.1 SCO OpenServer _/_d_e_v_/_x_S_t_p_# Default is /dev/xStp0 DEC OSF/1 _/_d_e_v_/_[_n_]_r_m_t_#_{_l_,_m_,_h_,_a_} Default is /dev/tape Silicon Graphics IRIX _/_d_e_v_/_s_c_s_i_/_s_c_#_d_#_l_# Default is /dev/scsi/sc0d3l0 EEXXAAMMPPLLEESS Report if any errors on tape /dev/rmt/4mnb via syslogd: % tapealert -d /dev/rmt/4mnb Report if any errors found on /dev/rmt/5mnb to the user root@ithilien: % tapealert -d /dev/rmt/5mnb -m root@ithilien Perform a tar of current directory contents and then check if errors re- ported, both to stderr and mailing to root on the current host: % tar cvf /dev/rmt/5mnb ./* % tapealert -d /dev/rmt/5mnb -b | mail root WWAARRNNIINNGGSS You can only specify one location for the errors to be reported to. If there is a SCSI connection error, then contact may not be able to be made with the drive, in such instances, the error reporting may be less than helpful in diagnosing this as the fault. The '-b' option is intended for shell plumbing. Failure to do something different with redirection may result in twice as much output to your terminal. BBUUGGSS Users of Solaris 2.4 or 2.5 should note that media has to be present in order for ttaappeeaalleerrtt to be able to communicate with the drive. This is a driver limitation that may be removed in a future release. AAUUTTHHOORR ttaappeeaalleerrtt was developed by Hewlett-Packard Limited. SSEEEE AALLSSOO HP-UX _m_t_(_7_)_, _s_c_s_i___c_t_l_(_7_)_, _s_y_s_l_o_g_(_3_C_)_, _s_y_s_l_o_g_d_(_1_M_)_. Sun Solaris _m_t_i_o_(_7_I_)_, _s_t_(_7_d_)_, _s_y_s_l_o_g_(_3_)_, _s_y_s_l_o_g_d_(_1_M_)_. IBM AIX _m_t_(_1_)_, _s_y_s_l_o_g_(_3_)_, _s_y_s_l_o_g_d_(_1_)_. SCO OpenServer 5 _d_a_t_(_H_W_)_, _S_t_p_(_H_W_)_, _t_a_p_e_(_H_W_)_. DEC OSF/1 _m_t_(_1_)_, _m_t_i_o_(_7_)_, _t_z_(_7_)_, _s_c_u_(_8_)_. Silicon Graphics IRIX _t_p_s_(_7_M_)_, _d_s_(_7_M_)_, _m_t_(_1_)_, _s_y_s_l_o_g_(_3_C_)_, _s_y_s_l_o_g_d_(_1_M_)_. UNIX May 25, 1997 3