tjb_config(8)                       CLIX                       tjb_config(8)



  NAME

    tjb_config - Prints tape jukebox configuration information

  SYNOPSIS

    /usr/ip32/tjb/tjb_config [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_config command prints the configuration information for the
    specified jukebox logical name or SCSI robotics control and drive paths.
    The jukebox can be specified either by using the logical jukebox name or
    by specifying the SCSI robotics and drive paths.

    If no name or paths are specified, the configurations for all tape
    jukeboxes in the configuration file /etc/TJBCFG are displayed.

    The output produced by the tjb_config command contains the following
    information:

    jb name
           Shows the logical name for the tape jukebox.  This name is found in
           the /etc/TJBCFG file and identifies the tape jukebox robotics
           control and drive paths for the jukebox.  If the -r and -d options
           are used, no name will be displayed.

    jb path
           Displays the device name path for the robotics control.

    jb drives
           Displays the number of tape drives supported.

    drive path
           Displays the device name path for the tape drive.

    drive address
           Displays the address of the tape drive and the drive status of
           EMPTY/OCCUPIED.

    slot address
           Shows the address and EMPTY/OCCUPIED status for each slot in which



  2/94 - Intergraph Corporation                                              1

  tjb_config(8)                       CLIX                       tjb_config(8)



           a tape cartridge can be placed.

  EXAMPLES

    To check the configuration file with the jukebox logical name, TJB01, key
    in one of the following commands:

    tjb_config TJB01

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

    The following is the output produced by the tjb_config command:

    JB Info
            jb name   : "TJB01"
            jb path   : "/dev/gs/s3u0"
            jb drives : 1

    Drive Info
            drive path    : "/dev/gs/s5u0"
            drive address : 0       EMPTY

    Slot Info
            slot address : 1        OCCUPIED
            slot address : 2        OCCUPIED
            slot address : 3        EMPTY
            slot address : 4        OCCUPIED
            slot address : 5        OCCUPIED
            slot address : 6        OCCUPIED
            slot address : 7        OCCUPIED
            slot address : 8        OCCUPIED
            slot address : 9        OCCUPIED
            slot address : 10       OCCUPIED


  FILES

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

    /etc/TJBCFG             Tape jukebox configuration file.

  NOTES

    The tjb_config command requires superuser privileges.

  CAUTIONS

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

    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



  2                                              Intergraph Corporation - 2/94

  tjb_config(8)                       CLIX                       tjb_config(8)



    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.


    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

    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_config command exits with a value of 0 if successful.  If
    unsuccessful, it exists with a nonzero value.

  RELATED INFORMATION

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




  2/94 - Intergraph Corporation                                              3

  tjb_config(8)                       CLIX                       tjb_config(8)



    Files:  /etc/TJBCFG





















































  4                                              Intergraph Corporation - 2/94