OA65567: DFSMSHSM PSM STOPPED DELETING NON-VSAM TEMPORARY DATASETS.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• HSM stopped deleting non-vsam temporary data sets on SMS-managed
  
  
  volumes during primary space management.
  

Local fix

• If HSM Fast VTOC/VVDS subset processing was enabled via PATCH
  .MGCB.+EE BITS(..1.....) or by applying OA64308 as recommended
  by HSM Support to prevent ABEND878s from being encountered
  during Primary Space Management (PSM) or because the environment
  
  
  has many EAV volumes, take the following actions:
  
  1) Keep the above PATCH (or OA64308) applied to prevent
  ABEND878s during PSM
  
  2) Identify the temporary data sets that should have been
  deleted by PSM and manually delete them using the following
  steps:
  
  a) Run the following job to identify temporary data sets on
  volume volser (replace volser with the volume serial number):
  
  //        EXEC PGM=ADRDSSU,PARM='TYPRUN=NORUN'
  //SYSPRINT DD SYSOUT=*
  //DDDUMMY DD DUMMY
  //SYSIN DD *
    DUMP DS(INCL(SYS%%%%%.T%%%%%%.RA000.**) -
    BY((CATLG EQ NO))) -
    LOGINDY(volser) -
    OUTDDNAME(DDDUMMY) -
    DELETE
  /*
  
  b) Review the job output to verify the correct data sets are
  being selected. Once verified, remove the PARM='TYPRUN=NORUN'
  parameter and re-run the job to delete temporary data sets from
  volser.
  
  As an alternative to the above steps, as temporary data sets are
  
  deleted during automatic backup processing, ensure that the
  storage group the temporary data sets reside in is enabled for
  automatic backup processing (AUTO BACKUP = Y) and that automatic
  
  backup is executed in the HSMplex via including SETSYS
  AUTOBACKUPSTART(xxxx yyyy) in the ARCCMDxx parmlib member.
  
  ***************************************************************
  *********
  
  If the HSM environment has no history of ABEND878s during PSM or
  
  
  the environment does not have many EAV volumes, take the
  following action:
  
  Disable HSM Fast VTOC/VVDS subset processing via the following
  PATCH by adding it to the ARCCMDxx parmlib member and stopping
  and starting the HSM address space:
  
  PATCH .MGCB.+EE BITS(..0.....)
  
  When HSM Fast VTOC/VVDS subset processing is disabled, temporary
  
  
  data sets will be deleted the next time Space Management
  processes.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All DFSMShsm users on z/OS release V2R5      *
  *                 and higher that use DFSMShsm Primary Space   *
  *                 Management and/or issue the command          *
  *                 MIGRATE STORAGEGROUP with Fast VTOC/VVDS     *
  *                 subset processing enabled.                   *
  *                                                              *
  *                 When Fast VTOC/VVDS subset processing is     *
  *                 enabled, the MGCBF_FVV bit in the Migration  *
  *                 Control Block (MGCB) will be set to 1.       *
  *                                                              *
  *                 Fast VTOC/VVDS subset processing can be      *
  *                 enabled by adding the PATCH command to       *
  *                 the ARCCMDxx parmlib member:                 *
  *                                                              *
  *                 PATCH .MGCB.+EE BITS(..1.....)               *
  *                                                              *
  *                 Fast VTOC/VVDS subset processing can be      *
  *                 enabled by default by applying PTFs for      *
  *                 for OA64308.                                 *
  ****************************************************************
  * PROBLEM DESCRIPTION: SMS Temporary Non-VSAM Data Sets are    *
  *                      not deleted when Fast VTOC/VVDS subset  *
  *                      mode is enabled.                        *
  ****************************************************************
  

Problem conclusion

• DFSMShsm has been modified to correct the problem.
  
  Documentation updates are made to the following publications:
  
  z/OS MVS System Messages Vol 2 (ARC-ASA)
  SA38-0669
  
  A new message, ARC0572I, is added:
  
  ARC0572I   THERE WAS AN ERROR PROCESSING TEMPORARY NON-VSAM DATA
             SETS ON SMS VOLUME {volser}
  
  Explanation
  An error was encountered during temporary NON-VSAM data set
  processing. Temporary NON-VSAM data sets may still remain on the
  volume.
  
  System Action
  DFSMShsm will continue processing the volume.
  
  Programmer Response
  Contact IBM Support.
  
  z/OS DFSMShsm Diagnosis
  GC52-1387
  
  Chapter 8. Diagnosing from return codes and reason codes
  Table 3 is updated to include the new ARCERP return codes for
  module ARCMS1EL.
  
  Table 3. Entries that pass error codes to ARCERP (continued)
  ARCMS1EL
  Error   Process     Description of
  Code    Level       Problem
  204     Debug       A CVAFFILT error occurred while temporary
                      data set processing was trying to end.
  205     Debug       An invalid extended area pointer was used
                      while temporary data set processing was
                      trying to end.
  204     Snap        A CVAFFILT error occurred while temporary
                      data set processing was in progress.
  205     Snap        An invalid extended area pointer was used
                      while temporary data set processing was
                      in progress.
  400     Snap        Parameter list is not valid.
  401     Snap        UCB pointer not provided.
  402     Snap        Extract list entry error.
  403     Snap        Format 1 DSCB area error.
  404     Snap        Entry pointer is not valid.
  405     Snap        Buffer pointer is not valid.
  406     Snap        Control block pointer is not valid.
  407     Snap        One or more control block pointer(s) are not
                      valid.
  408     Snap        Incompatible parameter values for temporary
                      data set processing.
  409     Snap        Invalid temporary data set processing
                      status.
  
  z/OS DFSMShsm Implementation and Customization Guide
  SC23-6869
  
  Chapter 17. Tuning DFSMShsm
  Modifying Fast VTOC/VVDS Access Services processing by subsets
  
  The following information is added after the PATCH command:
  
  As of OA65567 this PATCH will also control the number of
  SMS temporary non-VSAM data sets read from a volume at one time.
  For SMS volumes, temporary non-VSAM data sets are processed
  independently of all other data set types. In the case of SMS
  temporary non-VSAM data sets, the maximum value for a subset is
  250. Any value greater than 250 specified on this PATCH will be
  limited to 250. The intent in making this value configurable to
  a certain limit is to provide an option in the event that
  temporary non-VSAM data set processing uses too much storage
  when executed across a high number of migration tasks.
  

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:

  UJ96981 UJ96982

Modules/Macros

• ARCMS1EL ARCMSG
  

Fix information

• Fixed component name

  DFSMSHSM, ISMF

• Fixed component ID

  5695DF170

Applicable component levels

• R250 PSY UJ96982

     UP25/04/23 P F504 ¢

• R310 PSY UJ96981

     UP25/04/23 P F504 ¢

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.