tjb_eject(8)                        CLIX                        tjb_eject(8)



  NAME

    tjb_eject - Ejects the tape from the tape jukebox drive

  SYNOPSIS

    /usr/ip32/tjb/tjb_eject  jb_name  |  -r robotic_path  -d drive_path

  FLAGS

    -r robotic_path
           Defines device path of the robotics control port for the tape
           jukebox.

    -d drive_path
           Defines device path of the tape drive for the tape jukebox.

  DESCRIPTION

    The tjb_eject command causes the tape for the specified jukebox tape drive
    to be unloaded.

    The jukebox can be specified either by using the logical jukebox name or
    by specifying the SCSI robotics and drive paths.  See tjb_config(8) for
    more information on the logical jukebox name.

  EXAMPLE

    To eject the tape cartridge from the tape jukebox, TJB01, key in one the
    following commands:

    tjb_eject TJB01

    tjb_eject -r /dev/gs/s3u0 -d /dev/gs/s5u0

    If there is no tape in the drive, an error message will not be displayed.

  FILES

    /dev/gs/s?u?            Robotics and tape device files.  /dev/rmt/mt?

    /etc/TJBCFG             Tape juekbox configuration file.

  NOTES

    The tjb_eject command requires superuser privileges.

  CAUTIONS

    The system must be shut down before powering off the jukebox.




  2/94 - Intergraph Corporation                                              1

  tjb_eject(8)                        CLIX                        tjb_eject(8)



    The tjb commands check if the drive (/dev/rmt/mt?) is in use only at the
    beginning of the command.  If any tape operation is started after a tjb
    command is initiated, the tjb command may eject the tape from the drive
    and cause a no media in drive error for the tape operation.

    If the drive door is closed without a tape in the drive, a no media in
    drive message displays on the console and the user must manually open the
    drive door.

  DIAGNOSTICS

    The following is a list of common error messages and their meanings:

    No information for jukebox "MY_TJB" in configuration file
           The logical name MY_TJB cannot be found in /etc/TJBCFG.  The
           configuration file may be missing the =,  {,  or  } characters.


    get_status: Device busy

    Failed to get drive status information
           If the tape drive door is closed, the file /dev/rmt/mt* is checked
           to see if the drive is in use.


    Unit attention detected, performing reset
           A reset is performed, and the tape is moved to the first empty
           slot.


    Cartridge in changer, attempting to place in empty slot

    Cartridge placed in slot 3
           The jukebox door was opened, or a SCSI bus reset has occurred while
           the cartridge handler mechanism had a cartridge retrieved.  The
           cartridge is placed in the first empty slot found.

  EXIT VALUES

    The tjb_eject command exits with a value of 0 if successful.  If
    unsuccessful, it exists with a nonzero value.

  RELATED INFORMATION

    Commands:  tjb_config(8),  tjb_exercise(8),  tjb_move(8), tjb_reset(8)









  2                                              Intergraph Corporation - 2/94