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 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 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 should attempt to contact a target server if communications failure is suspected.
- Retry Interval
- How often the retries are done within a given retry period.
- Two-Sided
- Whether a removable file is two-sided.
- Shared
- Whether this FILE device class will be 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 permitted. This field applies only to volumes in a storage pool associated with a device type of 3592, LTO, or ECARTRIDGE.
- Primary
Allocation
- For FILE device classes that represent storage managed by a z/OS® media server, this 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 managed by a z/OS media server, this 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 managed by a z/OS media server, this specifies whether the data is compressed.
- Retention
- For tape device classes that represent storage managed by a z/OS media server, this specifies the number of days to retain the tape, if retention is used.
- Protection
- For tape device classes that represent storage managed by a z/OS media server, this specifies whether the volumes are protected by the RACF program.
- Expiration
Date
- For tape device classes that represent storage managed by a z/OS media server, this 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 managed by a z/OS media server, this 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 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. |