EMC Legato NetWorker Commands Reference

nsrjb

SYNOPSIS

       nsrjb  [ -C ] [ -j name ] [ -s server ] [ -v ] [ -f device ] [ -S slots
       | -T Tags | volume names ]

       nsrjb -L [ -j name ] [ -s server ] [ -gimnqvMG ] [ -Y | -N ] [ -R |  -B
             ]  [  -b  pool  ] [ -f device | -J hostname ] [ -e forever ] [ -c
             capacity ] [ -o mode ] [ -S slots | -T tags | -W current  pool  |
             volume names ]

       nsrjb -l  [ -j name ] [ -s server ] [ -nvqrMG ] [ -R [ -b pool ] ] [ -f
             device | -J hostname ] { -S slot | -T tags | -W current pool [ -D
             volume name ] [ -e forever ] | volume names }

       nsrjb -u  [  -j name ] [ -s server ] [ -qvM ] [ -f device ] [ -S slot |
             -T tags | volume names ]

       nsrjb -I [ -j name ] [ -s server ] [ -Evpq ] [ -f device ] [ -S slots |
             -T tags | volume_names ]

       nsrjb -p  [  -j name ] [ -s server ] [ -vq ] [ -f device ] -S slot | -T
             tag | volume name

       nsrjb -o mode [ -j name ] [ -s server ] [ -Y ] { -S slots | -T  tags  |
             volume names }

       nsrjb -H [ -j name ] [ -s server ] [ -EHvp ]

       nsrjb -h [ -j name ] [ -s server ] [ -v ]

       nsrjb -U uses [ -j name ] [ -s server ] [ -S slots | -T tags ]

       nsrjb -V [ -j name ] [ -s server ] [ -v ]

       nsrjb -d  [  -j  name  ]  [ -s server ] [ -v ] [ -N ] [ -P ports ] [ -S
             slots ] [ -T tags ] [ volume names ]

       nsrjb -w [ -j name ] [ -s server ] [ -v ] [ -N ] [  -P  ports  ]  {  -S
             slots | -T tags | volume names }

DESCRIPTION

       The nsrjb program manages resources in two broad classes of  jukeboxes,
       remotely  managed  jukeboxes  and  locally managed jukeboxes.  Remotely
       managed jukeboxes are controlled through an external agent.  nsrjb com-
       municates  with  this  agent  to gain access to jukebox resources.  The
       agent  allows  multiple  applications,  including  multiple   NetWorker
       servers,  to  share  resources  in the jukebox.  Examples of agents are
       SmartMedia and  StorageTek's ACSLS .  nsrjb communicates directly  with
       a locally managed jukebox, there is no intervening agent.  Resources in
       a locally managed jukebox can be used by only one NetWorker server.

       For a locally managed jukebox, the jukebox resource is  used  to  track
       the  state  of  the entire jukebox.  The resource records the number of
       drives and slots in the jukebox.  It is  also  used  to  track  whether
       devices  are loaded, whether there is media residing the slots, and the
       name of any volume on the media, as well  as  other  information.   See
       nsr_jukebox(5).

       The  jukebox  resource  for a remotely managed jukebox does not reflect
       the current state of the entire jukebox, only NetWorker's view.   Media
       must be allocated, before NetWorker may use media in a remotely managed
       jukebox the media. For more details, see  the  description  of  the  -a
       option.   The number of slots in a remote jukebox resource increases as
       media is allocated for NetWorker's use and decreases as media is  deal-
       located after NetWorker has no further use for the media.  The order in
       which media is listed in the  jukebox  resource  does  not  necessarily
       reflect physical location  within the jukebox.  The number of drives in
       a remote jukebox is an upper bound on the  number  of  volumes  in  the
       jukebox that NetWorker may access simultaneously.

       The  nsrjb  command  is  used  to  manage all jukeboxes for a NetWorker
       server.  Use this command, rather than nsrmm(1), to  label,  load,  and
       unload the volumes contained within a jukebox.  Multiple nsrjb commands
       may access a jukebox at any given time.  Each nsrjb program  determines
       the resources in a jukebox that the command will require, and locks all
       needed resources before execution begins. For  additional  details  see
       the  description  of  the jukebox attributes, slot/volume locks , drive
       locks , and jukebox lock , in nsr_jukebox(5).

       Manually entered nsrjb commands which require use of jukebox  resources
       do  not  directly  perform the requested operation.  Instead a manually
       run nsrjb makes a  request  of  the  NetWorker  server  process,  which
       assigns  a  lockid  to the command and starts another instance of nsrjb
       which performs the requested operation.  The server process starts  the
       second  nsrjb  with the -O option added to the original options to ser-
       vice the request.  Users should never use the -O option on  a  manually
       entered  command.   This may result in locks for resources in a jukebox
       resource not being released when  the  command  terminates.   The  only
       method  for  clearing  such  locks  is  to stop and start the NetWorker
       server process.

       A volume is a physical piece of media, for example, a tape cartridge or
       optical disk.  Each volume within a jukebox and each jukebox has a name
       recognized by NetWorker.  A volume name is specified when the volume is
       first labeled by NetWorker.  You can change the volume name when a vol-
       ume is relabeled.  NetWorker refers to volumes by their  volume  names.
       For  example, when requesting the mount of a volume, NetWorker asks for
       When a NetWorker server requires a volume for backup or recovery and an
       appropriate  volume is not already mounted, the server checks the media
       database to verify whether a jukebox contains a volume  that  satisfies
       the  media  request.  If so, nsrjb is invoked to load the media into an
       idle device.  The Available Slots attribute specifies  the  slots  con-
       taining  volumes  available to automatically satisfy NetWorker requests
       for writable volumes.  When automatically selecting a  writable  volume
       for backup, NetWorker only considers volumes from the list of available
       slots.  It is important to note that the Available Slots attribute does
       not limit what slots the user running nsrjb can operate on.

       nsrjb  attempts  to determine which jukebox to use based on the options
       -j , -f , or a volume name .  If one or more of these  options  do  not
       uniquely identify a jukebox and one must be selected, the nsrjb program
       prompts you to select a jukebox.  You can set the NSR_JUKEBOX  environ-
       ment  variable to the name of the jukebox you want the nsrjb program to
       use by default.

