NetWorker command:      sjirdtag

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  
       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), sjiielm(8)

NetWorker 7.5.1			  Mar 21, 09