ibm3494(7)

NAME
     ibm3494 - The IBM3494 interface through lmcpd

AVAILABILITY
     SUNWsamfs

DESCRIPTION
     ibm3494 is the Sun QFS and SAM-QFS interface to the IBM 3494
     library.   This  interface utilizes the lmcpd interface sup-
     plied by IBM.  For more  information  on  configuration  and
     interfacing  the  IBM  libraries, see the documentation sup-
     plied with the IBM hardware and for lmcpd.

CONFIGURATION
     It is assumed that the site has the lmcpd daemon  configured
     and operating with the 3494 library.

     The "equipment identifier"  field  in  the  mcf  file,  (see
     mcf(4)),  is the full path name to a parameters file used by
     ibm3494.   This  file  consists  of  keyword  =  value   and
     path_name  =  value pairs.  All keyword/path_name/values are
     case-sensitive.

     The keywords are:

     name    This is the name assigned by the system  administra-
             tor  and configured in the /etc/ibmatl.conf file and
             the symbolic name of the  library.   This  parameter
             must be supplied, there is no default.

     category
             The category is a  hex  number  between  0x0001  and
             0xfeff.  Media controlled by Sun QFS or SAM-QFS will
             have its category set to this  value.   The  default
             for category is 4.

     access  Access to the library may be shared or private.   If
             private,  then  any  media imported into the library
             (category = 0xff00) will be added to the catalog and
             its  category  will  be changed to that specified by
             category above.  If shared, then the import  command
             (see  import(1M))  will have to be used to add media
             to the catalog.  The default for access is private.

     device_path_name
             There is one device_path_name entry for every  drive
             in  the library attached to this machine.  This name
             must match the Equipment Identifier of an  entry  in
             the mcf file.  Following the device_path_name is the
             "device number" as described in the  IBM  documenta-
             tion.   The  system administrator can determine this
             number by running the IBM  supplied  utility  mtlib.

             Following the device number is the shared parameter.
             This parameter is optional and is used  to  indicate
             the  drive  is  shared with other Sun QFS or SAM-QFS
             servers. See examples below.

EXAMPLE
     The example uses the following file and information obtained
     from  the IBM supplied utility mtlib. Both are documented in
     the materials supplied by IBM.

     #
     # This is file: /etc/ibmatl.conf
     # Set this file up according the documentation supplied by IBM.
     3493a   198.174.196.50  test1

     After lmcpd is running, run mtlib to get the device numbers.

          mtlib -l 3493a -D
            0, 00145340 003590B1A00
            1, 00145350 003590B1A01

     Here is a sample parameters file and mcf entries for  a  IBM
     3494 library.

          #
          # This is parameters file /etc/opt/SUNWsamfs/ibm60.
          #
          name = 3493a                     # From /etc/ibmatl.conf
          /dev/rmt/1bn = 00145340          # From mtlib output
          /dev/rmt/2bn = 00145350 shared   # From mtlib output
          access=private
          category = 5

          # These are the mcf file entries.
          #
          # IBM 3494 library
          #
          /etc/opt/SUNWsamfs/ibm60 60   im   ibm3494e - ibmcat
          /dev/rmt/1bn             61   tp   ibm3494e
          /dev/rmt/2bn             62   tp   ibm3494e

IMPORT/EXPORT
     Import media into the library by placing the new media  into
     the  I/O  slots and closing the door.  The library will lock
     the door and move the media into the storage area. Only  100
     volumes  can  be  imported  at one time.  If you are running
     with access=private, the library will inform the  daemon  as
     the  media is moved and the media will be added to the cata-
     log.  If running with access=shared,  then  an  import  (see
     import(1M))  command  will  need  to  be executed to add the
     media to the catalog.

     Exporting media (in all modes) is performed  by  the  export
     (see  export(1M)) command.  This command will move the media
     to the I/O area and the output mode light  on  the  operator
     panel  will  light.   The operator can then remove the media
     from the I/O area.

CATALOG
     If running with access=shared then a catalog will need to be
     built  before  starting  Sun  QFS or SAM-QFS.  There are two
     utilities used to maintain the library  catalog.   build_cat
     (see  build_cat(1M)) is used to build the catalog.  dump_cat
     (see dump_cat(1M)) and build_cat together are used to change
     the size of the catalog.

     To initialize a catalog with 1000 slots run:

          build_cat /tmp/catalog_file < /dev/null

     then move /tmp/catalog_file to the path pointed  to  in  the
     mcf    file    for    this    library.     (In   this   case
     /var/opt/SUNWsamfs/catalog/ibmcat).  Use import to  populate
     the  catalog  with  the  volumes.  Or, you can create a file
     with the list of volumes and supply it as input to build_cat
     (see build_cat(1M) for the format of the input file).

     If the size of the catalog needs to  be  increased,  execute
     something like:

          dump_cat file1 | build_cat -s 2000 /tmp/file2

     This would create a new catalog file (/tmp/file2) with  room
     for  2000  entries  and  initialize it with the entries from
     file1.  This can only be done when the Sun  QFS  or  SAM-QFS
     software  is not running and sam-amld has been shutdown (see
     sam-amld(1M)).

FILES
     mcf                           The configuration file for the
                                   Sun QFS and SAM-QFS software.

     /etc/ibmatl.conf              Configuration  file  used   by
                                   lcmpd.

     /opt/SUNWsamfs/lib/libibmlmcp.so
                                   A shared object version of the
                                   runtime  library  supplied  by
                                   IBM

SEE ALSO
     build_cat(1M), dump_cat(1M),  export(1M),  import(1M),  sam-
     robotsd(1M).
    (mcf(4).