OPTIONS

       Options are separated into two groups. The first are the options  which
       specify  the  operation to be performed, e.g. label or load media.  The
       second group list the additional options which  provide  arguments  for
       the operation, e.g. specifying the media to be labeled or loaded.  Note
       that option arguments that have spaces, for example, pool name, must be
       enclosed in double quotes.

OPERATION OPTIONS

       -a     This  option  is used in conjunction with the -T tags option, to
              allocate volumes in a remotely managed jukebox.  A  volume  must
              be  allocated  before  it can be labeled and used by a NetWorker
              server.

              For STL silos a -d option can be added for  silos  that  support
              depositing  (also  known  as  importing  or entering) tapes from
              their I/O ports.  The -d must appear after the -a on the command
              line.   This  function is usually handled by the silo management
              software, but is added here for ease of use.   This  option  may
              not be supported on all silos supported by NetWorker.

              There  are two types of media which may be allocated or added to
              a SmartMedia jukebox resource, scratch  or  foreign.   The  term
              scratch, is used to indicate volumes currently not being used by
              NetWorker.  A foreign tape is one that was being  used  by  Net-
              Worker before being imported into SmartMedia.

              Use  -a  in  conjunction with -T tags option to allocate scratch
              volumes for NetWorker's use.  By specifying the barcode or phys-
              ical  cartridge  label  with this option a volumes from specific
              media cartridges may be allocated.  This option can also be used
              to allocate a given number of volumes from unspecified media.

              After  importing a foreign volume (an existing NetWorker volume)
              into SmartMedia, this option is also used  to  inform  NetWorker
              that the imported volumes are available through SmartMedia.  Use
              -a, in conjunction with -T tags and  volume names to add foreign
              media  to  a  SmartMedia jukebox resource.  The  tag is the name
              given to the volume when it was imported into SmartMedia.  The
              volume  name  is  the  volume name recorded in NetWorker's media
              option, used if no other command options are specified.  It dis-
              plays  a  list  of  slot  numbers,  volume  names,  media pools,
              optional bar code information, volume ids and volume modes.   If
              the  jukebox  attribute Bar Code Reader is enabled and there are
              bar code labels on the media volumes, then the bar code label is
              included  in the list.  If Bar Code Reader is set and the volume
              does not have a bar code label, a dash prints,  indicating  that
              there  is  no bar code label on the media.  By default the short
              volume id of a volume is displayed.  Using  the  verbose  option
              (-v)  displays  the  long volume id along with other information
              described below. The -C option does  not perform an actual juke-
              box  inventory; nsrjb only reports on the volumes currently con-
              tained within the jukebox resource.  Volumes may be succeeded by
              one  of  the  following flags: an (R), to indicate the volume is
              read-only; or an (A),  to  indicate  the  volume  is  either  an
              archive  or  a  migration  volume.   When  combined  with the -v
              option, the capacity of the volumes that  have  been  filled  is
              also displayed.  Volumes that are not contained in the NetWorker
              media database are marked with an asterisk, "*".

              The Mode column contains additional information about  the  mode
              of  the  volume.   The  Mode field can have one of three values:
              manually recyclable to indicate that  the  volume  will  not  be
              automatically  recycled  or  relabeled;  recyclable, to indicate
              that the volume is eligible for automatic recycling; or blank to
              indicate that neither of the other two values apply.

              After  the  slot  map  prints,  a line about each device is dis-
              played.  For each enabled device, the following  information  is
              provided: drive number, device pathname, slot number and name of
              the currently loaded volume, and an indication if NetWorker  has
              the  volume  mounted.  If the device is disabled, only the drive
              number and pathname are displayed, along with the  message  dis-
              abled.   When several device resources share a physical drive in
              the jukebox, via the same hardware id attribute value, the drive
              number  is  only  displayed on the first device pathname sharing
              the drive.

       -d     Deposits (loads into the jukebox) one or  more  cartridges  from
              the  cartridge access ports (also called import/export elements,
              mail slots, or I/E ports).

              The number of cartridges to deposit is determined by the  number
              of  specified  slots or tags. All empty slots in the jukebox are
              deposited, if slots or tags are not specified.  Multiple  desti-
              nation slot ranges may be specified, full slots are skipped.  If
              all available import ports are empty and there are cartridges to
              deposit, the operator will be prompted to fill the import ports.
              When the -N option is  used  in  conjunction  with  the  jukebox
              polling  feature,  the  jukebox  will poll for cartridges in the
              import ports until all of the cartridges  are  deposited  or  an
              error  occurs.  Exceeding  the polling timeout waiting for addi-
              tional cartridges is considered an error.

              Specifying volume names on the command line is not  recommended.
              The  inventory command should be run to accurately determine the
              volume names.

              values specified.  If the tags have already been allocated,  you
              will  see  a message indicating this.  This is not an error, and
              only means that the volumes had already been successfully  allo-
              cated for use by NetWorker.

       -F     Releases  a  shared  device  contained within an STL silo.  This
              option is only available for tape libraries with device sharing.
              See nsr_jukebox(5).

       -h     Displays  the  actions  and results of the past 120 jukebox com-
              mands issued.  These include commands issued on the command line
              by  the  user, or nsrjb commands that were started automatically
              by NetWorker.  Starting with Version 5.5,  many  nsrjb  commands
              issued  from  the  command  line  will  not actually perform the
              requested jukebox options.   Instead,  the  manually  run  nsrjb
              sends a message to the NetWorker server process, which will then
              start the required  nsrjb  command(s).   Therefore,  it  is  not
              unusual  to  see  two  entries generated in the history for each
              command issued on the command line.  Instances of nsrjb that are
              started by the server have an extra command line option set ( -O
              <instance number>).  If you wish to change the number of command
              lines saved in the history, you may set the environment variable
              NSRJB_HISTORY_COUNT to a value  between  20  and  2000.   Values
              smaller  than 20 will result in 20 being used, and values larger
              than 2000 will result in 2000 being used.

       -H     Resets the jukebox hardware (and the NetWorker  database  repre-
              senting  the jukebox) to a consistent state.  The jukebox clears
              the transport and then unmounts and  unloads  volumes  from  the
              drives to slots.  An actual inventory is not performed; (see the
              -I option).  If the jukebox senses that the inventory is out-of-
              date, it prints an appropriate message.

              For  jukeboxes  that  do not correctly report whether the drives
              are loaded, the -HH option forces an unload of all  the  drives.
              This  option  is also useful in situations where a tape is still
              loaded in a drive, but NetWorker thinks that the drive is empty.
              If  the device is also specified with the -HH option, nsrjb will
              force an unload on the specified device only.  Note that certain
              jukeboxes  have a firmware bug where an attempt to unload a tape
              that has not been ejected will cause it to  attempt  the  unload
              forever.  This will cause nsrjb to hang.

              For  silos,  only  devices which NetWorker thinks are loaded are
              unloaded.  You can  use  the  silo  controller  to  empty  other
              drives.

              For  SmartMedia  jukeboxes,  resets  the jukebox devices and the
              NetWorker database representing  the  jukebox  to  a  consistent
              state.   The  operation synchronizes the state of the devices in
              the jukebox and the media in the jukebox  resource  with  Smart-
              Media.   nsrjb  queries SmartMedia for information about volumes
              in the jukebox resource and which volumes are currently mounted.
              It  uses  this information to synchronize the jukebox and device
              resources to be consistent  with  the  information  reported  by
              SmartMedia.   If  the -p option is also specified a check opera-
              tion will be performed on the loaded volumes.

              have element status capability (for example, EXB-120, EXB-60, or
              HP  optical),  you can use the -E option in conjunction with the
              -I option to reinitialize the jukebox's inventory state.  The -E
              option  increases  the  amount  of  time it takes to inventory a
              jukebox,  because  the  hardware  must  check  every  component,
              including  all slots and drives, for the presence of media.  You
              should only use this option if you are manually  swapping  media
              in or out of a jukebox.

              If  a  jukebox  has  a  bar  code  label reader, and the jukebox
              resource attribute Bar Code Reader  is  set,  then  volume  name
              associated with a slot is derived from the media bar code label.
              If the bar code label is not unique or does  not  exist  in  the
              NetWorker  media  database,  the  volume  name  is read from the
              media.  If a bar code label on the media has changed,  then  the
              NetWorker media database is updated with the new bar code label.
              Proper use of a jukebox's bar code reader can minimize the  time
              it takes to perform an inventory.

              For  SmartMedia jukeboxes, this operation is used to synchronize
              NetWorker and SmartMedia database.  It insures  that  SmartMedia
              and  NetWorker  agree  to  the state of all volumes allocated to
              this NetWorker server and listed in this jukebox  resource.   If
              the  -p  option  is also specified nsrjb requests the volumes be
              loaded so that labels on each volume may be verified.

              To allocate slots in a jukebox for cleaning cartridges, set  the
              jukebox  resource  attribute  Auto Clean to Yes and the Cleaning
              Slots attribute to a  non-empty  range  of  slots.  For  further
              information  see  nsr_jukebox(1).   Volumes  from slots that are
              reserved for cleaning  cartridges  are  not  loaded  during  the
              inventory  of a jukebox.  For jukeboxes that do not support ele-
              ment status or have a bar code reader, the -U uses  option  must
              be  used to enter a cleaning cartridge into the jukebox's inven-
              tory.  For jukeboxes that support element status or have  a  bar
              code reader, cleaning cartridge slots that were previously empty
              but now contain a cartridge have the  number  of  uses  for  the
              cleaning  cartridge  is  the  value set in the jukebox attribute
              Default Cleanings.

       -l     Loads and mounts specified volumes.  Volumes  are  specified  by
              name,  by  the  slot  in which the volume resides, or for remote
              jukeboxes by the tag associated with the volume.  The  operation
              fails,  if  the  number of volumes specified is greater than the
              number of available drives.

              For SmartMedia jukeboxes, the command may only be used to  mount
              volumes into devices accessible from the storage node upon which
              nsrjb is running.  You can use, the -W option to load and  mount
              a  volume in a SmartMedia jukebox which belongs to the specified
              pool.

              This option can also be used to clean  a  device  by  loading  a
              cleaning cartridge.  To load a cleaning cartridge use the volume
              name 'cleaning tape' or specify a slot that has been  set  aside
              for  a cleaning cartridge.  When the volume name 'cleaning tape'
              is used to load a cleaning cartridge, and more than one cleaning
              cartridge  in  the  jukebox has any uses left, the cleaning car-
              aged jukeboxes,  by  specified  tags.   Names  for  the  volumes
              labeled  are  derived  from  media bar code labels, volume names
              specified on the command line, or generated by  referencing  the
              label template resource for the given pool.  If you do not spec-
              ify any slots, the  range  of  slots  is  as  described  in  the
              NSR_jukebox resource for the jukebox.  Labeling a complete juke-
              box may take a long time.

              If the jukebox has a bar code label reader, and the  NSR_jukebox
              resource  attributes  Bar  Code Reader and Match Bar Code Labels
              are set, then the volume label is  derived  from  the  bar  code
              label on the media.  If the jukebox resource attribute Match Bar
              Code Labels is not set, or the jukebox does not have a bar  code
              reader, then the volume label is derived from volume names spec-
              ified on the command line.  If more volumes  are  being  labeled
              then volume names specified on the command line, then the volume
              label is derived from the label template.   No  matter  how  the
              volume  label  is  derived, if the media labeled has a media bar
              code label, the bar  code  is  stored  in  the  NetWorker  media
              database so that it can be used during inventory operations.

              Volumes  located in slots set aside for cleaning cartridges can-
              not be labeled.  See -I for a discussion of how the slots  of  a
              jukebox are set aside for cleaning cartridges.

              If  an  empty  slot  is encountered, an informational message is
              displayed and the operation continues.

              See the -m option if you want the  volume  to  be  automatically
              mounted after being labeled.

       -o mode
              Sets the mode of a volume or range of slots.  The following mode
              values are available: [not]recyclable, [not]readonly, [not]full,
              or [not]manual.  The [not]manual mode values are only valid when
              used in conjunction with the -L option.  If the -Y option is not
              used, you are prompted to confirm the operation for each volume.
              See nsrim(1) for a discussion of the per-volume flags.

       -p     Verifies and prints a volume label.  A slot or for remotely man-
              aged  jukeboxes  a tag may be specified. The device used to read
              the volume may also may be specified. See nsrmm(1).

       -u     Unloads a volume from a  device.  To  unload  a  volume  from  a
              device,  specify the name of the volume, the device in which the
              volume is loaded, or the slot from which the volume was  loaded.
              If  no  volume,  device  or slot is specified, media is unloaded
              from all loaded devices.

       -U uses
              Sets the number of times a cleaning cartridge can be used. Slots
              can  also  be specified. Any slot specified must be in the range
              of slots set aside for cleaning cartridges in the jukebox. If  a
              range  of slots is not specified, all slots set aside for clean-
              ing cartridges are updated. For slots that are  currently  empty
              in the jukebox's inventory, this option updates the inventory to
              indicate that the slot is occupied by a cleaning cartridge.  For
              a  discussion of how slots of a jukebox are set aside for clean-
              box(5).

              You can use the -T option in conjunction with the -U  option  to
              add  cleaning  cartridges  to  a  Silo Tape Library (STL).  This
              option sets aside a cleaning slot in the STL each time a  clean-
              ing  cartridge  is  added.   For  a description of how to remove
              cleaning cartridges from an STL, see -x.  See -I for  a  discus-
              sion  of how slots in a non-STL jukebox are set aside for clean-
              ing cartridges.

       -V     Displays vendor-specific status information.  When combined with
              the -v option, the configuration of the jukebox is displayed.

       -w     Withdraws (ejects media from the jukebox) one or more cartridges
              to the cartridge access ports.

              Cartridges must be specified by slot, volume name or tag.   Mul-
              tiple  slot  ranges and volume names may be specified, empty and
              duplicate slots are ignored.  If the available export ports  are
              full  and there are cartridges to withdraw, the operator will be
              prompted to empty the export ports.  When the -N option is  used
              in  conjunction  with  the  jukebox polling feature, the jukebox
              will poll for empty export ports until all cartridges are  with-
              drawn  or an error occurs. Exceeding the polling timeout waiting
              for empty ports is considered an error.

              If -w is used with a -T tags option, then the command is assumed
              to  be  running on a silo, and is treated internally the same as
              if it had been run with the -x and -w options.  Specified volume
              tags  (barcodes)  are  withdrawn  from  the silo. Then NetWorker
              deallocates them from its list of volumes  for  that  silo.   In
              general,  you  can only withdraw at most about 40 volumes from a
              silo at one time, although this limit differs on different  silo
              models.  If a given command does not cause any tapes to be with-
              drawn from the silo, try again using fewer  tag  values  on  the
              command line.

       -x     This  option,  when used in conjunction with the -T tags option,
              is used to remove volumes from a remote jukebox.  The  specified
              volumes  are  removed  from the remote jukebox's list of volumes
              available for use by a NetWorker server.

              For STL silos, a -w option can be added  to  withdraw  or  eject
              tapes  from  the silo or to physically remove the tapes from the
              silo.  The -w must appear after the  -x  on  the  command  line.
              This  function  is normally handled by the silo management soft-
              ware, but is added here for ease of use.  This option may not be
              supported on all silos supported by NetWorker.

              See -a for a description of how volumes are allocated for use by
              a NetWorker server.

