sam-sony_helper(1M)

NAME
     sony - Attaches a Sony network-attached tape library through
     the DZC-8000S interface

AVAILABILITY
     SUNWsamfs

DESCRIPTION
     The SAM-QFS software package contains the Sun QFS and SAM-
     QFS interface to a Sony network-attached library.  This
     interface uses the DZC-8000S 3.01 interface supplied by
     Sony.  For more information on DZC-8000S, see the Sony
     PetaSite Application Interface DZC-8000S manual.  This
     manual is supplied by Sony.

CONFIGURATION
     It is assumed that the site has the PetaSite Controller
     (PSC) configured and operating with the Sony library.  In
     the Execute Mode of the PSC configuration, the following
     must be set to on:

     o  Thread With Load

     o  Unthread with Fast Unload

     o  Unthread with Eject

     o  Wait for Drive Use

     The Equipment Identifier field in the Sun QFS or SAM-QFS mcf
     file must be the full path name to a Sony parameters file.
     For more information on specifying a parameters file, see
     the mcf(4) man page.

     The parameters file consists of a list of keyword = value
     pairs.  All keyword and value specifications are
     case-sensitive and must be entered as shown on this man
     page.  The keyword and value specifications are as follows:

     userid = userid
               Identifies the user during initialization of the
               Sony library functions.  The userid values can be
               specified in hexadecimal or decimal.  The valid
               range is from 0 to PSCUSERIDMAX(0xfff), which is 0
               <= userid <= 65535 (decimal) or 0 <= userid <=
               0xffff (hexadecimal).  This is a required
               parameter.

     server = serverid
               Specifies the host name of the server running the
               PSC server code.  This is a required parameter.

     sonydrive binnum = path [ shared ]
               Specifies characteristics of the tape drive.
               There must be one sonydrive line for every drive
               assigned to Sun QFS or SAM-QFS in the mcf file.
               This name must match the Equipment Identifier of
               an entry in the mcf file.

               The following arguments follow the sonydrive
               keyword:

               binnum    Specifies the bin number assigned to the
                         drive in the PSC configuration. The bin
                         number can be identified using the PSC
                         Monitoring and Maintenance terminal.
                         This is a required argument.

               path      Specifies the Solaris /dev/rmt/ path
                         name to the device.  The path must match
                         the Equipment Identifier of an entry in
                         the mcf file.  This is a required
                         argument.

               shared    Specifies that this drive is shared with
                         other processes.  For example, this
                         drive can be shared between multiple Sun
                         QFS or SAM-QFS servers.  This is an
                         optional argument.

EXAMPLE
     The following example shows the configuration files for a
     network-attached Sony library with Sony DTF tapes.

     Here are the sample entries in the mcf file. The catalog
     file is placed in the default directory, which is
     /var/opt/SUNWsamfs/catalog.

     The mcf file is as follows:

     #
     # This is the file: /etc/opt/SUNWsamfs/mcf
     # This file shows sample mcf entries for a Sony network-attached
     # robot with Sony DTF tapes.
     #
     /etc/opt/SUNWsamfs/sonyfile 50 pe sony50 on /var/opt/SUNWsamfs/sony50cat
     /dev/rmt/0cbn              51 so sony50 on
     /dev/rmt/1cbn              52 so sony50 on

     The parameters file for a Sony library supporting Sony DTF
     tapes is as follows:

     #
     # This is file: /etc/opt/SUNWsamfs/sonyfile

     #
     # The userid identifies the user during initialization of
     # the PetaSite library functions. Valid IDs are 0 to
     # PSCUSERIDMAX(0xfff).
     #
     userid = 65533
     #
     # The server identifies the hostname for the server running
     # the DZC-8000S server code.
     #
     server = europa
     #
     # The sonydrive bin number 1001 is from the PSC configuration file
     #
     sonydrive 1001 = /dev/rmt/0cbn shared  # a comment
     #
     # The sonydrive bin number 1002 is from the PSC configuration file
     #
     sonydrive 1002 = /dev/rmt/1cbn         # a comment

IMPORT/EXPORT
     The physical adding and removing of cartridges in a Sony
     network-attached library is accomplished using the PSC
     utilities.  The import(1M) and export(1M) commands affect
     only the library catalog.  Therefore, importing and
     exporting cartridges with the Sony network-attached library
     proceeds according to the following two-step process:

     1. Physically import or export the cartridge using the PSC
        software.

     2. Virtually update the library catalog using the Sun QFS or
        SAM-QFS import/export utilities.

     The import(1M) command has an optional -v option that allows
     you to specify the VSN to be added.  The samsony package
     verifies that PSC knows about the VSN before updating the
     catalog with the new entry.  The export(1M) command removes
     the entry from the catalog.

CATALOG
     There are several methods for building a catalog for a Sony
     network-attached library.  You should use the method that
     best suits your system configuration, typically depending on
     the size of the catalog that is needed.

     Method 1: Create a catalog with existing VSN entries.  You
     can build a catalog that contains entries for many tapes by
     using the build_cat(1M) command.  As input to the
     build_cat(1M) command, you need to create a file that
     contains the slot number, VSN, bar code label, and media
     type.  For example, the file input_vsns follows:

     0  "SEG001"  "SEG001"  so
     1  "SEG002"  "SEG002"  so
     2  TEST1     TEST1     so
     3  TEST2     TEST2     so

     The input_vsns file can be used as input to the
     build_cat(1M) command as follows:

     build_cat input_vsns /var/opt/SUNWsamfs/sony50cat

     Method 2: Create a null catalog and import VSN entries.  You
     can create an empty catalog and populate it.  To create a
     catalog that will accommodate 1000 slots, use the
     build_cat(1M) command as follows:

     build_cat -s 1000 /dev/null /var/opt/SUNWsamfs/catalog/sony50cat

     Use the import(1M) command to add VSNs to this catalog, as
     follows:

     import -v "SEG005" 50

     Method 3: Use the default catalog and import VSN entries.
     If a catalog path name is not specified in the mcf file, a
     default catalog is created in
     /var/opt/SUNWsamfs/catalog/family_set_name when Sun QFS or
     SAM-QFS is initialized.  Following initialization, you must
     import VSN entries to this catalog by using the import
     command as follows:

     import -v "SEG005" 50

     In the previous import(1M) command, 50 is the Equipment
     number of the library as specified in the mcf file.

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

     /opt/SUNWsamfs/lib/libpsc.so
                              The PSC library supplied by Sony.

     /opt/SUNWsamfs/sbin/sony_helper
                              A program to issue commands to the
                              Sony PSC.

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

     mcf(4).