nsrjb

The nsrjb program manages autochangers for Backup servers. Use the nsrjb command, rather than the nsrmm command, to label, load, and unload the volumes contained in an autochanger. Only one nsrjb command can access an autochanger at a time.

The nsrjb program attempts to determine which autochanger to use based on the options -j, -f, or a volume name. If one or more of these options do not uniquely identify an autochanger and one must be selected, the nsrjb program prompts you to choose an autochanger. Alternatively, you can set the NSR_JUKEBOX environment variable to the name of the autochanger you want the nsrjb program to use by default.

The following example describes the format and options available for the nsrjb program:

nsrjb [-C] [-j autochanger-name] [-v]

[-f media-device] [-S slots] [volume-name]
nsrjb -L [-j autochanger-name] [-gnqvM] [-R | -B]

[-Y | -N] [-b pool] [-f media device] [-e expire]

[-c capacity] [-o mode] [-S slots | -T tags]

[volume-name]
nsrjb -l [-j autochanger-name] [-nvqrMR]

[-f media-device] {-S slots | -T tags | volume-name}
nsrjb -u [-j autochanger-name] [-qvM]

[-f media-device] [-S slots -T tags] [volume-name]
nsrjb -I [-j autochanger-name] [-Ev]

[-f media-device] [-S slots | -T tags]
nsrjb -p [-j autochanger-name] [-v]

[-f media-device] [-S slots -T tags]
nsrjb -o mode [-j autochanger-name] [-Y]

{-S slots | media device}
nsrjb -H [-j autochanger-name] [-E] [-v]
nsrjb -h [-j autochanger-name] [-v]
nsrjb -U uses [-j] [-S slots | -T tags]
nsrjb -V [-j autochanger-name] [-v]
nsrjb -d [-j autochanger-name] [-v] [-S slots]

[-P port] [volume-name]
nsrjb -w [-j autochanger-name] [-v] [-S slots]

[-P port] [volume-name]
nsrjb -a [-j autochanger-name] [-v] -T tags
nsrjb -x [-j autochanger-name] [-v] -T tags
nsrjb -F [-j autochanger-name] [-v] -f media-device 

• Use the -b option to specify the pool to which you want to assign the volume. If you omit this option, the volume is automatically assigned to the Default pool.

• Use the -B option to verify that the volume does not already have a readable Backup label. If you specify this option and the volume has a Backup label, the label operation is canceled and an error message is displayed.

• Use the -c option to override the volume's default capacity.

• Use the -C option to display the current volumes in the autochanger and the associated devices. The -C option does not perform an actual inventory.

• Use the -d option to deposit (load into the jukebox) a cartridge from the cartridge access port (CAP).

• Use the -e option to override the default volume expiration date.

• Use the -E option to initialize element status for autochangers that provide this feature. You can use this option in conjunction with the -I or -H options.

• Use the -f option to specify a media device rather than the jukebox control port. Use the pathname of the media device displayed in the NSR jukebox resource.

• Use the -h option to display the actions and results of the past 100 autochanger commands issued.

• Use the -H option to reset the autochanger hardware (and the Backup database that represents the autochanger) to a consistent state. The autochanger clears the transport, and then unmounts and unloads volumes from the drives to slots. An inventory is not done (see the -I option). If the autochanger senses that the inventory is out-of-date, it prints an appropriate message.

• Use the -I option to perform an inventory on the autochanger's contents. The volumes in the specified slots are loaded into a device and their labels are read. Use this option to ensure that the mapping between slot number and volume name is correct. This option may take a long time to complete.

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

  Volumes from slots that are reserved for cleaning cartridges are not loaded during the inventory. If your autochanger does not support the element status or barcode reader features, you must use the -U option to enter a cleaning cartridge into the autochanger's inventory. If your autochanger does support either of these features, the cleaning cartridge is indicated in the inventory with the volume name "cleaning tape."

• Use the -j option to specify a particular autochanger for the nsrjb program to use. The given name is the one that you assigned when you created the NSR jukebox resource for the autochanger. If you supply the -j option, the NSR_JUKEBOX environment variable is overridden.