ADDITIONAL OPTIONS

       -A media type
              This option may be used n conjunction with -a option to  specify
              the type of media on which volumes allocated for use by a server
              may reside.  Valid values for media type,  include  all  choices
              menu item from the Media menu of nwadmin(1).  The pool  name  is
              referenced  by  the  NetWorker server when determining what save
              sets can reside on the volume.  If you omit this option the vol-
              ume  is automatically assigned to the Default pool. If you spec-
              ify a pool name without a volume name, nsrjb will use  the  next
              volume  name associated with the specified pool's label template
              resource.  See nsr_label(5).

       -c capacity
              Overrides the volume's default capacity. See nsrmm(1).

       -B     Verifies that the volume currently being labeled does not have a
              readable  NetWorker  label.  Before labeling a volume, NetWorker
              attempts to read any existing labels written on the volume.   If
              you  specify  this  option  and the volume has a NetWorker label
              that is readable by the device currently being used,  the  label
              operation is canceled and an error message is displayed.  If the
              volume does not have a label, or has a label that is  not  read-
              able  by  the  current  device,  then the volume can be labeled.
              This option is used by nsrd(1) to  label  volumes  automatically
              when nsrmmd(1) makes a request for a volume while saving data.

       -D volume name
              Used  with the -l, option when mounting a volume from a particu-
              lar pool to exclude this volume from consideration.  This option
              is supported for SmartMedia jukeboxes only and may appear multi-
              ple times on a command line.

       -e forever
              Specifies the volume to be an Archive volume. (see nsrmm(1)).

       -E     Initializes element status for jukeboxes that support this  fea-
              ture.   You can use this option in conjunction with the -I or -H
              options.  Some jukeboxes have  the  ability  to  keep  track  of
              whether  or  not  there  is media in a component in the jukebox.
              This feature is known as an "element status" capability. The  -V
              option may be used to determine whether a jukebox has this capa-
              bility.  When swapping media into the jukebox  where  media  was
              not  previously  loaded, it may be necessary to reinventory (-I)
              the jukebox with the -E option so the jukebox reinitializes  its
              element status.

       -f media device
              Specifies  a  media device to be used for an operation.  Use the
              pathname of the media device as it is configured in the  jukebox
              resource.  When more than a single media device has been config-
              ured for a jukebox, nsrjb selects  available  devices  with  the
              lowest  value  for  the device resource attribute accesses.  See
              nsr_device(5).  When loading or verifying volumes, the number of
              devices  available must at least be greater than or equal to the
              number of volumes specified for the operation.  For other opera-
              tions, the value of the jukebox attribute  max parallelism is an
              upper bound on the number of devices that may  be  used  by  any
              nsrjb command.  See nsr_jukebox(5).  You can override the device
              selection by using the -f option.  You can use this option  mul-
              tiple times, to specify more than one media device.

              For  SmartMedia  jukeboxes, the device resource is not tied to a
              See nsr_device(5).   SmartMedia  and  NetWorker  have  different
              names  for  device  and media types.  nsrjb maintains a table to
              map between SmartMedia and NetWorker names to be  able  to  cor-
              rectly  set  the  values of these attributes.  This table can be
              updated  dynamically  to  support  additional  SmartMedia  drive
              and/or  media  types.  The file /nsr/res/smdevmap.txt is used to
              make additions to nsrjb's map table.  Each  line  in  this  file
              contains  four  columns,  SmartMedia  cartridge type, SmartMedia
              bitformat, NetWorker device resource media type,  and  NetWorker
              device  resource  family  type. The SmartMedia bitformat maybe a
              regular expression, all other values are strings. As an  example
              the line,

                  DTL7000    DLT8000.*    DLT8000    tape

              maybe  used for the DLT8000 device using SmartMedia DLT7000 car-
              tridge type.

       -g     This option is kept for  historical  reasons  only.  It  has  no
              affect.

       -G     This  option  is  used only by the server to have the autoloader
              mount or label a volume in a Network  Data  Management  Protocol
              (NDMP) device.

       -i     This  option  is  kept  for  historical  reasons only. It has no
              affect.

       -j name
              Specifies a particular jukebox to use.  The given  name  is  the
              one  assigned  by the user when the jukebox resource is created.
              This option overrides the NSR_JUKEBOX environmental variable.

       -J hostname
              Specifies a particular hostname  to  use.   Drive  selection  by
              nsrjb will be restricted to a drive on the given hostname.  This
              option can be used with the -l (load) or -L (label) options, and
              cannot be used with the -f option.

       -m     Mount  a  volume after it has been labeled. There must be enough
              available drives to mount all volumes to be labeled.

       -M     Sends messages to the NetWorker daemon  reporting  progress  and
              errors.   This is used by nsrd(1) when mounting, unmounting, and
              labeling volumes in response  to  requests  made  by  nsrmmd(1).
              This option is ignored if nsrjb is run manually.

       -n     Loads, but does not mount, the volume when specified with the -l
              option.

       -N     Tells nsrjb to skip the confirmation prompt when  used  in  con-
              junction with the -LR options.  When NetWorker recycles volumes,
              NetWorker prompts you to confirm that it is  okay  to  overwrite
              any  volumes considered to be nonrecyclable.  See nsrim(1) for a
              discussion of the per-volume flags.

       -O instance
              Indicates the lock id used by the command when locking resources
              or withdraw volumes.

              Ranges are specified as low to high.  Both low and high must  be
              integers;  low must be less than or equal to high.  Both numbers
              are checked for validity against  the  resource  describing  the
              jukebox.  You can specify only one port range for a command.

       -q     Runs the nsrjb program in quiet mode.  Turns off all of the mes-
              sages normally produced when verifying,  labeling,  loading,  or
              unloading  volumes, or inventorying a jukebox.  You can use this
              option only with the -p -L, -l, -u or -I options.

       -r     Loads the volume as read-only.  You can  use  this  option  only
              with the -l option.  See nsrmm(1).

       -R     Recycles  the  volume.  If  a  volume is recyclable, you are not
              prompted for confirmation as to whether or not this  volume  may
              be  overwritten. See nsrmm(1) for a discussion of the per-volume
              flags.

       -s server
              Specifies the controlling server when nsrjb is used on a storage
              node.   To  use nsrjb on a storage node, the command must be run
              on the storage node.   See  nsr_storage_node(5)  for  additional
              information on storage nodes.

       -S slots
              Specifies a slot or range of slots on which to operate.  Specify
              the slot range from low to high integer  order.   Both  low  and
              high  must  be integers; low must be less than or equal to high.
              Both numbers are  checked  for  validity  against  the  resource
              describing  the  jukebox.   You can specify multiple slot ranges
              for a command.

       -T tags
              Specifies tags or barcodes of volumes in a remote jukebox.   You
              can specify this option more than once for a command.

              tags  can  specify  a single volume tag or a volume tag template
              similar to a label template. See nsr_label(5).  The  volume  tag
              Template  is a list of template fields separated by slashes "/".
              A template field is a constant alphanumeric string or an  alpha-
              betic  or  numeric  range  represented by the low and high value
              separated by "-".

              This template differs from the templates used in NetWorker  GUI.
              Each  portion of the template is entered into a separate line in
              the GUI's dialog box instead of using "/" as a separator.

              The tag is used to identify the media when a request is made  of
              the agent managing the remote jukebox. This identifier is deter-
              mined by the remote agent. A tag often  is  a  bar  code  label.
              When  making  a  request  to load media into a device, NetWorker
              sends the tag with the request to  the  agent  to  identify  the
              media to be loaded.  Volumes in a jukebox resource are listed in
              alpha-numeric order of their tags.  Therefore, the order in  the
              jukebox  resource  may  change as media is allocated and deallo-
              cated, and has no relation to the slot in which  the  media  may
              which a recyclable volume is to be selected. Only to be used  in
              conjunction with the -L and -R options.  When SmartMedia selects
              the volume to be labeled, it currently must be recyclable and in
              the  current pool .  The volume will be added to the pool speci-
              fied by the -b option.

              For the load operation, this option is used to mount an unspeci-
              fied  volume  that belongs to the current pool .  In such cases,
              SmartMedia selects which volume is to be loaded from all volumes
              which  possess  the  required  characteristics.  This feature is
              used when mounting a volume for writing  data,  e.g.  saving  or
              cloning data.

       -X     You can use this option in conjunction with -x to purge a volume
              from NetWorker's media database when the volume is being deallo-
              cated.   A  prompt is displayed to confirm that the volume is to
              be purged from the media database, unless -Y is also  specified.

       -Y     Disables confirmation prompting.  Rather than prompting for con-
              firmation, a yes answer is assumed.  Prompts are normally gener-
              ated  when  a  volume  is  being relabeled before its expiration
              date, or when a volume is  still  registered  in  the  NetWorker
              media database.  If the operation is to label ( -L ) a volume or
              to load ( -l ) a volume, with the -R option also specified,  and
              the  volume is recyclable, there is no prompt to confirm whether
              the volume may be overwritten.

       volume name
              Specifies the name to be used when labeling a volume.   After  a
              volume has been labeled, the volume name is used to select media
              for an operation.  Multiple volumes names may be specified for a
              single command, and must come at the end of the command line.

