PM46198: HP IMAGE COPY RETRY DFSMSDSS COMMAND FOR KSDS DATA SET THAT HASCI/CA SPLIT DURING CIC

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• HP Image Copy retry the DFSMSdss DUMP command process under
  following conditions:
  1. Process is Concurrent Image Copy (CIC)
  2. DUMP process of Advanced Image Copy services
  (FASTIC=(opt,DUMP))
  3. Data set organization of the target database is VSAM KSDS
  4. Target VSAM KSDS data set is SMS-Managed and BWO(TYPEIMS) is
  defined
  5. Target VSAM KSDS data set has CI/CA split due to updating DB
  record by the application during image copy process.
  
  HP Image Copy retry the DFSMSdss DUMP command up to 10 times.
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IMS High Performance Image Copy for z/OS *
  *                 Version 4 Release 2 users ( FMID=H1J0420 )   *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR supports the new process.     *
  *                                                              *
  *                      If CI/CA splits in VSAM KSDS DBDS are   *
  *                      detected during the logical copy phase  *
  *                      of the DFSMSdss Concurrent Copy process *
  *                      that is scheduled by the Concurrent     *
  *                      Image Copy(CIC) with FASTIC=(,DUMP)     *
  *                      processing of the Advanced Copy         *
  *                      Services of HP Image Copy, the DFSMSdss *
  *                      DUMP command of the DBDS is rescheduled *
  *                      automatically for creating image copy   *
  *                      data set that does not have CA/CI       *
  *                      splits in the record. The maximum       *
  *                      scheduled number of DFSMSdss DUMP       *
  *                      command is 10.                          *
  *                      This process works under the following  *
  *                      conditions:                             *
  *                      - DBDS is VSAM KSDS                     *
  *                      - VSAM KSDS data set is the SMS managed *
  *                      - VSAM KSDS has BWO(TYPEIMS) definition *
  *                      - FASTIC=(,DUMP) process of Advanced    *
  *                        Copy Services is requested with the   *
  *                        Concurrent Image Copy(CIC)            *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR supports the new process.
  
  If CI/CA splits in VSAM KSDS DBDS are detected during the
  logical copy phase of the DFSMSdss Concurrent Copy process that
  is scheduled by the Concurrent Image Copy(CIC) with
  FASTIC=(,DUMP) processing of the Advanced Copy Services of HP
  Image Copy, the DFSMSdss DUMP command of the DBDS is rescheduled
  automatically for creating image copy data set that does not
  have CA/CI splits in the record. The maximum scheduled number of
  DFSMSdss DUMP command is 10.
  This process works under the following conditions:
  - DBDS is VSAM KSDS
  - VSAM KSDS data set is the SMS managed
  - VSAM KSDS has BWO(TYPEIMS) definition
  - FASTIC=(,DUMP) process of Advanced Copy Services is requested
    with the Concurrent Image Copy(CIC)
  

Problem conclusion

Temporary fix

Comments

• The following modules and macros have been modified for this
  APAR.
    FABJDFCN FABJFCDN FABJFCBK FABJFCCM FABJMSGC
  
  The following modules have been reassembled.
    FABJDFCA FABJDFCB FABJDFC2 FABJDFC9
    FABJFCDA FABJFCDB FABJFCD2 FABJFCD9
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS High Performance Image Copy for z/OS Version 4 Release 2
  User's Guide SC19-2756-00 ( SC19275600 ) should be changed as
  follows:
  
  3.0 Running IMS HP Image Copy
   Using Advanced Copy Services
    Considerations for using Advanced Copy Services
     Concurrent copy
    In using concurrent copy by specifying the FASTIC=(,DUMP)
    keyword, the concurrent image copy processing (CIC or ACIC
    processing) for a VSAM KSDS requires that the data set be
    SMS-managed and BWO(TYPEIMS) be specified on the AMS DEFINE or
    ALTER for the data set. This ensures that IMS HP Image Copy
    can detect CI or CA splits which cause the output image copy
  | to be unusable. IMS HP Image copy tries the DFSMSdss DUMP
  | command up to 10 times to create the correct output image
  | copy. If CI/CA splits are not resolved, the Concurrent Image
  | Copy process fails with FABJ4245E. However, this does
    not apply when VIC=Y is specified and the HASH Check is
    disabled. For details, see "VIC keyword" on page 252
    Chapter 10. Using Advanced Copy Services 295
  
  
  6.0 Troubleshooting
      Messages and codes
        Messages
    FABJ4245E
  
    ATTEMPT TO CREATE CONCURRENT IC FOR DSN=data_set_name FAILED
    DUE TO BWO ERROR
  
    Explanation: During concurrent image copy processing using
  | FASTIC=DUMP processing, CI/CA splits are not resolved.
    System action:Image copy processing fails.
    User response:Retry the job or run the image copy as a batch
    image copy.
  
  | FABJ4255I
  |
  | DFSMSDSS DUMP COMMAND RETRY FOR DB dbdname DDN ddname
  |
  | Explanation: IMS HP Image Copy detected CI or CA splits in the
  | DBDS of VSAM KSDS during the logical copy phase of the
  | Concurrent Copy process of DFSMSdss, when the Concurrent Image
  | Copy process with FASTIC=(,DUMP) process of Advanced Copy
  | Services is requested. IMS HP Image Copy retries DFSMSdss DUMP
  | command.
  | System action: IMS HP Image Copy continues processing.
  | User response: None.
  ×**** PE11/09/22 FIX IN ERROR. SEE APAR PM48342  FOR DESCRIPTION
  

APAR Information

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

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

  UK71329

Modules/Macros

• FABJDFCA FABJDFCB FABJDFCN FABJDFC2 FABJDFC9
  FABJFCBK FABJFCCM FABJFCDA FABJFCDB FABJFCDN FABJFCD2 FABJFCD9
  FABJMSGC
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R420 PSY UK71329

     UP11/08/31 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.