home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / a_man / cat1 / stacker.z / stacker
Encoding:
Text File  |  2002-10-03  |  10.2 KB  |  199 lines
  1.  
  2.  
  3.  
  4. ssssttttaaaacccckkkkeeeerrrr((((1111MMMM))))                                                        ssssttttaaaacccckkkkeeeerrrr((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      stacker - robotics control program
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ssssttttaaaacccckkkkeeeerrrr [----DDDD...] ----cccc [_d_e_v_i_c_e]
  13.      ssssttttaaaacccckkkkeeeerrrr [----DDDD...] ----llll _b_i_n_n_u_m_b_e_r [----dddd_d_r_i_v_e_n_u_m_b_e_r] [_d_e_v_i_c_e]
  14.      ssssttttaaaacccckkkkeeeerrrr [----DDDD...] ----uuuu _b_i_n_n_u_m_b_e_r [----dddd_d_r_i_v_e_n_u_m_b_e_r] [_d_e_v_i_c_e]
  15.      ssssttttaaaacccckkkkeeeerrrr [----DDDD...] ----ffff _f_r_o_m_b_i_n_n_u_m_b_e_r ----tttt _t_o_b_i_n_n_u_m_b_e_r [_d_e_v_i_c_e]
  16.  
  17. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      _s_t_a_c_k_e_r is an administrative utility used to move tapes between a robotic
  19.      tape library's slots and drive(s).  _s_t_a_c_k_e_r currently supports the
  20.      Exabyte 10i and 10e, the DLT2500, DLT2500xt, DLT2700, DLT2700xt, DLT4500,
  21.      DLT4700, the IBM Magstar (3590) and IBM Magstar MP (3570), the SGI DLT-
  22.      7000 autoloader (Minivault), the Fujitsu Computer Products of America
  23.      (FCPA) M1016/M1017, M2483 and M2488 3480/3490 drives, and all tape robots
  24.      that conform to the SCSI-2 Medium Changer command set.
  25.  
  26.      The _d_e_v_i_c_e argument is used to specify the special device that will be
  27.      used to control the stacker.  This argument can be ignored if the
  28.      environment variable SSSSTTTTAAAACCCCKKKKEEEERRRR____DDDDEEEEVVVV is set.  The command line specification
  29.      of a device overrides the environment variable.
  30.  
  31.      The special device nodes used to control tape robots can be found in the
  32.      directory /_d_e_v/_s_c_s_i.  (See _d_s(_7_M) for more information.)  The entry that
  33.      corresponds to the SCSI bus and target ID of the robotic control
  34.      interface should be used.  For example, the SGI DLT-7000 autoloader and
  35.      Exabyte 10i have  a SCSI target ID separate from its internal tape drive.
  36.      The the DLT2500 and DLT2700 uses the same SCSI target ID (wih different
  37.      LUN) as their associated tape drive. The IBM 3590 can also be configured
  38.      in a similar fashion.
  39.  
  40.      The _h_i_n_v(_1_M) utility will list any robotic device that uses a separate
  41.      LUN in the following form (with X, Y and Z set to the appropriate
  42.      values):
  43.  
  44.           Jukebox: unit X, lun Y on SCSI controller Z
  45.  
  46.      This program requires root privilege to access the /_d_e_v/_s_c_s_i devices.  If
  47.      non-privileged access is required to the robot, simply change the
  48.      permissions on the /_d_e_v/_s_c_s_i device controlling the stacker.  (See
  49.      _c_h_m_o_d(_1).)
  50.  
  51. FFFFUUUUJJJJIIIITTTTSSSSUUUU DDDDRRRRIIIIVVVVEEEE AAAANNNNDDDD RRRROOOOBBBBOOOOTTTT IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  52.      The Fujitsu devices use half-inch tape cartridges.  The M1016/M1017 are
  53.      18-track IBM 3480-compatible drives, and do not use the SCSI-2 Medium
  54.      Changer command set.  The M2483 is a 36-track IBM 3490-compatible drive.
  55.      The M2488 is like the M2483, but includes SCSI-2 Fast and Wide support.
  56.  
  57.      The Fujitsu devices all use the same SCSI target ID for tape and robotic
  58.      control.  However, while the M1016/M1017 use SCSI LUN 0 for both tape and
  59.      robotic control, the M2483 and M2488 devices use LUN 0 for the tape and a
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ssssttttaaaacccckkkkeeeerrrr((((1111MMMM))))                                                        ssssttttaaaacccckkkkeeeerrrr((((1111MMMM))))
  71.  
  72.  
  73.  
  74.      separate LUN for the robot.  The robot LUN is changeable, but is set to 4
  75.      at the factory.
  76.  
  77.      The Fujitsu robotic control is actually performed with what is called an
  78.      autoloader.  An autoloader is dedicated to a single drive, as opposed to
  79.      being able to potentially handle multiple drives like the other robotic
  80.      devices.
  81.  
  82.      Fujitsu autoloaders use a tape magazine.  The Automatic Cartridge Loader
  83.      (ACL) style of autoloader accepts a 5- or 10-tape magazine, and is
  84.      available with all the drive models.  The Flush-mounted ACL (FACL) style
  85.      accepts a 7-tape magazine, and is available on only the M2483 and M2488.
  86.  
  87.      Unlike the other robotic devices described herein, the Fujitsu model
  88.      numbers do not indicate if the tape drive is equipped with a tape robot.
  89.      Invoking _s_t_a_c_k_e_r for a Fujitsu M1016/M1017 that is not equipped with an
  90.      autoloader causes the following message to be displayed:  "ERROR: Fujitsu
  91.      M1016/M1017 drive lacks autoloader."  This is done because this is the
  92.      only device discussed here for which it is not possible to determine the
  93.      existence of a robotic device from either the device's model number or
  94.      the output of _h_i_n_v(_1_M).
  95.  
  96. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  97.      All bins are numbered starting from 1 to the number supported by the
  98.      device.  The internal tape drives (if there are more than one) are
  99.      numbered starting at 1 as well.  For example, the Odetics 2640 library's
  100.      bins are numbered from 1 to 264, and its tape drives are numbered from 1
  101.      to 3.
  102.  
  103.      ----DDDD...   Print debugging output in increasing levels of detail.
  104.  
  105.      ----cccc      Print the configuration of the device.  This includes the number
  106.              of bins, the number of tape drives, the number of import/export
  107.              ports, and the number of robotic arms.
  108.  
  109.      ----llll _b_i_n_n_u_m_b_e_r [----dddd _d_r_i_v_e_n_u_m_b_e_r]
  110.              Load a tape from the specified bin into the specified tape drive.
  111.              If the drive number is not specified, drive number 1 is used.
  112.  
  113.      ----uuuu _b_i_n_n_u_m_b_e_r [----dddd _d_r_i_v_e_n_u_m_b_e_r]
  114.              Unload a tape from the specified tape drive into the specified
  115.              bin.  If the drive number is not specified, drive number 1 is
  116.              used.  The Fujitsu M2483 autoloader can only unload a tape
  117.              cartridge to the slot from which the medium was originally
  118.              loaded.  The operator is informed of this limitation upon any
  119.              such unload request with the following message:  "NOTE: Fujitsu
  120.              M2483 request handled as unload to original medium slot."
  121.  
  122.      ----ffff _f_r_o_m_b_i_n_n_u_m_b_e_r ----tttt _t_o_b_i_n_n_u_m_b_e_r
  123.              Move a tape from (----ffff) one bin to (----tttt) another bin.  The
  124.              autoloaders on the Fujitsu M1016/M1017 and M2483 drives do not
  125.              support this option.  If attempted, the error message "autoloader
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ssssttttaaaacccckkkkeeeerrrr((((1111MMMM))))                                                        ssssttttaaaacccckkkkeeeerrrr((((1111MMMM))))
  137.  
  138.  
  139.  
  140.              cannot perform bin-to-bin movement" will be displayed.
  141.  
  142. NNNNOOOOTTTTEEEESSSS
  143.      The DLT2700 must have the mode select key set to automatic in order for
  144.      the software to be able to control the stacker's robotics.  Automatic
  145.      mode is represented by a square made of arrows.
  146.  
  147.      The IBM Magstar MP stacker must be in the "Random" or "Random (2-LUN)"
  148.      mode to be controllable by the software. This mode is configured via the
  149.      control panel on the 3590 drive. When set to 2-LUN mode, the drive will
  150.      be LUN 0, and the stacker is LUN 1. In "Random" mode, only LUN 0 exists
  151.      and stacker operations must be directed there.
  152.  
  153.      As a Fujitsu autoloader is dedicated to a single drive, and since the
  154.      drive number parameter defaults to 1, the ----llll and ----uuuu options never need to
  155.      include a Fujitsu drive number.
  156.  
  157.      The SGI DLT-7000 autoloader (Minivault) is also dedicated to a single
  158.      drive and hence the drive number need not be specified.  The SGI DLT-7000
  159.      autoloader is shipped from the factory with the loader set for target ID
  160.      1, and the drive set for target ID 2. These may have been changed at your
  161.      individual site.
  162.  
  163.      The Fujitsu M1016/M1017 device's SCSI command to move media into or out
  164.      of a bin contains no load or unload field.  Its operation is dependent on
  165.      the state of the referenced bin and the device's single drive.  Issuance
  166.      of this command results in a drive load operation if the bin contains a
  167.      tape, an unload operation if the drive contains a tape from that bin, or
  168.      an error if the bin was empty when the magazine was inserted into the ACL
  169.      or FACL.  If a tape loaded from another bin is in the drive when this
  170.      command is issued, this tape is automatically unloaded to its originating
  171.      bin before the tape in the referenced bin is loaded.
  172.  
  173.      Hence, the ----llll and ----uuuu options can be used interchangeably with the Fujitsu
  174.      M1016/M1017.  The result of issuing either command will be a load or
  175.      unload operation, as appropriate for the current state of the bin
  176.      referenced.
  177.  
  178. BBBBUUUUGGGGSSSS
  179.      The DLT2700 does not respond to some error conditions with the expected
  180.      SCSI error messages.  For example, moving a tape to a bin that is already
  181.      occupied will result in an "invalid field in CDB" message (that is the
  182.      error returned by the 2700) rather than a "destination element full"
  183.      message.
  184.  
  185. FFFFIIIILLLLEEEESSSS
  186.      /dev/scsi/sc*
  187.  
  188. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  189.      chmod(1), ds(7M), hinv(1M).
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.