OA47178: CREATE FSR DURING PSM FOR FILES FOUND NOT ELIGIBLE (ARC0734I)

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• New Function
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: DFSMShsm V2R1 users and higher that depend   *
  *                 on FSR migration and expiration records for  *
  *                 automation during primary space management   *
  *                 on SMS managed volumes when the              *
  *                 eligibility of the file fails                *
  ****************************************************************
  * PROBLEM DESCRIPTION: FSR records for migration and           *
  *                      expiration are not cut when a           *
  *                      file fails eligibility checks           *
  *                      for primary space management on         *
  *                      SMS managed volumes.  For               *
  *                      example, ARC0734I RC 53, REAS 00        *
  *                      is issued for a a file that is          *
  *                      expiration eligible but no back         *
  *                      up exists, but no corresponding         *
  *                      FSR record is cut.                      *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  FSR records are not created for ARC0734I inidcated errors
  during primary space management of SMS managed volumes
  

Problem conclusion

Temporary fix

Comments

• New function provided.
  Create FSR records for ARC0734I indicated errors during
  primary space management of SMS volumes. FSRs will not be cut
  for data sets that are not processed because the low threshold
  for the volume was reached.
  
  To specify that the
  FSR records are to be recorded use the followign patch:
  PATCH .MGCB.+EF BITS(......1.)
  
  Documentation changes:
  z/OS DFSMShsm Implementation and Customization Guide
  SC23-6869-01
  
  New sub-section of Chapter 16.  Tuning DFSMShsm
  
  Enabling FSR records to be recorded for errors, reported by
  message ARC0734I,  found during SMS data set eligibility
  checking for primary space management.
  
  To specify that FSR records to be recorded for errors,
  reported by message ARC0734I0,  found during SMS data
  set eligibility checking for primary space management, issue
  the following PATCH command:
  PATCH .MGCB.+EF BITS(......1.)
  
  To specify that the FSR records are not to be recorded,
  issue the following PATCH command:
  PATCH .MGCB.+EF BITS(......0.)
  
  By default, the FSR records are not recorded when an
  ARC0734I message is reported during SMS data set
  eligibility checking for primary space management.
  
  z/OS DFSMShsm Data Areas
  GC14-7504-01
  
  MGCB-Migration Global Control Block
  
  Change reserved field and add MGCBF_734FSR flag
  after MGCBF_SUSPEND_MSQ_GDS in the FLAGS2
  migration flags bit string.
  
  239 (EF) BITSTRING 1 FLAGS2 Migration flags.
  
  .... 1... MGCBF_SUSPEND_MSQ_GDS
  .... .x.. Reserved
  .... ..1. MGCBF_734FSR  When set to 1 Cut an FSR for
                          ARC0734I errors in data set
                          eligibility checking during
                          primary space management
                          for a SMS level 0 volume.
  
  
  Add MGCBF_734FSR to the cross reference table
  MGCBF_734FSR  EF  02  5
  

APAR Information

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

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

  UA77318 UA77319

Modules/Macros

• ARCSMBMQ
  

Fix information

• Fixed component name

  DFSMSHSM, ISMF

• Fixed component ID

  5695DF170

Applicable component levels

• R210 PSY UA77318

     UP15/05/20 P F505

• R220 PSY UA77319

     UP15/05/20 P F505

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.