JBC(8) — Maintenance
NAME
jbc − optical disk jukebox control utility
SYNOPSIS
jbc unit [command]
DESCRIPTION
jbc is a jukebox manipulation tool used to display jukebox status and initiate jukebox functions. unit selects the jukebox by name or number. If the command used to invoke jbc has a numeric component, that component serves as a unit number to select the jukebox in lieu of unit. The default jukebox name is /dev/jb. command optionally specifies a jukebox operation to be performed.
If the selected jukebox type is controlled by a daemon, jbc transfers its requests to the jukebox daemon and accepts its responses via the jukebox driver, and displays the daemon’s status map and error log files (see jbd(8)). Otherwise, it performs jukebox operations directly via the jukebox driver. Certain commands are only valid for jukeboxes controlled by a daemon, while others may operate slightly differently on different jukeboxes. Use the help command to determine the commands accepted by each jukebox.
USAGE
If command is supplied, jbc will perform only the specified operation and terminate. If command is omitted, jbc accepts commands from its standard input and displays responses on its standard output. jbc displays its name and a colon (:) when a command may be entered. These commands are defined:
c[lear] Clear the error log and restart any operations suspended due to errors.
d[elay] [seconds] Display or change the access port time-out in seconds.
e[ject] slot Transfer a volume from the resource designated by slot to the access port.
f[lush] Return volumes held in the carrier to their "home" slots.
g[et] from to Fetch a volume from the resource designated by from into the carrier designated by to.
h[elp] Display a terse command summary.
i[nsert] slot Transfer a volume from the access port to the resource designated by slot.
l[ist] Display the contents of the jukebox error log file /ofs/log.
m[ove] from [to] Transfer a volume from the resource designated by from to the resource designated by to (or its "home" slot, if to is omitted).
n[ame] type Display the names of jukebox resources of the specified type.
p[ut] from to Store the volume in the carrier designated by from into the resource designated by to.
o[ption] [mask] Display or change the option mask. Individual bits in the option mask manipulate special features of the jukebox control utility or daemon. Most option bits currently activate diagnostic messages in the daemon.
q[uit] clear, then terminate jbc.
r[eset] Initialize the jukebox status map.
s[how] type Display the status of jukebox resources of the specified type.
t[ry] [times] Display or change the retry count.
v[iew] Display the status of all jukebox resources (devices and slots).
The get, put, flush, list, clear, delay and try commands are only valid for jukeboxes controlled by a daemon.
The insert, eject, move, get and put commands accept one or more additional parameters designating jukebox resources (slots or devices) and orientations within them. These parameters comprise a decimal resource number and type (a or b for upper or lower volume surface, d for device) with no intervening space. For example, 12b refers to the lower surface of the volume in slot 12, and 3d refers to device 3. The access port is always device 0, and all other devices are disk drives.
The get and put commands also accept a parameter designating the carrier mechanism. This parameter comprises either a letter a or b selecting a carrier by name followed by a letter n or i specifying an orientation (normal or inverted), or else a letter u or l selecting a carrier by position optionally followed by a letter r specifying a prior rotation. For example, g27bi gets a volume from slot 27 into carrier B in inverted orientation, and p3dlr puts a volume into drive 3 from the lower carrier, after rotating. Note that the upper/lower designation changes depending upon the carrier orientation, but the A/B designation does not.
The name and show commands accept an additional parameter specifying a resource type. The recognized resource types are d[evices], s[lots] and v[olumes]. Specifying v[olumes] displays the names or status of occupied devices and slots.
Volumes are presumed to reside permanently in slots and only transiently in devices, and are therefore designated by the number of the slot in which each resides, called its "home" slot. If a move command involves a non-empty device, the "home" slot number of the volume in the device is an implied parameter. Thus, if a move command specifies only a non-empty device, or a slot and a non-empty device, the volume in the device returns to its "home" slot.
If a volume is moved to a vacant slot, that slot becomes its new "home". However, if the volume is in a drive, moving it from its "home" slot to a vacant slot does not place it into that slot immediately, but merely changes its "home".
FILES
/ofs/map# jukebox status map
/ofs/log# jukebox error log
SEE ALSO
DIAGNOSTICS
code:error A jukebox error has occurred; code is the jukebox error code, and error is a description of the error.
no device jbc could not open the jukebox device.
no command An unrecognized command was specified.
bad format A required resource was omitted or improperly specified.
out of range A resource type or position is beyond the valid range.
source empty A command attempted to access a volume in an empty resource.
target active A command attempted to place a volume in an active resource.
access timeout A volume was not placed in or removed from the access port within the allotted time. This time may be extended using the delay command.
restricted slot A command could not be performed due to the physical limitations of the jukebox robotic mechanism. This condition can be circumvented using an intermediate destination.
map inconsistent The resource status received from the jukebox does not match the resource map stored on disk. Either the jukebox configuration has been changed or jukebox communications have been disrupted.
no communication The jukebox daemon jbd cannot communicate with the jukebox. This usually indicates an equipment failure.
cannot access jbc cannot communicate with the jukebox daemon jbd. This usually means jbd is not operating; either it was never started, or it has terminated due to a fatal error condition.
cannot sense jbc cannot get status information from the jukebox. This usually indicates an equipment failure.
cannot perform A command failed to access a volume in a specified resource.
cannot transfer A move command failed to transfer a volume to a specified resource.
cannot restore A move command failed to restore a volume to its "home" slot.
cannot insert An insert command failed to insert a volume into a specified slot.
cannot eject An eject command failed to eject a volume from a specified slot.
— 30 April 1992