tjb_move(8) — CLIX 3.1r7.6.28



  tjb_move(8)                         CLIX                         tjb_move(8)



  NAME

    tjb_move - Move the tape in a tape jukebox

  SYNOPSIS

    /usr/ip32/tjb/tjb_move  jb_name  |  -r robotic_path -d drive_path
    from_address  to_address

  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.

    from_address
           The slot or drive address from which a tape is to be moved.

    to_address
           The slot or drive address to which a tape is to be moved.

  DESCRIPTION

    The tjb_move command moves a tape from a slot or drive address to the same
    or another slot or drive address.

    The slots are numbered from bottom to top (1 through 10), and the drive is
    numbered 0.

    The jukebox can be specified either by using the logical jukebox name or
    by specifying the SCSI robotics and drive paths.

  EXAMPLES

    To move the tape jukebox, TJB01 in slot address 4, to the drive at address
    0, key in one of the following commands:

    tjb_move TJB01 4 0

    tjb_move -r /dev/gs/s3u0 -d /dev/gs/s5u0 4 0


  FILES

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

    /etc/TJBCFG             Tape juekbox configuration file.




  2/94 - Intergraph Corporation                                              1



  tjb_move(8)                         CLIX                         tjb_move(8)



  NOTES

    The tjb_move command requires superuser privileges.

  CAUTIONS

    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.

  DIAGNOSTICS

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

    ERROR: No media at specified source location

    Failed to move media from 4 to 0
           There was no tape cartridge at the specified slot address 4.


    ERROR: Destination slot already occupied
           The to address has a tape cartridge.  The tape in the from address
           is replaced in the from slot.


    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.


    ERROR: Door open

    Failed to move media from 0 to 1
           The jukebox door was opened while a move operation was in progress.


    Unit attention detected, performing reset
           A reset is performed before the next command (unless the command is
           tjb_reset or tjb_exercise) if the jukebox door has been opened, or
           a SCSI bus reset has occurred.


    Cartridge in changer, attempting to place in empty slot



  2                                              Intergraph Corporation - 2/94



  tjb_move(8)                         CLIX                         tjb_move(8)



    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_move 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_eject(8), tjb_reset(8)









































  2/94 - Intergraph Corporation                                              3

Museum

Related Articles