OA60586: SUPPORT UNIX FILE BACKUP AND RECOVER EXCLUDE CRITERIA IN A FILE

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• NEW FUNCTION - DFSMShsm has been enhanced to support a new
  EXCLUDEF keyword on the BACKDS/HBACKDS and RECOVER/HRECOVER
  commands and a new -E option on the hbackup and hrecover UNIX
  commands. The new keyword EXCLUDEF and new option -E allow UNIX
  files to be excluded from processing based on the exclude
  criteria contained in a file specified by the new EXCLUDEF
  keyword or new -E option.  Additionally a new patch bit is added
  to enable PDA tracing of the exclude criteria contained in the
  UNIX file specified by the EXCLUDEF keyword or -E option. When
  the patch bit is enabled, all exclude criteria contained in the
  EXCLUDEF file will be captured and recorded in the PDA datasets
  prior to any validation of the criteria.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * NEW FUNCTION - Users of DFSMShsm V2R3 and higher for file    *
  * backup and recovery. DFSMShsm is enhanced to allow exclude   *
  * criteria to be specified in a UNIX file using a new EXCLUDEF *
  * keyword on the BACKDS/HBACKDS or RECOVER/HRECOVER commands   *
  * (-E option on hbackup/hrecover UNIX commands).               *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * NEW FUNCTION - DFSMShsm backup and recovery processing is    *
  * enhanced to support exclude processing of UNIX files where   *
  * exclude criteria is contained in a regular UNIX file.        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  

Problem conclusion

• NEW FUNCTION - DFSMShsm has been enhanced to support a new
  EXCLUDEF keyword on the BACKDS/HBACKDS and RECOVER/HRECOVER
  commands and a new -E option on the hbackup and hrecover UNIX
  commands. The new keyword EXCLUDEF and new option -E allow UNIX
  files to be excluded from processing based on the exclude
  criteria contained in a file specified by the new EXCLUDEF
  keyword or new -E option.  Additionally a new patch bit is added
  to enable PDA tracing of the exclude criteria contained in the
  UNIX file specified by the EXCLUDEF keyword or -E option. When
  the patch bit is enabled, all exclude criteria contained in the
  EXCLUDEF file will be captured and recorded in the PDA datasets
  prior to any validation of the criteria.
  
  To use the new function, create a UNIX file with the exclude
  criteria you wish to use, and specify that filename on the
  DFSMShsm backup or recover commands.
  
  To enable the exclude criteria tracing, issue the following
  command:
  PATCH .ARCCVT.+02E BITS(....1...)
  To disable the exclude criteria tracing, issue the following
  command:
  PATCH .ARCCVT.+02E BITS(....0...)
  By default, the tracing is disabled.
  
  
  Documentation updates are made to the following publications:
  z/OS DFSMShsm Managing Your Own Data
  SC23-6870
  New keyword EXCLUDEF is added to the HBACKDS and HRECOVER TSO
  commands to allow specification of the UNIX file that has the
  exclude criteria. New -E option is added for the UNIX hbackup
  and hrecover commands to specify the UNIX file with exclude
  criteria.
  
  z/OS DFSMShsm Storage Administration
  SC23-6871
  New keyword EXCLUDEF is added to the BACKDS and RECOVER commands
  to specify the UNIX file containing exclude criteria.
  
  z/OS MVS System Messages Vol 2
  SA38-0669
  Updated and new messages for this support.
  
  z/OS DFSMShsm Diagnosis
  GC52-1387
  Problem determination patches described.
  
  z/OS DFSMShsm Data Areas
  GC14-7504
  
  Details may be found at:
  https://public.dhe.ibm.com/eserver/zseries/zos/DFSMS/HSM/OA60586
  /OA60586_DOC.pdf
  

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:

  UJ08364 UJ08365 UJ08366 OA63291

Modules/Macros

• ARCBDSAM ARCBDSMP ARCBDSN  ARCCPDUP ARCCPRBC ARCCVT   ARCD000
  ARCESD   ARCFAIL  ARCGDSN  ARCMSG   ARCMWE   ARCPCDUP ARCPMWE
  ARCRMDS  ARCRPDCL ARCUBACK ARCUBKF1 ARCUBPRM ARCURCOV ARCUTOOL
  ARCUXLTP ARCZRACF ARCZUXLT SGIEI605 ARCJCLIN ARCIRCOV ARCIBACK
  

Fix information

• Fixed component name

  DFSMSHSM, ISMF

• Fixed component ID

  5695DF170

Applicable component levels

• R240 PSY UJ08365

     UP22/06/30 P F206

• R250 PSY UJ08366

     UP22/06/30 P F206

• R230 PSY UJ08364

     UP22/06/30 P F206

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.