QUERY DEVCLASS (Display information on one or more device classes)
Use this command to display information on one or more device classes.
Privilege class
Any administrator can issue this command.
Syntax
.-*-----------------. >>-Query DEVclass--+-------------------+------------------------> '-device_class_name-' .-Format--=--Standard-----. >--+-------------------------+--------------------------------->< '-Format--=--+-Standard-+-' '-Detailed-'
Parameters
- device_class_name
- Specifies the name of the device class to be queried. This parameter is optional. You can use wildcard characters to specify this name. All matching device classes are displayed. If you do not specify a value for this parameter, all device classes are displayed.
- Format
- Specifies how the information is displayed. This parameter is
optional. The default value is STANDARD. Possible
values are:
- Standard
- Specifies that partial information is displayed for the specified device class.
- Detailed
- Specifies that complete information is displayed for the specified device class.
Example: List all device classes
Display information on all device classes.query devclass
Device Device Storage Device Format Est/Max Mount
Class Access Pool Type Capacity Limit
Name Strategy Count (MB)
----------- ---------- ------- ------ ------ -------- -----
8MMTAPE Sequential 1 8MM DRIVE 6,144.0 2
DISK Random 4
PLAINFILES Sequential 1 FILE 50.0 1
8MMSP2 Sequential 2 8MM DRIVE 44.4 DRIVES 
Device Device Storage Device Format Est/Max Mount
Class Access Pool Type Capacity Limit
Name Strategy Count (MB)
----------- ---------- ------- -------- ------ -------- ------
DISK Random 3
8MMTAPE Sequential 1 GENTAPE DRIVE 6,144.0 2
PLAINFILES Sequential 1 FILE 50.0 1Example: Display detailed information for a specific FILE device class
Display information in full detail on the PLAINFILES device class.query devclass plainfiles format=detailed Device Class Name: PLAINFILES
Device Access Strategy: Sequential
Storage Pool Count: 1
Device Type: FILE
Format:
Est/Max Capacity (MB): 50.0
Mount Limit: 1
Mount Wait (min):
Mount Retention (min):
Label Prefix:
Drive Letter:
Library:
Directory:
Server Name:
Retry Period:
Two-Sided:
Retry Interval:
Shared:
Primary Allocation (MB):
Secondary Allocation (MB):
Compression:
Retention:
Protection:
Expiration Date:
Unit:
Logical Block Protection:
Last Update by (administrator): ADMIN
Last Update Date/Time: 05/31/2000 13:15:36Example: Display detailed information for a specific 3592 device class
Display full details on the 3592 device class.query devclass 3592 format=detailed Device Class Name: 3592
Device Access Strategy: Sequential
Storage Pool Count: 1
Device Type: 3592
Format: 3592
Est/Max Capacity (MB):
Mount Limit: DRIVES
Mount Wait (min): 60
Mount Retention (min): 60
Label Prefix: ADSM
Drive Letter:
Library: MANLIB
Directory:
Server Name:
Retry Period:
Two-Sided:
Retry Interval:
Shared:
HLAddr:
WORM: No
Scaled Capacity: 90
Drive Encryption: On
Primary Allocation (MB):
Secondary Allocation (MB):
Compression:
Retention:
Protection:
Expiration Date:
Unit:
Logical Block Protection: Read/Write
Last Update by (administrator): SERVER_CONSOLE
Last Update Date/Time: 08/04/03 14:28:31Field descriptions
- Device Class Name
- The name of the device class.
- Device Access Strategy
- How data is written to the device class.
- Storage Pool Count
- The number of storage pools that are assigned to the device class.
- Device Type
- The device type of the device class.
- Format
- The recording format.
- Est/Max Capacity (MB)
- The estimated or maximum capacity of a volume that is associated with the device class.
- Mount Limit
- The maximum number of sequential access volumes that can be mounted concurrently or specifies that DRIVES is the mount limit.
- Mount Wait (min)
- The maximum number of minutes to wait for a sequential access volume to be mounted.
- Mount Retention (min)
- The number of minutes to retain an idle sequential access volume before dismounting it.
- Label Prefix
- The high-level qualifier of the data set name that the server writes into the sequential access media labels.
- Drive Letter
- The drive letter for a removable file.
- Library
- The name of the defined library object that contains the drives that are used by the device class.
- Directory
- The directory or directories for a shared FILE device class.
- Server Name
- The name of a defined server.
- Retry Period
- The interval over which the server attempts to contact a target server if communications failure is suspected.
- Retry Interval
- How often the retries are done within a retry period.
- Two-Sided
- Whether a removable file is two-sided.
- Shared
- Whether this FILE device class is shared between the server and one or more storage agents.
- HLAddress
- The IP address of the device in dotted decimal format.
- WORM
- Whether this drive is a write once, read many (WORM) device.
- Scaled Capacity
- The percentage of the media capacity that can be used to store data.
- Drive Encryption
- Whether drive encryption is allowed. This field applies only to volumes in a storage pool that is associated with a device type of 3592, LTO, or ECARTRIDGE.
- Primary Allocation
- For FILE device classes that represent storage
that is managed by a z/OS® media
server.
Specifies the initial amount of space that is dynamically allocated
when a new volume is opened.
- Secondary Allocation
- For FILE device classes that represent storage
that is managed by a z/OS media
server.
Specifies the amount of space by which a file volume is extended when
space that is already allocated to the file volume is used up.
- Compression
- For tape device classes that represent storage that is managed
by a z/OS media
server.
Specifies whether the data is compressed.
- Retention
- For tape device classes that represent storage that is managed
by a z/OS media
server.
Specifies the number of days to retain the tape, if retention is used.
- Protection
- For tape device classes that represent storage that is managed
by a z/OS media
server.
Specifies whether the volumes are protected by the RACF program.
- Expiration Date
- For tape device classes that represent storage that is managed
by a z/OS media
server.
Specifies the expiration date that is placed on the tape labels for
this device class, if expiration is used.
- Unit
- For tape device classes that represent storage that is managed
by a z/OS media
server.
Specifies the esoteric unit name for the group of tape devices.
- Logical Block Protection
- Specifies whether logical block protection is enabled and, if
it is, the mode. Possible values are Read/Write, Write-only, and No.
You can use logical block protection only with the following types
of drives and media:
- IBM® LTO5 and later
- IBM 3592 Generation 3 drives and later with 3592 Generation 2 media and later
- Oracle StorageTek T10000C and T10000D drives
- Last Update by (administrator)
- The administrator that made the last update to the device class.
- Last Update Date/Time
- The date and time of the last update.
Related commands
| Command | Description |
|---|---|
| DEFINE DEVCLASS | Defines a device class. |
| DEFINE DEVCLASS (z/OS media server) |
Defines a device class to use storage managed
by a z/OS media server. |
| DEFINE SERVER | Defines a server for server-to-server communications. |
| DELETE DEVCLASS | Deletes a device class. |
| QUERY DIRSPACE | Displays information about FILE directories. |
| QUERY SERVER | Displays information about servers. |
| UPDATE DEVCLASS | Changes the attributes of a device class. |
| UPDATE DEVCLASS (z/OS media server) |
Changes the attributes of a device class
for storage managed by a z/OS media
server. |