PH12011: FIX VARIOUS PROBLEMS OF IMSDBREFRESH COMMAND ASSOCIATED WITH ALLOW-PARTIAL(Y), LOG-APPLY(Y) OR RENAME-MASKS KEYWORD

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• This APAR provides a new keyword ALLOW-NONRECOV for
  IMSDBREFRESH command that enables to continue processing even
  if non-recoverable primary databases are found when
  LOG-APPLY(Y) is specified.
  The APAR also fixes the following multiple bugs for
  IMSDBREFRESH command:
  1). IMS CT terminates with RC=8 and message GCL34068E when
  there are some inconsistencies about the source database
  definitions when ALLOW-PARTIAL(Y) is specified.
  2). IMS CT terminates with RC=8 and message GCL34079E.
  3). IMS CT terminates with RC=8 and message GCL34236E,
  GCL34604E and GCLRON05E.
  4). IMS CT terminates with RC=0 even though DFSMSdss gets RC=4
  with any warning message.
    - When message ADR383W is issued for a migrated data set, IMS
       CT will handle this as a RC=8.
    - When message ADR730W is issued, indicating file is open and
       IMS CT is doing a fuzzy copy, IMS CT will handle this as a
       RC=0.
    - When any other RC=4, IMS CT will handle this as a RC=4.
  5). IMS CT terminates with abend B37-04 and message IEC030I for
  SYSIN data set that is dynamically allocated as a temporary
  data set for updating target RECON.
  6). Enable to specify 3,200 database names on DBD keyword in
  GCLIN DD statement.
  7). IMS CT terminates with RC=8 and message ADR952E. IMS CT
  will use data set name defined on MDA prior to RECON for full
  function databases.
  8). Better explanation for 'BAD' as reason as to why a data set
  is not cloned. IMS CT will print 'GCL34179E' for incompatible
  DBD and print 'X-dbdname' for related DBDs.
  9). IMS CT uses unexpected order of RENAME-MASKS keyword. IMS
  CT will use masks in order the RENAME-MASKS keyword is
  specified in GCLIN DD statement.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IBM IMS Cloning Tool for z/OS   *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR provides a new keyword        *
  *                      ALLOW-NONRECOV for the IMSDBREFRESH     *
  *                      command that enables to continue        *
  *                      processing when the IMSDBREFRESH        *
  *                      command terminates with RC=8 and        *
  *                      message GCL34073E.                      *
  *                      The APAR also fixes the multiple        *
  *                      problems for the IMSDBREFRESH command.  *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR provides a new keyword for the IMSDBREFRESH command.
  
    ALLOW-NONRECOV(ABORT|CONTINUE,RC(nn)|SKIP,RC(nn))
  
    When LOG-APPLY(Y) is specified and the IMSDBREFRESH command
    detects non-recoverable primary database, the IMSDBREFRESH
    command terminates with RC=8 and message GCL34073E.
    Specifying the ALLOW-NONRECOV keyword enables to continue
    processing in this case.
  
  The APAR also fixes the following multiple problems for
  the IMSDBREFRESH command:
   1). IMS Cloning Tool terminates with RC=8 and message GCL34068E
       when there are some inconsistencies about the source
       database definitions when ALLOW-PARTIAL(Y) is specified.
       This APAR modifies IMS Cloning Tool to continue processing
       other databases.
  
   2). IMS Cloning Tool terminates with RC=8 and message GCL34079E
       even though both nonrecoverable PSINDEX and associated
       primary database are processed at the same time
       when LOG-APPLY(Y) is specified.
       This APAR modifies IMS Cloning Tool to detect both PSINDEX
       and associated primary database correctly.
  
   3). IMS Cloning Tool terminates with RC=8 and message
       GCL34236E, GCL34604E and GCLRON05E when the amount of
       allocations for target databases is exceeding the TIOT
       space.
       This APAR modifies IMS Cloning Tool to reduce the number
       of database data sets dynamically allocated at one time
       when IMS Cloning Tool tries to verify that target databases
       are stopped.
  
   4). IMS Cloning Tool terminates with RC=0 even though DFSMSdss
       gets RC=4 with any warning message.
     - When message ADR383W is issued for a migrated data set, IMS
       Cloning Tool will handle this as a RC=8.
     - When message ADR730W is issued, indicating file is open and
       IMS Cloning Tool is doing a fuzzy copy, IMS Cloning Tool
       will handle this as a RC=0.
     - When any other RC=4, IMS Cloning Tool will handle this
       as a RC=4.
  
   5). IMS Cloning Tool terminates with abend B37-04 and message
       IEC030I for SYSIN data set that is dynamically allocated as
       a temporary data set for updating target RECON.
  
   6). This APAR modifies IMS Cloning Tool so that up to 3,200
       database names can be specified in the DBD keyword of GCLIN
       DD statement.
  
   7). IMS Cloning Tool terminates with RC=8 and message ADR952E.
       This APAR modifies IMS Cloning Tool to use data set name
       defined on MDA prior to RECON for full function databases.
  
   8). Better explanation for 'BAD' as reason as to why a data set
       is not cloned. This APAR modifies IMS Cloning Tool to print
       'GCL34179E' for incompatible DBD and print 'X-dbdname' for
       related DBDs.
  
   9). IMS Cloning Tool uses unexpected order of the RENAME-MASKS
       keyword in GCLIN DD statement. This APAR modifies IMS
       Cloning Tool to use masks in order the RENAME-MASKS keyword
       is specified in GCLIN DD statement.
  

Problem conclusion

• Install the APAR to use the new keyword ALLOW-NONRECOV and to
  fix the above problems for the IMSDBREFRESH command.
  
    ALLOW-NONRECOV(ABORT|CONTINUE,RC(nn)|SKIP,RC(nn))
  
  The following keywords are also provided for the GCLINI member
  of the SGCLPARM library.
  
    ALLOW_NONRECOV=ABORT|CONTINUE|SKIP
  
    ALLOW_NONRECOV_RC=nnnn
  
  The following messages have been added to the User's Guide.
   GCLACH22E GCL34962W GCL34073E GCL34074W GCL34079E
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  The documentation "IBM IMS Cloning Tool for z/OS V1R2,
  User's Guide (SC19-3757-02)" is changed.
  
  Updated documentation is available on:
  https://www-01.ibm.com/support/docview.wss?uid=ibm10875956
  

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:

  UI63310

Modules/Macros

• GCL#DBUP GCL00330 GCL00335 GCL00340 GCL00341 GCL00342 GCL00343
  GCL00344 GCL00345 GCL00346 GCL00347 GCL00348 GCL00349 GCL00355
  GCL00360 GCL00361 GCL00362 GCLDBINF GCLDBRCU GCLDFDSS GCLINI#
  GCLLITS  GCLMSGS
  

Fix information

• Fixed component name

  IMS CLONING TOO

• Fixed component ID

  5655U9100

Applicable component levels

• R120 PSY UI63310

     UP19/06/01 P F905

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.