IBM Support

Updates to IMS Cloning Tool User's Guide (SC19-3757-02)

Product Documentation


Abstract

Updates to IMS Cloning Tool User's Guide (SC19-3757-02)

Content

The most recent updates appear at the top of the list.

Update 2

Date of change: June 2019

Change description: Documentation updates for APAR PH12011.

Topics: Changes apply to multiple topics.

============================

Topic: Reference: IMS Cloning Tool Messages

The following messages have been added.

Start of changeGCLACH22E UNABLE TO COMMUNICATE WITH IMS SSID = ssid

Explanation: Connection with target IMS ssid failed when trying to apply updates to the target database.

User response: Make sure that the target IMS has been started correctly, specify an appropriate operand for the IMSPLEX keyword in the GCLIN DD statement, and rerun the job. If you cannot resolve the problem, contact IMS Software Support.

 

GCL34962W TARGET IMSPLEX NOT SPECIFIED, NOT ABLE TO DYNAMICALLY ADD TARGET DB DEFINITIONS

Explanation: You issued an IMSDBREFRESH command with COPY-IF-NO-IMS-TARGET-DB(Y) specified, and an attempt was made to add a database definition to the target IMS, but the IMSPLEX keyword was missing from the GCLIN DD statement.

User response: If the database needs to be defined to the target IMS, you must run the IMSDBREFRESH command with the IMSPLEX keyword defined in the GCLIN DD statement.

 

GCL34073E NON-RECOVERABLE DATABASE dbname CANNOT BE REFRESHED WITH LOG-APPLY(Y)

Explanation: An IMSDBREFRESH job with FUZZY-COPY(Y) and LOG-APPLY(Y) detected a nonrecoverable database. The job cannot process nonrecoverable databases unless the ALLOW-NONRECOV keyword is specified for the IMSDBREFRESH command.  

User response: If the nonrecoverable database needs to be refreshed, specify the ALLOW-NONRECOV(CONTINUE) keyword for the IMSDBREFRESH command; otherwise, specify ALLOW-NONRECOV(SKIP). Then, rerun the job.

 

GCL34074W NON-RECOVERABLE DATABASE dbname CANNOT BE REFRESHED WITH LOG-APPLY(Y)

Explanation: An IMSDBREFRESH job with FUZZY-COPY(Y) and LOG-APPLY(Y) detected a nonrecoverable database.  If ALLOW-NONRECOV(SKIP) is specified, the nonrecoverable database will be bypassed, and processing continues with other databases. If ALLOW-NONRECOV(CONTINUE) is specified, the nonrecoverable database will be refreshed without any updates applied to it.

User response: None. This message is informational.

 

GCL34079E NON-RECOVERABLE INDEX dbname CANNOT BE REFRESHED WITH LOG-APPLY(Y) WITHOUT PRIMARY DB

Explanation: An IMSDBREFRESH job with FUZZY-COPY(Y) and LOG-APPLY(Y) detected a nonrecoverable index, but the associated primary database was not found.

User response: If the primary database is a recoverable database, add it to the job because it also needs to be refreshed, and rerun the job. If the primary database is a nonrecoverable database, add it to the job, specify the ALLOW-NONRECOV(CONTINUE) keyword, and then rerun the job.

End of change

============================

Topic: Reference: Database refresh commands > IMSDBREFRESH

The following optional keywords have been added or changed.

IMSDBREFRESH command syntax

Optional keywords

Start of change

ALLOW-NONRECOV(ABORT | CONTINUE[,RC(nn)] | SKIP[,RC(nn)])

End of change

IMSDBREFRESH command & keyword definitions

Start of change

ALLOW-NONRECOV(ABORT | CONTINUE[,RC(nn)] | SKIP[,RC(nn)])        

Optional keyword that specifies whether the IMSDBREFRESH command should continue processing even if non-recoverable primary databases are detected when LOG-APPLY(Y) is specified on the IMSDBREFRESH command.

Valid values are:

  • ABORT - (the default) The IMSDBREFRESH command terminates with RC=8 and message GCL34073E.
  • CONTINUE - The IMSDBREFRESH command refreshes the non-recoverable primary databases and returns message GCL34074W and a return code of nn. Even if LOG-APPLY(Y) is specified, the IMSDBREFRESH command does not apply any logs to the target data sets of the non-recoverable primary databases after the data sets have been copied. The return code nn must be a numeric value 0 - 4095.
  • SKIP - The IMSDBREFRESH command skips refreshing the non-recoverable primary databases and returns message GCL34074W. It then continues to refresh the other databases and ends the job with a return code of nn. The return code nn must be a numeric value 0 - 4095.

  • Default: ABORT. For CONTINUE and SKIP, the default for RC(nn) is RC(4).
  • Required: No
  • Restriction: If ABORT is specified, RC is ignored. 
End of change

DBD(dbdname1 ,dbdname2, dbdname3, ...)  

Start of changeRequired keyword that specifies up to 3,200 database names to be refreshed from the source IMS subsystem to the target IMS subsystem. If the TGT-DBD parameter is omitted, then the target DBD name will be the same as the source DBD name. End of change

  • Default: None
  • Required: Yes
  • Restrictions: None

============================

Topic: Customizing IMS Cloning Tool > GCLINI configuration values > GCLINI keyword syntax and descriptions > :DB_COPY_OPTIONS section