EXAMPLES

       Labeling volumes:
              To label all of the volumes in a jukebox, use the -L option:
                 nsrjb -L

              To specify a particular pool, use the -b option:
                 nsrjb -L -bOffsite

       Labeling the volumes in slots 5 through 19:
              To label the volumes in slots 5 through 19, use the -S option:
                 nsrjb -L -S 5-19

       Labeling a volume with a non-standard name:
              To  label  the volume in slot 20 with a name that does not match
              the label template associated with  a  pool,  specify  the  name
              along with the -L option:
                 nsrjb -L -S 20 mars.special

              When  more than one volume is to be labeled, the name must match
              the label template associated with the pool.  This ensures  that
              nsrjb generates the subsequent names.

       Mounting a volume after it has been labeled:
              To mount a volume after it has been labeled use the -m option:
              ciated with the pool resource, specify the first name along with
              the  -L  option.   In order for nsrjb to generate the additional
              names, the specified name must match the  layout  of  the  label
              template.
                 nsrjb -L -bOffsite -S 21-28 Offsite.501

              After  labeling  the  volume in slot 21 with 'Offsite.501' nsrjb
              uses the label template to generate names  for  the  volumes  in
              slots  22  ('Offsite.502')  through  28 ('Offsite.508').  If the
              next volume name in the sequence for a label template is already
              in use, the name is skipped.

       Loading a volume:
              To load volumes, use the -l option.
                 nsrjb -l

              nsrjb  will  select  volumes  to load into selected devices.  It
              will continue loading volumes  until  all  of  the  devices  are
              loaded.

       Loading specific volumes:
              To  load  a volume named mars.001, specify the volume name along
              with the -l option:
                 nsrjb -l mars.001

              To load the volume in slot 5, use the -S option:
                 nsrjb -l -S 5

              To load the selected volume into device /dev/nrst1, include  the
              -f option.
                 nsrjb -l -f /dev/nrst1 mars.005

       Load a cleaning cartridge to clean a device
              To load the cleaning cartridge with fewest remaining uses into a
              device, use the volume name 'cleaning tape' along  with  the  -l
              option.  To clean device /dev/nrst1, include the -f option.
                 nsrjb -l -f /dev/nrst1 "cleaning tape"

              For example, to clean a device by loading the cleaning cartridge
              in slot 6, use the -S option.  Slot 6 must  be  a  slot  in  the
              jukebox  set  aside  for cleaning cartridges, and must contain a
              cleaning  cartridge  with  uses  remaining.  To   clean   device
              /dev/nrst1, include the -f option.
                 nsrjb -l -S 6 -f /dev/nrst1

       Unloading a volume
              You  can unload a particular volume, slot, or device.  To unload
              volume mars.0028, use the -u option:
                 nsrjb -u mars.0028

              To unload the volume in slot 28, use the -S option:
                 nsrjb -u -S 28

              To unload the volume in device /dev/nrst3, use the -f option.
                 nsrjb -u -f /dev/nrst3

       Displaying the jukebox's current volumes
              To display a list of slots and volumes, and  which  volumes  are

       Setting the number of uses for a cleaning cartridge:
              To set the number of times all cleaning cartridges in a  jukebox
              may be used to 12, use the -U option:
                 nsrjb -U 12

              To set the number of times the cleaning cartridge in slot 10 may
              be used, use the -S option:
                 nsrjb -U 25 -S 10

              Slot 10 must be a slot set aside for cleaning cartridges in  the
              jukebox.

       Inventorying the volumes:
              To reconcile the actual volumes and the list of volumes produced
              by nsrjb, use the -I option.  Each volume may be loaded  into  a
              device and examined for a NetWorker label (depending on bar code
              settings and other factors). The internal list is  then  updated
              with the new information.  After all volumes have been examined,
              the new list is compared to the NetWorker media database, and  a
              message  listing  any  volumes located in the jukebox but not in
              the database is produced.  To inventory the volumes in slots  17
              through 43, use the -S option:
                 nsrjb -I -S 17-43

              Like labeling, volume inventory may take considerable time.

       Using the NetWorker notification system:
              When NetWorker needs a volume, a "media event" is generated.  To
              have nsrjb automatically respond to these events, the  NetWorker
              notification  system  is  used.   This  notification resource is
              automatically generated.

       Using the cartridge access port:
              To withdraw cartridges from jukebox slot 7  through  11  to  the
              cartridge access port 5 through 10, use the -w option along with
              the -S and -P options:
                 nsrjb -w -S 7-11 -P 5-10

              To deposit cartridges into jukebox slot 8 through  10  from  the
              cartridge  access port 3 through 5, use the -d option along with
              the -S and -P options:
                 nsrjb -d -S 8-10 -P 3-5

       Using barcode templates on tape libraries:
              To add volumes with barcodes D001A, D002A,  ...,  D100A  to  the
              volumes  available for NetWorker in the tape library, use the -a
              and -T options:
                 nsrjb -a -T D/001-100/A

              For a SmartMedia jukebox, to allocate 3 volumes from  any  media
              and  to make the volumes available for NetWorker, use the -a and
              -a options:
                 nsrjb -a -T +3

              To deposit tapes labeled with barcodes D001A, D002A, ...,  D012A

              To remove volume with barcode D055A from the  volumes  available
              for  NetWorker  in the tape library, and to withdraw it from the
              tape library physically (for example, for off-site storage), use
              the -x and -T options, along with the -w option:
                 nsrjb -x -T D055A -w

              To  label  volumes  with barcodes D010A, D011A, ... , D020A, use
              the -L and -T options:
                 nsrjb -L -T D0/10-20/A

              To add cleaning cartridge with barcodes C010A, that can be  used
              the  default  number of time for this jukebox, use the -U and -T
              options:
                 nsrjb -U default -T C010A

       Forcing an unload of all drives on a tape library:
                 nsrjb -HH

