QUERY DEVCLASS (Display information on one or more device classes)

Use this command to display information about one or more device classes.

Privilege class

Any administrator can issue this command.

Syntax

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 
CLOUDDEVC    Sequential       0  CLOUD

See Field descriptions for field descriptions.

Example: 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:
                Retry Interval:
                        Shared:
       Primary Allocation (MB):
     Secondary Allocation (MB):
                   Compression:
                     Retention:
                    Protection:
               Expiration Date:
                          Unit:
               Connection Name:
           Cloud Storage Class:
      Logical Block Protection: 
Last Update by (administrator): ADMIN
         Last Update Date/Time: 05/31/2000 13:15:36

See Field descriptions for field descriptions.

Example: 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:
                Retry Interval:
                        Shared:
                        High-level Address: 
                          WORM: No
               Scaled Capacity: 90
              Drive Encryption: On
       Primary Allocation (MB):
     Secondary Allocation (MB):
                   Compression:
                     Retention:
                    Protection:
               Expiration Date:
                          Unit:
               Connection Name:
           Cloud Storage Class:
      Logical Block Protection: Read/Write
Last Update by (administrator): SERVER_CONSOLE
         Last Update Date/Time: 08/04/03 14:28:31

See Field descriptions for field descriptions.

Example: Display detailed information for a specific CLOUD device class

Display full details on the CLOUDDEVCLASS device class.

query devclass clouddevclass format=detailed

             Device Class Name: CLOUDDEVCLASS
        Device Access Strategy: Sequential
            Storage Pool Count: 0
                   Device Type: CLOUD
                        Format:
         Est/Max Capacity (MB):
                   Mount Limit:
              Mount Wait (min):
         Mount Retention (min):
                  Label Prefix:
                  Drive Letter:
                       Library:
                     Directory:
                   Server Name:
                  Retry Period:
                Retry Interval:
                        Shared:
               Connection Name: CLOUDCONNECTION
           Cloud Storage Class: COLDLINE
      Logical Block Protection:
Last Update by (administrator): ADMIN
         Last Update Date/Time: 11/11/2019 13:15:36

See Field descriptions for field descriptions.

Field 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.

Shared

Whether this FILE device class is shared between the server and one or more storage agents.

High-level Address

The IP address of the device in dotted decimal format.

Minimum Capacity

The minimum capacity of a volume that is associated with the device class.

WORM

Whether this drive is a write once, read many (WORM) device.

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.

Scaled Capacity

The percentage of the media capacity that can be used to store data.

Primary Allocation (MB)

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 (MB)

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.

Connection Name

The name of the connection to the cloud environment.

Cloud Storage Class

Specifies the type of Amazon Web Services (AWS) with Simple Storage Service (S3) or Google Cloud Storage storage class.

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

Table 1. Commands related to QUERY DEVCLASS
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.