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)
© 2005 The SCO Group, Inc. All rights reserved.
SCO OpenServer Release 6.0.0 -- 03 June 2005