OA54897: DCOLLECT DCDEXFLG INCORRECTLY DOCUMENTED

APAR status

• Closed as documentation error.

Error description

• DCDEXFLG is not documented on DFSMS Access Method Services
  Commands or manuals. DCDEXFLG can be found under DCOLLECT Output
  Record Structure and is labeled as "COMPRESSIONS FLAGS". There
  is no futher description which can be misleading since DCDEXFLG
  is NOT associated with zEDC encryption. DCDEXFLG flag is an
  extended format field that indicates if the DS is compressed at
  the block level.
  
  DCDEXFLG should have a description under DCOLLECT Output Record
  Field Descriptions->Active Data Set Record Field.
  
  CATKEYS: IDCDCOLL
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All DFSMS DCOLLECT users affect.             *
  ****************************************************************
  * PROBLEM DESCRIPTION: The Documentation of DCDEXFLG is added  *
  *                      to clarify that the field is not used   *
  *                      for zEDC.                               *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  Title: z/OS DFSMS Access Method Services Commands
  Appendix F. Interpreting DCOLLECT Output
  table 15 and at 'Active Dataset Record Field', add description
  for DCDEXFLG that is not used for zEDC as follows,
  
  Table 15. DCOLLECT Output Record Structure
  (change is marked with !)
  280(X'118')  2
               BITSTRING   DCDEXFLG  COMPRESSION FLAGS
  !                                  (Not used for zEDC)
               1... ....   DCDBDSZ   DATA SIZES THAT ARE NOT VALID
  
  At 'Active Data Set Record Field' section
  (change is marked with !)
  
   DCDCUDSZ are both zero, it is an indication that the data set
            is not compressed.
  !DCDEXFLG
  !     This is a Compression flag; used for non-VSAM Extended
  !     format. It is not used for zEDC.
        DCDBDSZ
            Data set sizes that are not valid in either or both of
            DCDUDSIZ or DCDCUDSZ.  These fields might contain
            non-zero values, but should not be used.  This field
            is applicable to non-VSAM extended format data sets
            only.
  

Problem conclusion

• DCDEXFLG field is documented in 'Access Method Services
  Commands' manual.
  

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