IBM Tivoli Storage Manager, Version 7.1

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

Read syntax diagramSkip visual syntax diagram
                   .-*-----------------.   
>>-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
AIX operating systems Linux operating systems Sun Solaris operating systems Windows operating systems
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 
HP-UX operating systems
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       1
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:
Windows operating systems                   Drive Letter:
                       Library:
                     Directory:
                   Server Name:
                  Retry Period:
Windows operating systems                      Two-Sided:
                Retry Interval:
AIX operating systems Linux operating systems Sun Solaris operating systems Windows operating systems                         Shared:
AIX operating systems Linux operating systems        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: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
Windows operating systems                   Drive Letter:
                       Library: MANLIB
                     Directory:
                   Server Name:
                  Retry Period:
Windows operating systems                      Two-Sided:
                Retry Interval:
AIX operating systems Linux operating systems Sun Solaris operating systems Windows operating systems                         Shared:
                        HLAddr: 
                          WORM: No
               Scaled Capacity: 90
              Drive Encryption: On
AIX operating systems Linux operating systems        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:31
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 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.
Windows operating systems 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.
AIX operating systems Linux operating systems 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.
AIX operating systems Linux operating systems 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.
AIX operating systems Linux operating systems Compression
For tape device classes that represent storage managed by a z/OS media server, this specifies whether the data is compressed.
AIX operating systems Linux operating systems 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.
AIX operating systems Linux operating systems 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.
AIX operating systems Linux operating systems 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.
AIX operating systems Linux operating systems 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

Table 1. Commands related to QUERY DEVCLASS
Command Description
DEFINE DEVCLASS Defines a device class.
AIX operating systems Linux operating systems 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.
AIX operating systems Linux operating systems UPDATE DEVCLASS (z/OS media server) Changes the attributes of a device class for storage managed by a z/OS media server.


Feedback