NSR jukebox

The NSR jukebox resource describes the physical characteristics of each autochanger known to Backup by a single resource of type NSR Jukebox.To edit the NSR jukebox resources for a Backup server use "nsradmin " or "nwadmin".

The NSR jukebox resource has the following attributes:

• The name attribute specifies the name of a jukebox.

• The model attribute specifies the jukebox model.

• The physical slots attribute specifies the first and last physical slot numbers in the jukebox. The first slot number must be less than or equal to the last slot number, and specified as two separate attribute values. For Silo Tape Libraries this attribute is equal to the number of volumes allocated to a Backup server.

• The control port attribute specifies the path of the control port, for the jukebox robotics. Control commands are then sent to the jukebox, from the control port. For Silo Tape Libraries this attribute specifies the hostname and type of the Silo Tape Libraries server.

• The devices attribute identifies device pathnames for each device residing within a jukebox. The entries are listed in the same order as they were physically installed in the jukebox.

• The number devices attribute identifies the number of configured devices in the jukebox.

• The write enabled attribute indicates if the mounted volume can be written to.

• The bar code reader attribute indicates if Backup is using the bar code label from the media when a jukebox has a bar code label reader.

• The match bar code labels attribute indicates if Backup is using the bar code label, instead of a label template, when labeling media volumes.

• The volume expiration attribute specifies the expiration time for a volume that is currently being labeled, or specifies the time a volume within a jukebox will end interaction with external media management services.

• The available slots attribute specifies the slots containing volumes available to be written to by Backup requests. The slots are specified by a range which may be a single slot number or a pair of slot numbers separated by a dash. The first number is less than or equal to the second. When satisfying requests to mount a particular volume or slot, all of the volumes within the physical slots can be used.

• The enabler code attribute identifies the enabler code for a NSR license resource corresponding to a jukebox resource.

• The operation attribute identifies the current jukebox operation.

• The operation message attribute displays error messages when an jukebox operation fails.

• The operation device attribute passes device names to current operations.

• The operation slots attribute passes slots to current operations.

• The operation options attribute passes the mode of a volume to the current operation.

• The operation barcodes attribute passes volume tags or barcodes to the current operation.

• The operation response attribute identifies the default response to questions asked while performing an operation.

• The operation report mode attribute identifies the amount of output generated during operation execution.

• The operation label state attribute designates the operation to be performed on a labeled volume as; to be recycled or to be unlabeled.

• The operation volume capacity attribute specifies a volume's capacity.

• The operation volume type attribute specifies the types of volumes that may be considered when allocating a volume.

• The operation ineligible attribute specifies volumes ineligible for the current operation.

• The operation task attribute designates a secondary task or operation to be performed with the current operation.

• The operation result attribute reports error messages for multiple operations. This attribute maintains error messages for 32 simultaneous operations performed on a jukebox, that failed.

• The operation instance attribute specifies the instance number associated with an operation.

• The operation next instance attribute specifies the instance number associated with the next simultaneous operation.

• The operation instances attribute specifies the instance number for each simultaneous operation currently executing.

• The operation hostname attribute identifies the name of the system an operation is to executed.This attribute is used for jukeboxes who support devices, attached to multiple hosts, where the host machine may be inferred from other attributes, such as operation device.

• The operation template attribute specifies the template a label operation will use.

• The operation volume pool attribute specifies the default volume pool for label operations.

• The operation source pool attribute specifies the pool a volume will be selected for recycling.

• The operation uses left attribute indicates the number of times a cleaning cartridge can used.

• The volumes attribute specifies the names of resident volumes in corresponding order to the slot number.

• The volume ids attribute specifies the volume identifiers (volid) for resident volumes.

• The volume cartridge ids attribute tracks the identifier for each cartridge h a volume resides.

• The loaded volumes attribute contains the names of volumes currently loaded in jukebox devices.

• The loaded bar codes attribute identifies the bar codes of loaded volumes.

• The loaded slots attribute identifies the slot numbers of loaded volumes.

