OA61472: NEW FUNCTION: DFSMSHSM UNIX FILE INCREMENTAL BACKUP SUPPORT FOR READ ONLY ZFS

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• New Function: Change DFSMShsm UNIX File Incremental Backup
  processing to correctly recognize when a UNIX file exists in a
  zFS mounted Read Only.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * New Function - z/OS V2R3 and higher users of DFSMShsm UNIX   *
  * file incremental backup support that include UNIX            *
  * directories or files contained in a zFS file system mounted  *
  * Read Only.                                                   *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * New Function - Incremental backup of UNIX files in a Read    *
  * Only file system continues to select these files even though *
  * they have not changed since the last backup.                 *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  

Problem conclusion

• New Function - DFSMShsm has been enhanced to recognize when a
  UNIX file is located in a file system that is mounted Read Only,
  and use the latest backup date from the DFSMShsm inventory to
  decide if a new backup needs to be taken.
  
  Documentation updates are made to z/OS DFSMShsm Storage
  Administration
  SC23-6871
  
  In Chapter 6. "Availability management of SMS-managed storage",
  section, "Command availability management", update the
  sub-section, "Backing up all eligible changed UNIX files in a
  directory" as follows:
  
  Add the following sentence to the second paragraph. (This
  paragraph describes how the file metadata is examined to
  determine if a new backup should be taken.)
  
  If the UNIX file resides in a file system that is mounted in
  Read-Only mode, then the Last Reference date is not examined.
  Instead, the timestamp of the most recent backup in the DFSMShsm
  inventory is used to determine if the file has changed since its
  last backup was taken. DFSMShsm will not attempt to update the
  reftime field for the UNIX file to set the last backup date.
  

Temporary fix

Comments

•  KEYWORDS: UNIXFILEBACKUP/K
  

APAR Information

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

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

  UJ06315 UJ06316 UJ06317

Modules/Macros

• ARCBUDS  ARCZUSRV ARCBDSN
  

Fix information

• Fixed component name

  DFSMSHSM, ISMF

• Fixed component ID

  5695DF170

Applicable component levels

• R230 PSY UJ06315

     UP21/08/24 P F108

• R240 PSY UJ06316

     UP21/08/24 P F108

• R250 PSY UJ06317

     UP21/08/24 P F108

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.