UNIT-ATTRIBUTES

#### Search Results

Search

# UNIT-ATTRIBUTES

File | 6
Statement | `FIND`
Task | Retrieve information relating to devices, for example, unit address, device, device type, online/offline status, free cylinders.

## Fields

Dictionary Field Name | F/L | Mu | DE | Remarks
--- | --- | --- | --- | ---
`ERROR-CODE` | N3 |  |  |
`ERROR-TEXT` | A58 |  |  |
`NODE` | N5 |  | D |
`NODE-NAME` | A16 |  | D |
`UNIT-HEX` | B2 |  | D |
`UNIT` | A4 |  | D |
`VOLSER` | A6 |  | D |
`CLASS` | A4 |  | D |
`DEVICE-STATUS` | A7 |  | D |
`SERIES` | A6 |  | D |
`VOLUME-STATUS` | A8 |  | D |
`DCB-COUNT` | N3 |  | D |
`ACTIVITY` | A9 |  | D |
`DEVICE-TYPE` | B4 |  | D |
`DENSITY` | A9 |  | D |
`UCB-ADDRESS` | B4 |  | D |
`CONTIG-CYLINDERS` | N7 |  | D |
`CONTIG-CYLINDERS-TRACK-MANAGED` | N7 |  | D |
`CONTIG-TRACKS` | N4 |  | D |
`EAV` | A3 |  | D |
`FREE-CYLINDERS` | N7 |  | D |
`FREE-CYLINDERS-TRACK-MANAGED` | N7 |  | D |
`FREE-EXTENTS` | N4 |  | D |
`FREE-EXTENTS-TRACK-MANAGED` | N4 |  | D |
`FREE-TRACKS` | N4 |  | D |
`MOUNT-STATUS` | A10 |  | D |
`SMS` | A3 |  | D |
`TOTAL-CYLINDERS` | N7 |  | D |
`TOTAL-CYLINDERS-TRACK-MANAGED` | N7 |  | D |
`TRACKS-PER-CYLINDER` | N3 |  | D |
`VTOC-TYPE` | A1 |  | D |

## Field Descriptions

Field Name | Type/Length
--- | ---
`ACTIVITY` | (A9)

Activity of device. Possible values:

Value | Explanation
--- | ---
`ALLOCATED` | Device allocated.
`BUSY` | Device busy.

Field Name | Type/Length
--- | ---
`CLASS` | (A4)

The device class. Possible values:

Value | Explanation
--- | ---
`COMM` | Communications.
`CTCA` | Channel-to-channel adapter.
`DASD` | Direct access.
`DISP` | Display station.
`TAPE` | Tape.
`UREC` | Unit record.

Field Name | Type/Length
--- | ---
`CONTIG-CYLINDERS` | (N7)

Number of cylinders in largest free extent.

Field Name | Type/Length
--- | ---
`CONTIG-CYLINDERS-TRACK-MANAGED` | (N7)

Number of cylinders in largest free extent in track managed space on volume.

Field Name | Type/Length
--- | ---
`CONTIG-TRACKS` | (N4)

Number of tracks in largest free extent (in addition to `CONTIG-CYLINDERS`).

Field Name | Type/Length
--- | ---
`EAV` | (A3)

Specifies whether a device is an Extended Address Volume. Possible values:

- `NO`

- `YES`

Field Name | Type/Length
--- | ---
`DCB-COUNT` | (N3)

Number of DCBs currently open on the unit.

Field Name | Type/Length
--- | ---
`DENSITY` | (A9)

Tape density. Possible values:

Value | Explanation
--- | ---
`800` | Bits per inch (bpi)
`800`/`1600`
`1600`
`1600`/`6250`
`6250`

Field Name | Type/Length
--- | ---
`DEVICE-STATUS` | (A7)

Possible values:

Value | Explanation
--- | ---
`CHANGE` | Status changing.
`OFFLINE` | Device is offline.
`ONLINE` | Device is online.

Field Name | Type/Length
--- | ---
`DEVICE-TYPE` | (B4)

UCBTYP device type internal code.

Field Name | Type/Length
--- | ---
`FREE-CYLINDERS` | (N7)

Number of free cylinders on disk pack.

Field Name | Type/Length
--- | ---
`FREE-CYLINDERS-TRACK-MANAGED` | (N7)

Number of free cylinders in track managed space on volume.

Field Name | Type/Length
--- | ---
`FREE-EXTENTS` | (N4)

Number of free extents on disk pack.

Field Name | Type/Length
--- | ---
`FREE-EXTENTS-TRACK-MANAGED` | (N4)

Number of free extents in track managed space on volume.

Field Name | Type/Length
--- | ---
`FREE-TRACKS` | (N4)

Number of free tracks (in addition to `FREE-CYLINDERS`).

Field Name | Type/Length
--- | ---
`MOUNT-STATUS` | (A10)

Possible values:

- `MOUNT PEND`

- `NOT READY`

- `REMOVABLE`

- `RESERVED`

- `RESIDENT`

Field Name | Type/Length
--- | ---
`SERIES` | (A6)

Device series, for example, `3330-1`.

Field Name | Type/Length
--- | ---
`SMS` | (A3)

Whether device is SMS-managed. Possible values:

- `NO`

- `YES`

Field Name | Type/Length
--- | ---
`TOTAL-CYLINDERS` | (N7)

Total number of cylinders on disk pack.

Field Name | Type/Length
--- | ---
`TOTAL-CYLINDERS-TRACK-MANAGED` | (N7)

Total number of cylinders in track managed space on volume.

Field Name | Type/Length
--- | ---
`TRACKS-PER-CYLINDER` | (N3)

Number of tracks per cylinder.

Field Name | Type/Length
--- | ---
`UCB-ADDRESS` | (B4)

Memory address of unit control block for unit.

Field Name | Type/Length
--- | ---
`UNIT` | (A4)

Unit address in EBCDIC.

Field Name | Type/Length
--- | ---
`UNIT-HEX` | (B2)

Binary device number, used for comparisons (`X'12A'` > `X'120'`, but `'12A'` < `'120'`).

Field Name | Type/Length
--- | ---
`VOLSER` | (A6)

Volume serial number currently mounted on the unit.

Field Name | Type/Length
--- | ---
`VOLUME-STATUS` | (A8)

Possible values:

`PRIVATE PUBLIC STORAGE`

Field Name | Type/Length
--- | ---
`VTOC-TYPE` | (A1)

Type of VTOC. Possible values:

Value | Explanation
--- | ---
`I` | Indexed.
`N` | Normal.

### On this page

- Fields
- Field Descriptions