The following keyword parameters have been added:

Start of change

ALLOW_NONRECOV=ABORT | CONTINUE | SKIP
This option specifies how the IMSDBREFRESH command processes a non-recoverable primary database. The value you specify is applicable only if the corresponding ALLOC-NONRECOV keyword is not specified on the IMSDBREFRESH command.

Valid values are:

  • ABORT - (the default) Terminates processing with a return code of 8 after the first non-recoverable primary database is detected.
  • CONTINUE - Continues processing the non-recoverable primary databases without applying logs to them, and ends the job with return code nnnn, which is specified in the ALLOW_NONRECOV_RC option.
  • SKIP - Skips processing the non-recoverable primary databases and continues processing other databases, and ends the job with return code nnnn, which is specified in the ALLOW_NONRECOV_RC option.

ALLOW_NONRECOV_RC=nnnn

Specifies the return code to be used if ALLOW_NONRECOV=CONTINUE or SKIP is specified. This value is applicable only if the corresponding ALLOW-NONRECOV keyword is not specified on the IMSDBREFRESH command. The return code nnnn must be a numeric value 0 - 4095. The default value is 4.

End of change



Update 1

Date of change: March 2019

Change description: Correction of documentation for the RENAME command syntax. This techdoc fixes some of the incorrect documentation changes that were made to this topic in SC19-3757-02.

============================

Topic: Reference: IMS Cloning Tool Commands > RENAME

 

This topic has been updated as follows:

RENAME command syntax

RENAME

Required keywords:

Required keywords

Optional Keywords:

Optional keywords


RENAME command & keyword definitions

.....

Start of changeMGMTCLAS( mgmt_class | SOURCE )

or MGMTCLAS-PAIRS ( Sourcemgmtclas1, Targetmgmtclas1, Sourcemgmtclas2,

Targetmgmtclas2, ... DEFAULT_IF_NO_MATCH, Targetmgmtclasd | SOURCE )  

MGMTCLAS

Specifies the SMS management class to be assigned to the renamed data sets.

mgmt_class

Indicates that the the specified SMS management class is to be used for all renamed data sets on SMS managed volumes. 

SOURCE

Indicates that the SMS management class will be copied from the corresponding source volume data set. SOURCE is the default. This is the default.  
 

MGMTCLAS-PAIRS

Specifies source and target pairs for the SMS management class.

Sourcemgmtclas1, Targetmgmtclas1, ...

If a data set has the specified source management class (Sourcemgmtclasn), the target data set uses the paired target management class (Targetmgmtclasn).

DEFAULT_IF_NO_MATCH

Indicates, in the subsequent parameter, which management class is to be assigned to a target data set whose source management class does not match any MGMTCLAS-PAIRS entries.

Targetmgmtclasd

Indicates that such data sets should be assigned the specified target management class.

SOURCE

Indicates such data sets should be assigned the management class that is used by the source data set. This is the default.  

    • Default: The default for MGMTCLAS is SOURCE. The default for DEFAULT_IF_NO_MATCH is SOURCE.
    • Required: No
    • Restrictions: MGMTCLAS, MGMTCLAS-PAIRS, and DRIVEACS are mutually exclusive. 
    • Short forms: MC (for MGMTCLAS) or MCP (for MGMTCLAS-PAIRS).
  • End of change

    .....

    Start of changeSTORCLAS( stor_class | SOURCE )

    or STORCLAS-PAIRS (Sourcestorclas1, Targetstorclas1, Sourcestorclas2, Targetstorclas2, … DEFAULT_IF_NO_MATCH, Targetstorclasd | SOURCE)

    STORCLAS

    Specifies the SMS storage class to be assigned to the renamed data sets.

    stor_class

    Indicates that the specified SMS storage class is to be used for all renamed data sets on SMS managed volumes.

    SOURCE

    Indicates that the SMS storage class will be copied from the corresponding source volume data set. This is the default. 

    STORCLAS-PAIRS

    Specifies source and target pairs for the storage class.

    Sourcestorclas1, Targetstorclas1, ...

    If a data set has the specified source storage class (Sourcestorclasn), the target data set uses the paired target storage class (Targetstorclasn).

    DEFAULT_IF_NO_MATCH

    Indicates, in the subsequent parameter, which storage class is to be assigned to a target data set whose source storage class does not match any STORCLAS-PAIRS entries. 

    Targetstorclasd

    Indicates that such data sets should be assigned the specified target storage class.

    SOURCE   

    Indicates such data sets should be assigned the storage class that is used by the source data set. This is the default.

     
    • Default: The default for STORCLAS is SOURCE. The default for DEFAULT_IF_NO_MATCH is SOURCE.
    • Required: No.
    • Restrictions: STORCLAS, STORCLAS-PAIRS, and DRIVEACS are mutually exclusive.
    • Short forms: SC (for STORCLAS) or SCP (for STORCLAS-PAIRS)
  • End of change

    Publication Number

    SC19-3757-02

    Copyright Date

    2009, 2018

    Original Publication Date

    2013-02-20

    Document information

    More support for: IMS Tools

    Component: IMS Cloning Tool

    Software version: 1.2.0

    Operating system(s): z/OS

    Software edition: SC19-3757-02

    Reference #: 0875956

    Modified date: 28 May 2019