SJIRELEM(8)

NAME
sjirelem - test the SJI Jukebox Interface SJIRELEM command

SYNOPSIS
sjirelem devname

DESCRIPTION

The sjirelem program tests the SJIRELEM command on SJI compliant Jukeboxes (see libsji(8)). This command reads media presence and origin data from a Jukebox.

Typical output for this command might look like:

Element Data for 0.2.1, Element Type DATA TRANSPORT:
        Elem[001]: pres_val=1 med_pres=1 med_side=0
                   Origin: type STORAGE, address 5
Element Data for 0.2.1, Element Type STORAGE:
        Elem[001]: pres_val=1 med_pres=1 med_side=0
        Elem[002]: pres_val=1 med_pres=1 med_side=0
        Elem[003]: pres_val=1 med_pres=1 med_side=0
        Elem[004]: pres_val=1 med_pres=1 med_side=0
        Elem[005]: pres_val=1 med_pres=0 med_side=0
        Elem[006]: pres_val=1 med_pres=1 med_side=0
        Elem[007]: pres_val=1 med_pres=1 med_side=0
Element Data for 0.2.1, Element Type MEDIA TRANSPORT:
        Elem[001]: 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 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, hoever, 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.

When the Jukebox can, it might also say where the last place a piece of media had been prior to its current location, in which case sjirelem will print that out.

SEE ALSO
libsji(8)
sjiielem(8)