jukebox(HW)
jukebox, Sjk --
media changer devices
Description
Sjk is the SCSI peripheral driver for
media changer devices (juke boxes).
The command mkdev juke is used to configure the
media changer driver interactively. This defines the SCSI
host adapter, bus number, controller target ID, and
device LUN in the SCSI configuration file
mscsi(F).
The data transfer elements of a media changer
(for example, DAT or CD-ROM drive)
must be defined as separate SCSI peripherals using
an appropriate command such as mkdev tape or
mkdev cdrom.
Use the
juke(HW)
command to control a media changer device.
The device file /dev/SjkN can be
used to control the associated media changer device.
N corresponds to the minor number of the device.
The minor device number determines which media changer will be
accessed; minor number 0 accesses the first device, 1 the second
device and so on, up to minor number 255.
ioctl commands
The following
ioctl(S)
commands, defined in /usr/include/sys/Sjk.h,
can be used to control a media changer (the argument arg
to ioctl is set to 0 unless otherwise indicated):
SJK_GETJUKEADDR-
Return the details of the media changer's internal elements in the
struct Sjk_address pointed to by arg.
SJK_MOVEJUKE-
Move a data medium (tape, CD) from a source
storage element to a destination storage element.
The argument arg is coded as:
(source << 16) | destination
where source and destination
are of type unsigned short.
SJK_NOJUKEREMOVE-
Disable the front panel controls of the media changer.
SJK_OKJUKEREMOVE-
Enable the front panel controls of the media changer.
SJK_POSITIONJUKE-
Position medium transport element ``mt0'' in front of storage
element ``stN'', where N is the value of
arg of type
unsigned int.
SJK_RESET-
Perform a hardware reset on the media changer.
Diagnostics
These SCSI sense error messages may display on the console.
See
messages(M)
for general information about kernel error messages, including a
list of generic device driver errors.
NOTICE: Sjk: Destination Element Full-
A data medium could not be placed in a given element because that
element was already occupied.
NOTICE: Sjk: Invalid CDB Field-
A SCSI command data block field was not understood by the
media changer's controller.
NOTICE: Sjk: Invalid Command Code-
A SCSI command was not understood by the media changer's
controller.
NOTICE: Sjk: Invalid Element Address-
A specified element was not found to be present in the media changer.
NOTICE: Sjk: Logical Unit Not Supported-
A SCSI command addressed a non-existent element of the media
changer.
NOTICE: Sjk: Manual Intervention Required-
A hardware error occurred in the media changer
which requires the intervention of a human operator.
NOTICE: Sjk: Mechanical problem-
A hardware failure occurred in the media changer.
NOTICE: Sjk: Media Removal Prevented-
A data medium could not be removed from a specified element
because of a physical obstruction.
NOTICE: Sjk: Power-on Reset, or Bus Reset-
A hardware reset was performed on the media changer.
NOTICE: Sjk: Source Element Empty-
A data medium could not be removed from a given element because it
was not present there.
Files
/dev/SjkN-
control special device for media changer with minor device number N
/usr/include/sys/Sjk.h-
header definitions file
See also
cdrom(HW),
juke(HW),
mkdev(ADM),
mscsi(F),
scsi(HW),
scsitape(HW)
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003