• The event tag attribute specifies the tag of the last notification event sent to the nsrd service

• The event message attribute is the text of the last notification event sent to the nsrd service.

• The messages attribute specifies the log messages from previous operations nsrjb has completed.

• The minimum space attribute specifies the low water mark of the remaining space on the volumes contained in the available slots.

• The jukebox options attribute specifies the options for this jukebox.

• The auto clean attribute specifies automatic cleaning for each device.

• The cleaning slots attribute identifies the range of slots in a jukebox that have been set aside for cleaning cartridges. For a pair of slot numbers the first number of the pair is less than or equal to the second. When auto clean is set to yes the range of slots specified for this attribute are assumed to contain cleaning cartridges, and the range of slots specified by available slots.

• The default cleanings attribute specifies the number of uses assigned to a new cleaning cartridge during an inventory of a jukebox by nsrjb.

• The auto media management attribute indicates whether automated media management for a jukebox is enabled. If the value is set to yes, unlabeled volumes in a jukebox may be automatically labeled.

• The STL device names attribute specifies silo device names of the devices identified in the devices attribute of a Silo Tape Library.

• The STL interface lib attribute indicates the path name of the dynamically linked Silo Tape interface library.

• The STL device sharing attribute specifies, how device sharing is handled. Device sharing is the automatic, load dependent, device switching for devices within a Silo Tape Library between different connected hosts. When this attribute is specified as perm-max, perm and max are numbers with perm < max, and perm is the number of devices, which can be reserved permanently.

• The STL barcodes attribute indicates the barcodes of the volumes residing within in a Silo Tape library, which are available to Backup.

• The STL device reservation attribute specifies the reservation state of shared devices in a Silo Tape library.

• The application name attribute specifies the name used by a server to identify itself to OpenVault when submitting a request to access resources on a jukebox.

• The application key attribute specifies the key used by a Backup server to identify itself to OpenVault when submitting a request to access resources on jukebox.

• The jukebox lock attribute synchronizes access to resources in a jukebox that supports multiple simultaneous operations. This attribute can be used to lock and unlock a entire jukebox.

• The device locks attribute synchronizes access to device resources in a jukebox that supports multiple simultaneous operations. The first two numbers of this attribute identify a range of devices locked, and the third number is the instance number assigned to the lock operation.

• The volume/slot locks attribute synchronizes access to volume and slot resources in a jukebox. The first two numbers of this attribute identifies the range of volumes/slots locked and the third number is the instance number assigned to the operation holding the lock.

  Following is an example of a NSR jukeboxresource named Huntington:

  type: NSR jukebox; name: Huntington; model: EXB-210; physical slots: 1-11; control port: scsidev@0.6.0; devices: c:\dev\rmt\0mbn, c:\dev\rmt\1mbn; number device: 2; write enabled: Yes; bar code reader: Yes; match bar code labels: Yes; volume expiration: ; available slots: 2-11; enabler code: 012345-6789ab-cdef00; operation: Load; operation device: h:\dev\rmt\0mbn; operation slots: 1-10; operation options: manual; operation barcodes: A01B, A0/3-5/B; operation response: Yes; operation report mode: verbose; operation label state: recycle; operation volume capacity: 10G; operation volume type: 8mm, dlt; operation ineligible: ; operation task: mount after label; operation instance: 3; operation next instance: 2; operation hostname: host1; operation template: default; operation volume pool: NonFull; operation source pool: Default; volumes: venus.001, venus.002, venus.003; volume ids: 24198, 24199, 24200; STL device sharing: 2-4; STL device reservation: ; STL interface lib: h:\usr\lib\libstl.sol; event tag: 6319962287;event message: could not unload device h:\dev\rmt\1mbn; messages: "09/12/97 11:50:56 CREATED"; minimum space: 7g; jukebox options: two_sided; auto clean: Yes; cleaning slots: 1; default cleanings: 12; auto media management: Yes; reset class: initialize unload; jukebox lock: 10; device locks: 1-1-10; volume/slot locks: 1-5-10;