juke(HW)
juke --
operate a SCSI media changer
Syntax
juke operation [device]
Description
The information on this page is provided for compatibility with
applications built on previous releases.
See the
mc01(HW)
manual page for a description of the Release 6 interface, which also
supports the functionality described on this page.
The juke utility sends a command to a
SCSI media changer (or ``juke box'') device to
move data media between its various elements. The
device argument defaults to /dev/Sjk0,
the first media changer defined in the system.
Supported operations are:
elem-
List the internal elements of the media changer.
(The SCSI-2 media changer model defines four physical parts,
or ``elements'', for juke box devices.
The physical configuration of these elements should be defined in the
hardware manual supplied with the device.)
The elem operation displays elements using the following codes:
dt
N-
Data transfer element;
an embedded SCSI peripheral device (such as a
tape or CD-ROM drive) which is
capable of reading or writing a data medium.
Medium changer devices normally contain one or more data transfer elements.
ie
N-
Import/export element;
a special storage location where a human operator or another
media changer can insert or remove a data medium using an
access door or external loader mechanism.
A media transport element moves data media between an import/export
element and storage elements and data transfer elements which are
usually not accessible externally.
A media changer device may have zero or more import/export
elements.
mt
N-
Medium transport element;
a robotic mechanism which moves data media between storage
elements, data transfer elements, and import/export elements.
If a media changer device defines one or more media transport
elements, these can be used as temporary holding places for data media.
If a media changer device does not define a media transport element,
data media are transferred directly between storage elements and data
transfer elements.
st
N-
Storage element;
a location or ``slot'' in a carousel, tape holder, or magazine
which can contain a data medium.
It is not a data medium (such as a tape or a CD).
Medium changer devices typically contain four or more storage elements.
N is a number from 0 to 255 representing different elements
of a given type within a media changer device.
If no entries are shown for an element type, the media changer does not
contain such an element.
lock-
Disable the front panel controls of the media changer.
move source destination-
Move data medium from a source element to
a destination element.
pos stN-
Position medium transport element ``mt0'' in front of ``stN''.
This places the media transport ready to retrieve a
data medium from the specified storage element.
It does not transfer any data medium to the media transport.
reset-
Perform a hardware reset on the media changer.
unlock-
Enable the front panel controls of the media changer.
Configuration
Each data transfer element is configured and operated as a
separate SCSI peripheral device. Storage, data
transfer, and import/export elements are configured and
operated as part of the media changer device.
For example, a juke box containing one SCSI CD-ROM
drive (the data transfer element) is configured as two entities:
-
A CD-ROM drive using the mkdev cdrom command.
If this is the first such device configured in the system,
its block and character device nodes are
/dev/cd0 and /dev/rcd0.
-
A media changer device using the mkdev juke command.
If this is the first such device configured in the system,
its control device node is /dev/Sjk0.
Data transfer elements usually have the same SCSI
host adapter name, bus number, and ID as the
other elements in the juke box, but their LUNs
(logical unit numbers) differ. For example, the
LUNs of the data transfer element and the media
changer device may be 0 and 1 respectively.
Refer to the documentation supplied with the juke box for
details of the SCSI configuration of its
elements.
Files
/dev/Sjk0-
media changer control device
/usr/bin/juke-
juke executable
/usr/include/sys/Sjk.h-
Sjk include file
See also
backup(ADM),
cpio(C),
dd(C),
jukebox(HW),
mc01(HW),
mkdev(ADM),
restore(ADM),
tape(HW),
tar(C),
xbackup(ADM),
xrestore(ADM)
Standards conformance
juke is not part of any currently supported
standard; it is an extension of AT&T System V
provided by The Santa Cruz Operation, Inc.
© 2005 The SCO Group, Inc. All rights reserved.
SCO OpenServer Release 6.0.0 -- 03 June 2005