FILES

       /nsr/mm/mmvolume  The NetWorker media database.

       /nsr/res/nsrdb    The  configuration   database   containing   resource
                         descriptors.

       /nsr/res/smdevmap.txt
                         The  file used to map from SmartMedia media and drive
                         types to a  NetWorker  device  resource  media  type.
                         jukebox.

SEE ALSO

       jbconfig(1), jbexercise(1), mminfo(1), mmlocate(1), nwadmin(1), nsr(1),
       nsrd(1), nsr_layout(5), nsr_device(5), nsr_jukebox(5),
       nsr_notification(5), nsr_storage_node(5), nsradmin(1), nsrim(1),
       nsrmm(1), nsrmmd(1), nsrwatch(1)

DIAGNOSTICS

       Some errors have been classified and can  be  identified  by  the  last
       three  digits  of the error number returned by the nsrjb command.  Non-
       classified errors are listed first.

       must be run by root
              A normal (non-super) user has attempted to use this command.

       No drives are available for use (busy, secure,
              or disabled).
              This message is logged when the jukebox tries to acquire a drive
              to satisfy a backup or recover media request.  If the drives are
              not actively saving or recovering, then the device is secured or
              disabled.   Devices  are secured in the pool resources.  Devices
              are enabled or disabled in the device resources.

       All drives are busy or disabled.
              If the drives are not actively saving or  recovering,  then  the
              device  is  disabled.   Devices  are  enabled or disabled in the
              devices window.

       /dev/nrst2: verifying label, error opening: waiting to
       All volume names for 'xyz' are in use
              All the volume names for the given template have been used.  The
              operator should change the template to accommodate  more  volume
              names.

       No volumes found in the media database...continuing.
              The  media  database is empty.  The user will typically see this
              message when the module has been newly installed or all  volumes
              have been deleted.

       Another nsrjb is already running, please wait...
              Another  nsrjb command is accessing a jukebox.  The current com-
              mand will keep attempting to  access  the  device  periodically.
              Once  it  has  acquired  the jukebox device, it will display the
              message 'Continuing,'.

       slot 'xyz' does not have a bar code label
              An inventory operation was attempted with the  jukebox  resource
              attribute match bar code labels enabled, while the media did not
              have a label.  Either disable the  attribute  with  nsradmin  or
              nwadmin, or place a bar code label on the media.

       slot 'xyz' has a duplicate bar code label 'xyz'
              Two or more media volumes have the same bar code label attached.
              Either disable the attribute with nsradmin or nwadmin, or  place
              a unique bar code label on the media volume.

       (001) Unknown jukebox model
              The model for this jukebox is not known to the NetWorker jukebox
              module.

       (006) Unknown control port
              There is no control port listed for this jukebox.

       (007) Invalid range
              The given range could not be parsed by nsrjb .

       (010) Source component empty
              The jukebox attempted to move media between  components  in  the
              jukebox (for example, from a slot to a drive), but found nothing
              in the source component.

       (011) Destination component full
              The jukebox attempted to move media between  components  in  the
              jukebox  (for  example, from a slot to a drive), but found some-
              thing already in the destination component.

       (012) All slots full
              The jukebox attempted to unload a drive as part of a reset  (-H)
              operation,  with  all  slots containing media.  Empty one of the
              slots or remove the media located in the drive from the jukebox.

       (013) Slot xxx is empty.
              This  is often seen during a label operation.  The labeling pro-
              cess stops as soon as an empty  slot  is  encountered.   If  you
              attempt  to  label  a  range of slots on jukeboxes that have the
              ability to sense whether or not the slots are loaded, the  error
              message is as follows:

       (017) Unsupported operation
              This  jukebox  does  not  have  the functionality to support the
              requested operation.

       (025) Vendor error occurred
              Normally you would not see the message  Vendor  error  occurred.
              Instead,  you  would see an error string retrieved directly from
              the jukebox or device driver.  The operator should  consult  the
              hardware or driver manual to determine the cause of the error.

       (027) All drives full/busy
              All drives are loaded and/or busy at the moment.  Free up one of
              the drives by unloading the device.  If all drives are  in  use,
              you must wait for a drive to become idle.

       (029) Unable to retrieve any volume information from the
              media database
              Indicates  that  nsrjb could not access any volumes in the media
              database.

       (036) All of the devices are in use by nsrmmd
              The jukebox could not acquire a drive  to  use  for  a  save  or
              recover.

       (038) All drives must be unloaded before jukebox resource
              can be deleted
              You  cannot  delete a jukebox resource if any volumes are loaded
              in the media drives.  Unload all media drives before  attempting
              to delete the jukebox resource.  If no devices are loaded, issue
              the nsrjb command with the -H option.

       (039) This command only valid with a single slot
              specified
              You can only specify a single slot is, not a range of slots, for
              example, -S 4-6, on which to operate.

       (040) The drive is loaded with a volume from a different
              slot
              The  user  specified  both  a  volume and the -f option, but the
              drive already has a volume loaded from a different slot.

       (041) The drive is empty
              Need a volume loaded on which to operate.

       (042) Will not overwrite volume without confirmation
              NetWorker does not allow you to overwrite a volume with a  valid
              NetWorker label without confirmation.

       (043) The volume name does not match what has been
              inventoried. Please re-inventory the volume.
              The  jukebox  encountered  a  volume with a different label than
              expected.  The operator should reinventory the jukebox.

       (044) The volume from that slot is loaded in another
              drive
              The user specified both the -f and -s options,  but  the  volume
              from the given slot is loaded in another drive.

       (048) Too many devices
              The  user  tried  to add too many devices during the creation of
              the jukebox.

       (049) Unlabeled volume, loaded but not mounted
              The user tried to load a volume, but no label was found  on  the
              media.

       (050) Drive door closed
              The  user  was  trying to perform an unload operation.  When the
              jukebox went to move the media from the drive  to  a  slot,  the
              transport found the media drive door closed.

       (051) Unable to select a suitable volume in response
              to media request
              The  jukebox module could not find any volumes in the devices to
              respond to a media request.

       (054) The drive is busy.  Please try again later.
              An operation was attempted on a media device assigned a save  or
              recover  session.   Try the operation again later when the media
              drive is free.

       (055) No element status capability for this jukebox.
              -E ignored.
              The jukebox does not have  element  status  capability.  The  -E
              option is ignored.

       (056) The drive is disabled.  Enable the drive or
              choose another.
              The  media drive specified is disabled.  If this media device is
              the only one in the jukebox, then it must be enabled for use  by
              nsrjb.   If there are other media devices enabled, try selecting
              one of them.

       (057) The media pool is not allowed on this device.
              The media drive specified is not allowed to mount  volumes  from
              the media pool specified.  Either change the media pool configu-
              ration to allow mounts of the pool on this device, or try  using
              another device.

       (058) All the media drives are disabled.
              All  the media drives are disabled.  Enable one or more devices,
              or select another jukebox or media device outside the  currently
              selected jukebox.

       (059) The media pool is not allowed on any of the drives.
              None  of  the  media drives in this jukebox are allowed to mount
              volumes from the media pool specified.  Either change the  media
              pool configuration to allow mounts of the pool on these devices,
              or try using another jukebox device or media device outside  the
              currently selected jukebox.

       (060) All drives are busy, disabled, or do not allow
              media from this pool.
              See  error  descriptions (027), (058), and (059).  Some combina-
              tion of these three errors is preventing  the  requested  opera-
              tion.

ADVERTISEMENT