Get diagnostic cartridges

Retrieves information about the diagnostic cartridges in the library.

Request syntax

GET /v1/diagnosticCartridges
Retrieves information about all diagnostic cartridges in the tape library.

GET /v1/diagnosticCartridges/<volser>
Retrieves information about the diagnostic cartridge with the specified VOLSER number.

GET /v1/diagnosticCartridges/<internalAddress>
Retrieves information about the diagnostic cartridge with the specified internalAddress.

Path parameters

volser (string)

The volume serial number (VOLSER) or bar code number of the cartridge.

internalAddress (string)

The unique identifier of the cartridge within the library represented by a 6-character hex string. If there are duplicate VOLSERs, this value is used to identify the cartridge. The value changes if the cartridge is assigned or unassigned from a logical library or if the cartridge is moved by the host or library. Query the value before you use.

Example

> GET /v1/diagnosticCartridges
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 560

[
     {
          "volser": "DG 011L2", 
          "state": "normal", 
          "accessible":"normal"
          "location": "slot_F1C10R7T0", 
          "mediaType": "3592", 
          "mostRecentUsage": "2019-03-29T11:12:04-0700"
          "internalAddress": "FF0402"
     }, {
          . . .
     }
]

Attributes

volser (string)

The volume serial number (VOLSER) or bar code number of the cartridge.

state (string)
The health status of the diagnostic cartridge. Values include the following in the priority order:
Table 1.
State Description

unknown

The state recorded by firmware for this resource is unknown. Reset the LCC node card and contact IBM for support if issue persists.

exportQueued

The cartridge is queued to be moved to an I/O station.

importing The cartridge is being imported. The import is complete when the host application performs a move of the cartridge.

normal

The cartridge status is normal.

accessible (string)

Indicates whether the cartridge is accessible by all accessors or not. Values include normal when all installed accessors have normal access to the cartridge as defined by the elastic capacity library setting, limited when one accessor in a dual-accessor library is unable to reach the cartridge due to errors, and no when none of the installed accessors can reach the drive due to errors.

location (string)

The current location of the cartridge. This is the location of a gripper, drive, slot, or I/O slot.

mediaType (string)

The media type of the cartridge. Supported values include 3592 and LTO.

mostRecentUsage (string)

The last date and time this cartridge was mounted into a drive, or null if this is unknown or the cartridge has not been mounted. Time format is YYYY-MM-DDThh:mm:ss±hh:mm.

internalAddress (string)

The unique identifier of the cartridge within the library represented by a 6-character hex string. If there are duplicate VOLSERs, this value is used to identify the cartridge. The value changes if the cartridge is assigned or unassigned from a logical library or if the cartridge is moved by the host or library. Query the value before you use.