UNIT-ATTRIBUTES

File 6
Op-Sys z/OS, z/VSE
Statement FIND
Task Retrieve information relating to devices, for example, unit address, device, device type, online/offline status, free cylinders.

Common Fields for all Operating Systems

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  

Additional Fields Supported for z/OS

Dictionary Field Name F/L Mu DE Remarks
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 Operating System
ACTIVITY (A9) z/OS, z/VSE

Activity of device. Possible values:

Value Explanation
ALLOCATED Device allocated.
BUSY Device busy.
Field Name Type/Length Operating System
CLASS (A4) z/OS, z/VSE

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 Operating System
CONTIG-CYLINDERS (N7) z/OS

Number of cylinders in largest free extent.

Field Name Type/Length Operating System
CONTIG-CYLINDERS-TRACK-MANAGED (N7) z/OS

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

Field Name Type/Length Operating System
CONTIG-TRACKS (N4) z/OS

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

Field Name Type/Length Operating System
EAV (A3) z/OS

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

  • NO

  • YES

Field Name Type/Length Operating System
DCB-COUNT (N3) z/OS, z/VSE

Number of DCBs currently open on the unit.

Field Name Type/Length Operating System
DENSITY (A9) z/OS, z/VSE

Tape density. Possible values:

Value Explanation
800  Bits per inch (bpi)
800/1600 
1600 
1600/6250 
6250 
Field Name Type/Length Operating System
DEVICE-STATUS (A7) z/OS, z/VSE

Possible values:

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

 

Field Name Type/Length Operating System
DEVICE-TYPE (B4) z/OS, z/VSE

UCBTYP device type internal code.

Field Name Type/Length Operating System
FREE-CYLINDERS (N7) z/OS

Number of free cylinders on disk pack.

Field Name Type/Length Operating System
FREE-CYLINDERS-TRACK-MANAGED (N7) z/OS

Number of free cylinders in track managed space on volume.

Field Name Type/Length Operating System
FREE-EXTENTS (N4) z/OS

Number of free extents on disk pack.

Field Name Type/Length Operating System
FREE-EXTENTS-TRACK-MANAGED (N4) z/OS

Number of free extents in track managed space on volume.

Field Name Type/Length Operating System
FREE-TRACKS (N4) z/OS

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

Field Name Type/Length Operating System
MOUNT-STATUS (A10) z/OS

Possible values:

  • MOUNT PEND

  • NOT READY

  • REMOVABLE

  • RESERVED

  • RESIDENT

Field Name Type/Length Operating System
SERIES (A6) z/OS, z/VSE

Device series, for example, 3330-1.

Field Name Type/Length Operating System
SMS (A3) z/OS

Whether device is SMS-managed. Possible values:

  • NO

  • YES

Field Name Type/Length Operating System
TOTAL-CYLINDERS (N7) z/OS

Total number of cylinders on disk pack.

Field Name Type/Length Operating System
TOTAL-CYLINDERS-TRACK-MANAGED (N7) z/OS

Total number of cylinders in track managed space on volume.

Field Name Type/Length Operating System
TRACKS-PER-CYLINDER (N3) z/OS

Number of tracks per cylinder.

Field Name Type/Length Operating System
UCB-ADDRESS (B4) z/OS, z/VSE

Memory address of unit control block for unit.

Field Name Type/Length Operating System
UNIT (A4) z/OS, z/VSE

Unit address in EBCDIC.

Field Name Type/Length Operating System
UNIT-HEX (B2) z/OS, z/VSE

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

Field Name Type/Length Operating System
VOLSER (A6) z/OS, z/VSE

Volume serial number currently mounted on the unit.

Field Name Type/Length Operating System
VOLUME-STATUS (A8) z/OS, z/VSE

Possible values:

z/OS: PRIVATE PUBLIC STORAGE
z/VSE: SYSRES (system-resident)
Field Name Type/Length Operating System
VTOC-TYPE (A1) z/OS

Type of VTOC. Possible values:

Value Explanation
I  Indexed.
N  Normal.