SJIRDTAG(8)SJIRDTAG(8)NAME
sjirdtag - test the SJI Jukebox Interface SJIRTAG command
SYNOPSIS
sjirdtag devname
DESCRIPTION
The sjirdtag program tests the SJIRTAG command on SJI compliant Juke‐
boxes (see libsji(8)). This command reads media presence and tag data
from a Jukebox.
Example output for this command:
Tag Data for 0.2.1, Element Type DATA TRANSPORT:
Elem[001]: tag_val=0 pres_val=1 med_pres=1 med_side=0
Tag Data for 0.2.1, Element Type STORAGE:
Elem[001]: tag_val=0 pres_val=1 med_pres=1 med_side=0
Elem[002]: tag_val=0 pres_val=1 med_pres=1 med_side=0
Elem[003]: tag_val=0 pres_val=1 med_pres=1 med_side=0
Elem[004]: tag_val=0 pres_val=1 med_pres=1 med_side=0
Elem[005]: tag_val=0 pres_val=1 med_pres=0 med_side=0
Elem[006]: tag_val=0 pres_val=1 med_pres=1 med_side=0
Elem[007]: tag_val=1 pres_val=1 med_pres=1 med_side=0
VolumeTag=<00000098>
Tag Data for 0.2.1, Element Type MEDIA TRANSPORT:
Elem[001]: tag_val=0 pres_val=1 med_pres=0 med_side=0
The devname argument should be any device name that can be used to
reach a SJI compliant Jukebox driven by the system. Typical usage is in
constructing the name that contains the SCSI Bus, the SCSI Target ID
and the SCSI Lun on that target, e.g., scsidev@0.4.0.
The output is sorted by types available, and then by ascending order.
The boolean token tag_val states whether the tag data is available
(valid). In the example above, only the seventh storage element had
valid tag data (which was the bar code numbered '00000098').
The boolean token med_pres states whether the Jukebox believes that
there is media present at this location.
The boolean token pres_val is a subtle and overloaded indicator that
states (if set to true, or 1), that the the token med_pres should be
believed absolutely. If pres_val is not true (set to zero), or med_pres
is true (set to one), it is probable that there is media at that loca‐
tion, but that there is some exception associated with it. A possible
exception is that a tape has a missing, upsidedown, or unreadable bar
code label. Also, a Jukebox cannot determine whether media that existed
at one point (for example, prior to a power failure) has been removed
from a Data Transport element (tape drive). If the token pres_val is
not true (set to zero), and med_pres is also not true (set to zero),
there probably isn't media in that location. This uncertainty is elimi‐
nated the next time an INITIALIZE ELEMENT STATUS is done (see sji‐
ielm(8)).
The token med_size is for two sided media (e.g., optical disks), where
the Jukebox has kept track of which side is up.
SEE ALSOlibsji(8)sjiielm(8)NetWorker 7.3.2 Aug 23, 06 SJIRDTAG(8)