sony - Attaches a Sony network-attached tape library through
the DZC-8000S interface
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.
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
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
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
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
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
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
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
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
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.
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
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.
mcf The configuration file for the Sun
QFS and SAM-QFS software.
The PSC library supplied by Sony.
A program to issue commands to the
build_cat(1M), dump_cat(1M), export(1M), import(1M), sam-