• Use the -l option to load and mount a volume. You must also specify a volume name or slot number.

• Use the -L option to label the volumes in the specified slots. If you do not specify any slots, the range of slots described in the NSR jukebox resource for the autochanger is used. If the autochanger has a barcode label reader and you set the NSR jukebox resource attributes "barcode reader" and "match barcode labels," the volume label is derived from the barcode label on the media, and the media barcode label will be stored in the Backup media database. If you set the NSR jukebox resource attribute "match barcode labels," the volume label is derived from the label template, although the media barcode label is stored in the Backup media database so that it can be used during inventory operations. You cannot label volumes that are in slots reserved for cleaning cartridges.

• Use the -n option, in combination with the -l option, to load a volume without mounting it. This allows the nsrjb program to control an autochanger that contains non-Backup volumes.

• Use the -N option, in combination with the -LR options, to tell nsrjb to skip the confirmation prompt. When Backup recycles volumes, you normally receive a prompt to confirm that it is okay to overwrite any volumes that Backup considers nonrecyclable.

• Use the -o option to set the mode of a volume or range of slots. Choose one of the following mode values: [not]recyclable, [not]read-only, [not]full or [not]manual. The [not]manual modes are the only valid modes when used with the -l option. If you do not give the -Y option, you are prompted to confirm the operation for each volume. See "nsrim " for a discussion of the per-volume flags.

• Use the -p option to verify and print a volume's label.

• Use the -P option to specify the CAP to load or unload a volume from.

• Use the -q option to run the nsrjb program in quiet mode. You can only use this option in conjunction with the -L, -l, and -u options.

• Use the -R option to recycle the volumes. If a volume is recyclable, you are not prompted to confirm the recycle operation.

• Use the -r option to load a volume as read-only. You can only use this option in conjunction with the -l option.

• Use the -S option to specify a slot or range of slots to operate on. The -l and -u options only accept one slot: the other options accept a range of slots. Specify the slot range in low to high integer order. The range is checked for validity against the Jukeboxes resource that describes the autochanger. You can only specify one slot range at a time.

• Use the -u option to unload a volume from a device or slot.

• Use the -U option with the uses argument to set the number of times a cleaning cartridge may be used. You can use the -T option in conjunction with the -U option to add cleaning cartridges to a silo, which also reserves a slot in the silo for each cleaning cartridge added.

• Use the -v option to tell nsrjb to display verbose information about the commands executed.

• Use the -V option to display vendor-specific status information. When you combine the -V option with the -v option, the configuration of the autochanger is also displayed.

• Use the -w option to withdraw (unload from the jukebox) a cartridge to the CAP.

• Use the -Y option to disable the prompt for confirmation.

  The following options are only valid for Silo Tape Libraries (STL):

• Use the -a option, in conjunction with the -T option, to allocate volumes in an STL for use by a Backup server or storage node. You must allocate a volume before you label it for Backup to use. You can add the -d option for silos that support the deposit (also known as importing or entering) of tapes through the silo's I/O port. The -d option must appear after the -a option on the command line. This function is usually handled by the silo management software, but is provided here for ease of use. The deposit option may not be supported on all the silos that Backup supports. See the -x option for a description of how the volumes are removed from an STL's list of volumes available for use by a Backup server.

• Use the -F option to release a shared device contained in an STL. This option is only available for tape libraries that support shared devices.

• Use the -T option to specify the tags or barcodes of volumes contained in an STL. You can specify a single volume tag or a volume tag template, which is similar to a regular Backup label template. The volume tag template consists of a list of template fields separated by slashes (/), whereas a Backup label template consists of an alphanumeric string or alphabetic or numeric range.

• Use the -x option, in conjunction with the -T option, to remove volumes from the STL's list of volumes available for use by a Backup server or storage node. You can add the -w option for silos that support the withdrawal or ejection of tapes through the silo's I/O port. The -w option must appear after the -x option on the command line. The silo management software usually handles this function, but it is provided here for ease of use. The withdrawal option may not be supported on all the silos that Backup supports. See the -a option for a description of how the volumes are allocated to an STL's list of volumes available for use by a Backup server.