Get I/O stations

Request syntax

Path parameters

location

The unique location of I/O station.

TS4500 example

> GET /v1/ioStations
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 330

[
     {
          "location": "ioStation_F1IOu", 
          "state": "normal", 
          "door": {
                "opened": "no",
                "lastChanged": "2018-09-17T23:02:00"
          }  
          "magazine": { 
                "mediaType": "LTO", 
                "ioSlots": 18, 
                "contentsVolser": ["AAA000", "AAA002", "AAA003", "AAA001",
                null, "AAA000", null, null, null, null, null, null, null,
                null, null, null, null, null],
                "contentsInternalAddress": ["030403", "030404", "030405",
                "030406", null, "030407", null, null, null, null, null,
                null, null, null, null, null, null, null]
          }
    }, {
          "location": "ioStation_F1IOl",
          "state": "closedNoMagazine", 
          "door": {
                "opened": "no",
                "lastChanged": "2018-09-17T23:02:00"
          }
          "magazine": null
     }
]
                  

Diamondback example

> GET /v1/ioStations/ioStation_C3
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 330

[
     {
          "location": "ioStation_C3", 
          "state": "normal", 
          "door": null,  
          "magazine": { 
                "mediaType": "LTO", 
                "ioSlots": 10, 
                "contentsVolser": ["AAA000", "AAA002", "AAA003", "AAA001",
                null, "AAA000", null],
                "contentsInternalAddress": ["030403", "030404", "030405",
                "030406", null, "030407", null]
          }
    
     }
]
                  

Attributes

location (string)

The unique location of the I/O station.

state (string)

The health status of the I/O station. Values include:

State	Description/user action
normal	Status is normal.
closedNoMagazine	TS4500 only The I/O station door was closed without a magazine.
failedToClose	TS4500 only The I/O station door failed to close. Verify that the magazine is fully inserted.
doorOpenTooLong	TS4500 only The I/O station door failed to close. Verify that the magazine is fully inserted.
unknown	The recorded state is unknown. Reset the associated LCC node card. Contact IBM support if this issue persists.

door (object)

A set of attributes describing the I/O station door. For Diamondback, this returns null as there is no door on the I/O station because the access is controlled by rear door.

opened (string)

Open or closed status of the I/O station. One of yes or no.

lastChanged (string)

Last time the I/O station door was opened or closed. This is null before any state change.

magazine (object)

The information about the currently inserted magazine. For TS4500, if the I/O station door is open or no magazine is inserted, null is returned. For Diamondback, if there is no magazine inserted, null is returned.

mediaType(string)

The media type of the cartridge that is supported by the inserted magazine. One of LTO or 3592.

ioSlots(number)

The number of cartridges that can be stored in the inserted magazine. For Diamondback, this returns 20 which represents the two slots with five tiers each.

contentsVolser(array of strings)

List of cartridge VOLSERs currently stored in the inserted magazine. Listed from top to bottom (index 0 is on top). If no cartridge is present, null is returned and if the VOLSER of the cartridge is not known, unknown is returned.

contentsInternalAddress(array of strings)

List of cartridge internal addresses that are currently stored in the inserted magazine. Listed from top to bottom (index 0 is on top). If no cartridge is present, null is returned and if the VOLSER of the cartridge is not known, unknown is returned.

Internal address is used to identify a cartridge when there are duplicate VOLSERs. This can change 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.