IT48933: UNDOCUMENTED FIELDS ENCRYPTED, COMPRESSED, AND COMPRESSED CAPACITY IN QUERY VOLUME

8.2.2.000-IBM-SPSRV-Linuxx86_64
8.2.2.000-IBM-SPSRV-WindowsX64
8.2.2.000-IBM-SPSRV-AIX
8.2.2.000-IBM-SPSRV-Linuxppc64le
8.2.2.000-IBM-SPSRV-Linuxs390x

APAR status

• Closed as documentation error.

Error description

• The IBM Storage Protect Server administrative QUERY VOLUME
  displays three fields Encrypted, Compressed, and Compressed
  Capacity that are not documented.
  
  
  
  Example :
  
  q vol <Vol Id > f=d
                    Volume Name: <Vol Id>
              Storage Pool Name: <ABC>
              Device Class Name: TS1160
             Estimated Capacity: 9.8 T
        Scaled Capacity Applied: 100
                       Pct Util: 100.0
                  Volume Status: Full
                         Access: Read/Write
         Pct. Reclaimable Space: 0.0
                Scratch Volume?: Yes
                In Error State?: No
       Number of Writable Sides: 1
        Number of Times Mounted: 3
              Write Pass Number: 1
      Approx. Date Last Written: <timestamp>
         Approx. Date Last Read: <timestamp>
            Date Became Pending:
         Number of Write Errors: 0
          Number of Read Errors: 0
                Volume Location:
  
  Volume is MVS Lanfree Capable : No
  
  Last Update by (administrator):
          Last Update Date/Time: <timestamp>
           Begin Reclaim Period:
             End Reclaim Period:
   Drive Encryption Key Manager: IBM Spectrum Protect
        Logical Block Protected: No
                      Encrypted: --> undocumented field
                     Compressed: --> undocumented field
            Compressed Capacity: --> undocumented field
  
  IBM Spectrum Protect Versions Affected:
  
  IBM Storage Protect server versions 8.1 and later on all
  supported platforms.
  Additional Keywords: TS020919085, SP, encryption, compression
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * All IBM Storage Protect server users                         *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See error description.                                       *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply fixing level when available. This problem is currently *
  * projected to be fixed in level 8.2.1. Note that this is      *
  * subject to change at the discretion of IBM.                  *
  ****************************************************************
  

Problem conclusion

• The QUERY VOLUME (Query storage pool volumes) topic in IBM
  Documentation has been updated to include the following fields
  in the examples: Encrypted, Compressed, and Compressed Capacity.
  
  This update will be available in the IBM Storage Protect server
  8.2.1 documentation at the following topic URL:
  https://www.ibm.com/docs/en/storage-protect/8.2.1?topic=commands
  -query-volume-query-storage-pool-volumes
  
  Affected platforms:
  AIX, Linux, and Windows
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

Applicable component levels