PM45137: PROVIDE NEW KEYWORD CIC_KSDS= . REMOVE MISLEADING FABJ0180I MESSAGE.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Provide new keyword CIC_KSDS= for CIC FASTIC=N process that
  forces a concurrent image copy NOT to be created if the database
  is KSDS.
  
  Remove misleading FABJ0180I message in CIC FASTIC=(opt,DUMP)
  for KSDS data set.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IMS High Performance Image Copy for z/OS *
  *                 Version 4 Release 2 users ( FMID=H1J0420 )   *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR fixes following problems of   *
  *                      the Concurrent Image Copy in HP Image   *
  *                      Copy.                                   *
  *                      - A new keyword CIC_KSDS= avoids        *
  *                        creating the image copy data set of   *
  *                        VSAM KSDS DBDS in the Concurrent      *
  *                        Image Copy process without Advanced   *
  *                        Copy services (FASTIC=N).             *
  *                      - The Concurrent Image Copy of          *
  *                        FASTIC=(,DUMP) processing of Advanced *
  *                        Copy Services can create a            *
  *                        recoverable image copy data set of    *
  *                        VSAM KSDS DBDS, but HP Image Copy     *
  *                        issues information message FABJ0180I  *
  *                        ( MSGFABJ0180I ) that says the output *
  *                        image copy data set can not be        *
  *                        recoverable one.                      *
  *                      - If CI/CA split occurs during the      *
  *                        logical copy process of the           *
  *                        Concurrent Image Copy process for     *
  *                        VSAM KSDS DBDS with FASTIC=(,DUMP)    *
  *                        processing of the Advanced Copy       *
  *                        Services, HP Image Copy ends with the *
  *                        return code 08. But it fails to issue *
  *                        an appropriate error message          *
  *                        FABJ4245E ( MSGFABJ4245E ).           *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR fixes following problems of the Concurrent Image Copy
  in HP Image Copy.
  - A new keyword CIC_KSDS= is provided.
    The Concurrent Image Copy process without Advanced Copy
    services (FASTIC=N) creates image copy data sets of VSAM KSDS
    DBDSs with information message FABJ0180I ( MSGFABJ0180I ) as a
    default, but the output image copy data sets can not be used
    for recovery utilities as the input image copy data sets. The
    new keyword avoids creating concurrent image copy data sets
    without Advanced Copy services.
  - The Concurrent Image Copy of FASTIC=(,DUMP) processing of
    Advanced Copy Services can create a recoverable image copy
    data set when the KSDS DBDS is SMS managed and has
    BWO(TYPEIMS) definition on the AMS DEFINE or ALTER statement.
    But HP Image Copy issues information message FABJ0180I
    ( MSGFABJ0180I ) that says image copy data set can not be
    recoverable one.
  - If CI/CA split occurs during the logical copy process of the
    Concurrent Image Copy process for VSAM KSDS DBDS with
    FASTIC=(,DUMP) processing of the Advanced Copy Services, HP
    Image Copy should ends the DBDS process with error message
    FABJ4245E ( MSGFABJ4245E ) and set step return code 08. HP
    Image Copy tries to set the DBDS name with long length then
    the correct error message is not issued even if return code of
    the DBDS process and JOBSTEP is 08.
  

Problem conclusion

