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 Jukeboxes (see libsji(8)). This command reads media presence and tag data from a Jukebox.

Typical output for this command might look like:

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 turned out to be 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 (i.e., set to zero), and med_pres is true (i.e., set to one), it is probable that there is media at that location, but that there is some exception associated with it. This may mean (in some cases and for some Jukeboxes) that a tape has a missing, upside down, or unreadable bar code label. It may also mean, however, in the case of media located inside a DATA TRANSPORT element (tape drive) that the Jukebox cannot really tell, but that as far as it knew, there was media there at some point in the past (say, prior to a power failure). If the token pres_val is not true (i.e., set to zero), and med_pres is also not true (i.e., set to zero), it is pretty likely that there isn't media in that location. Typically, most of this uncertainty gets eliminated the next time an INITIALIZE ELEMENT STATUS is done (see sjiielm(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 ALSO
libsji(8)
sjiielem(8)