


SJIRDTAG(8)                                           SJIRDTAG(8)


NNAAMMEE
       sjirdtag - test the SJI Jukebox Interface SJIRTAG command

SSYYNNOOPPSSIISS
       ssjjiirrddttaagg _d_e_v_n_a_m_e

DDEESSCCRRIIPPTTIIOONN
       The ssjjiirrddttaagg program tests the SJIRTAG command on SJI com-
       pliant Jukeboxes  (see  _l_i_b_s_j_i(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 _d_e_v_n_a_m_e argument should be any device name that can be
       used to reach a SJI compliant Jukebox driven by  the  sys-
       tem.  Typical  usage is in constructing the name that con-
       tains the SCSI Bus, the SCSI Target ID and the SCSI Lun on
       that target, e.g., _s_c_s_i_d_e_v_@_0_._4_._0.

       The  output  is  sorted  by  types  available, and then by
       ascending order.

       The boolean token ttaagg__vvaall 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  mmeedd__pprreess  states  whether the Jukebox
       believes that there is media present at this location.

       The boolean token pprreess__vvaall  is  a  subtle  and  overloaded
       indicator that states (if set to true, or 1), that the the
       token mmeedd__pprreess should be believed absolutely. If  pprreess__vvaall
       is  not  true  (i.e.,  set  to zero), and pprreess__vvaall is true
       (i.e., set to one), it is probable that there _i_s media  at
       that location, but that there is some exception associated
       with it. This may mean (in some cases and for  some  Juke-
       boxes)  that a tape has a missing, upside down, or unread-
       able bar code label. It may also  mean,  however,  in  the
       case  of  media  located  inside  a DATA TRANSPORT element



NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        1





SJIRDTAG(8)                                           SJIRDTAG(8)


       (tape drive) that the Jukebox cannot really tell, but that
       as  far as it knew, there _w_a_s media there at some point in
       the past (say, prior to a power failure).   If  the  token
       pprreess__vvaall  is not true (i.e., set to zero), and pprreess__vvaall 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  INI-
       TIALIZE ELEMENT STATUS is done (see ssjjiiiieellmm(8)).

       The  token  mmeedd__ssiizzee is for two sided media (e.g., optical
       disks), where the Jukebox has kept track of which side  is
       up.

SSEEEE AALLSSOO
       _l_i_b_s_j_i(8)
       _s_j_i_i_e_l_e_m(8)









































NetWorker rt_1998_4Q.Build.MMaJrFcehra0l8_,0021000                        2