• HP Image Copy provides following fixes for prevent the problems:
  - Provides the new keyword CIC_KSDS that the Concurrent Image
    Copy without the Advanced Copy services (FASTIC=N) avoids
    creating the image copy data set of VSAM KSDS.
  - Eliminate FABJ0180I ( MSGFABJ0180I ) when the Concurrent Image
    Copy process for VSAM KSDS DBDS with FASTIC=(,DUMP) processing
    of the Advanced Copy Services and the DBDS is SMS managed and
    has BWO(TYPEIMS) definition.
  - When the Concurrent Image Copy process for VSAM KSDS DBDS with
    FASTIC=(,DUMP) processing of the Advanced Copy Services
    ends with return code 08 due to CI/CA split during the logical
    copy process, HP Image Copy issues the error message FABJ4245E
    ( MSGFABJ4245E ) correctly.
  
  The following modules and macros have been modified for this
  APAR.
    FABJBLKD FABJDFCN FABJDPSN FABJFCDN FABJGLRP FABJMSGC
    FABJPARM FABJSTMD FABJTGEN
  
  The following modules have been reassembled.
    FABJDFCA FABJDFCB FABJDFC2 FABJDFC9
    FABJDPSA FABJDPSB FABJDPS2 FABJDPS9
    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
       IMS HP Image Copy JCL statements
         ICEIN control statement keywords
  |        CIC_KSDS keyword
  |
  | The CIC_KSDS keyword specifies whether the Concurrent Image
  | Copy of Image Copy function is to create an image copy data
  | set for the KSDS. This keyword is ignored the Concurrent Image
  | Copy process of Advanced Copy services.
  |
  | Statements that support this keyword
  |   GLOBAL statement
  |
  | Site default option Supported
  |
  | Related keyword
  |   ACIC Keyword
  |   CIC Keyword
  |   FUNC Keyword
  |   HDPC keyword
  |   VIC Keyword
  |
  | Format
  |   +-----------------------------------+
  |   | CIC_KSDS=Y|N                      |
  |   +-----------------------------------+
  |
  | Y
  |   Specifies that the Concurrent Image Copy process of Image
  |   Copy function creates an image copy data set of KSDS
  |   database data set. These image copies can be used for data
  |   pointer checking or for user-specific purposes. However,
  |   when you use these image copies to recover an index
  |   database, the database can not be recovered.
  |
  | N
  |   Specifies that the Concurrent Image Copy process of Image
  |   Copy function does not create an image copy data set of
  |   KSDS database data set and IMS HP Image Copy job ends with
  |   the return code 08.
  |
  |   When either VIC=Y or HDPC=O is requested, the virtual image
  |   copy process or Hash Pointer checking works for the index
  |   database.
  |
  | Default value
  |   CIC_KSDS=Y
  |
  | Notes: CIC_KSDS keyword has an effect on the Concurrent Image
  | Copy process without Advanced Copy services (FASTIC=N or no
  | FASTIC keyword). If you want to create recoverable image copy
  | data set of KSDS database with Concurrent Image Copy process,
  | you consider using FASTIC=(,DUMP) processing of Advanced Copy
  | services.
  
  6.0 Troubleshooting
      Messages and codes
        Messages
  
  | FABJ0235E VSAM KSDS DOES NOT ALLOW CONCURRENT IMAGE COPY.
  | DBD=dbdname DDN=dbds_ddn
  |
  | Explanation: IMS HP Image Copy concurrent image copy process
  | has not created an output image copy data set for the KSDS
  | database and index, when CIC_KSDS=N is specified with Image
  | Copy function without Advanced Copy services.
  | System Action: Image copy process for KSDS is bypassed and
  | return code of image copy process is 08.
  | User Response: If you need to create recoverable image copy
  | data sets of KSDS database, use FASTIC=(,DUMP) processing of
  | Advanced Copy services. For using Concurrent Image Copy with
  | FASTIC=(,DUMP) processing of Advanced Copy services, the KSDS
  | data set must be SMS-managed and BWO(TYPEIMS) must be
  | specified on the AMS DEFINE or ALTER statement. The data set
  | is not SMS-managed or for which BWO(TYPEIMS) is not specified,
  | Concurrent Image Copy fails.
  

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:

  UK70611

Modules/Macros

• FABJBLKD FABJDFCA FABJDFCB FABJDFCN FABJDFC2
  FABJDFC9 FABJDPSA FABJDPSB FABJDPSN FABJDPS2 FABJDPS9 FABJFCDA
  FABJFCDB FABJFCDN FABJFCD2 FABJFCD9 FABJGLRP FABJMSGC FABJPARM
  FABJSTMD FABJTGEN
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R420 PSY UK70611

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