IMS Cloning Tool for z/OS User’s Guide Documentation Update

Product documentation


Abstract

Updates that apply to IMS™ Cloning Tool for z/OS V1.1 User's Guide (SC19-2475-02)

Content

The most recent update is listed first.



Update 1

Date of change: December, 2012

The following changes are additions to the IBM IMS Cloning Tool User’s Guide (SC19-2475-02) in support of APAR PM61866, which adds support for using data set level copies to perform subsystem cloning.

Topic: Ch. 6 IMS Cloning Tool Commands

Change Description: Two additional parameters, ALLOW-RENAME-SIM, and NOT-RENAMED-JCLPDS-LIST, have been added to the IMSUPDATE command.

The following optional keywords are an addition to the “IMSUPDATE Command Syntax” section on page 146 of Chapter 6, “Reference: IMS Cloning Tool Commands” of the IBM IMS Cloning Tool User’s Guide (SC19-2475-02).


    ALLOW-RENAME-SIM

    NOT-RENAMED-JCLPDS-LIST(N|Y)


The following parameter descriptions are an addition to the “IMSUPDATE Command & Keyword Definitions” section starting on page 146 of Chapter 6, “Reference: IMS Cloning Tool Commands” of the IBM IMS Cloning Tool User’s Guide (SC19-2475-02).

    ALLOW-RENAME-SIM
    Optional keyword used to indicate that the IMSUPDATE command can update IMS data sets even though the previous RENAME command was run with SIMULATE. This keyword can be used in cases where IMS Cloning Tool did not perform the copy and rename of the target data sets but the target data sets still need to be updated with the information for the target IMS.
    - Default: Do not allow IMSUPDATE to run if RENAME was run with SIM.
    - Required: No
    - Restrictions: None.

    NOT-RENAMED-JCLPDS-LIST(Y | N )
    Specifies whether IMSUPDATE JCLPDS produces a list of data sets that were not renamed by the IMSUPDATE command.
    - Default: N if SIMULATE is not specified. Y if SIMULATE is specified.
    - Required: No
    - Restrictions: None.

Topic: Ch. 7 Database Refresh Commands

Change Description: Two additional parameters, DBRC-ACTION and LOGICALLY-RELATED, have been added to the IMSDBREFRESH command.

The following optional keywords are an addition to the “IMSDBREFRESH Command Syntax” section on page 200 of Chapter 7, “Reference: IMS Cloning Tool Commands” of the IBM IMS Cloning Tool User’s Guide (SC19-2475-02).


    DBRC-ACTION(REDEFINE|REORG,ICOFF|NOICOFF)

    LOGICALLY-RELATED(Y|N)


The following parameter descriptions are an addition to the “IMSDBREFRESH Command & Keyword Definitions” section starting on page 200 of Chapter 7, “Reference: Database Refresh Commands” of the IBM IMS Cloning Tool User’s Guide (SC19-2475-02).

    DBRC-ACTION
    Optional keyword that indicates the DBRC action to perform for the target databases after refreshing them. If DBRC-ACTION(REORG) is specified then IMS Cloning Tool will do a NOTIFY.REORG for all database data sets that were refreshed. If DBRC-ACTION(REDEFINE) is specified then IMS Cloning Tool will do a LIST.DB to provide a reference for current DBRC definitions, then do a DELETE.DB, INIT.DB, and any INIT.DBDS, INIT.PART, and INIT.AREA commands to redefine the target database.

    ICOFF or NOICOFF is an optional parameter if REORG is the value for the first operand. ICOFF indicates that after doing the NOTIFY.REORG IMS Cloning Tool will turn off the image copy needed setting in DBRC so that the database can be accessed without taking an image copy first. NOICOFF indicates that IMS Cloning Tool will not reset the image copy needed flag in DBRC and an image copy of the database data set will need to be done. ICOFF is the default value if DBRC-ACTION(REORG) is specified.

    - Default: REDEFINE
    - Required: No
    - Restrictions: If the database being refreshed is a HALDB, and the partition numbers are different between the source and the target databases, then REDEFINE will always be done for those databases.

    LOGICALLY-RELATED
    Optional keyword that indicates whether or not a database should be copied if not all logically related databases are copied in the same command. If LOGICALLY-RELATED(Y) is specified, then IMS Cloning
    Tool will only copy a database if all logically related databases are also being copied in the same IMS Cloning Tool command. If LOGICALLY-RELATED(N) is specified, then IMS Cloning Tool will copy the databases specified even though not all logically related databases may be copied. The default value is Y.

    - Default: Y
    - Required: No
    - Restrictions: None

Topic: Ch. 7 Database refresh commands

Change Description: Remove LOGICALLY-RELATED parameter from IMSDBSTOP command.

The following optional keywords should be removed from the “IMSDBSTOP Command Syntax” section on page 193 of Chapter7, “Reference: Database refresh Commands” of the IBM IMS Cloning Tool User’s Guide (SC19-2475-02).


    LOGICALLY-RELATED(N|Y)

The following optional keywords should be removed from the “IMSDBSTOP Command and Keyword Definitions” section on page 194 of Chapter 7, “Reference: Database refresh Commands” of the IBM IMS Cloning Tool User’s Guide (SC19-2475-02).

    LOGICALLY-RELATED(N|Y)

Topic: Ch. 2 GCLINI Configuration Values

Change Description: An additional parameter, DBRC_ACTION, has been added to the DB_COPY_OPTIONS section of GCLINI. The following parameter description is an addition to, “DB_COPY_OPTIONS” on page 28 of “GCLINI keyword syntax and descriptions” in Chapter 2, “Customizing IMS Cloning Tool.”


    DBRC_ACTION = REDEFINE | REORG
    Optional keyword that indicates the DBRC action to perform for the target databases after refreshing them. If DBRC-ACTION(REORG) is specified then IMS Cloning Tool will do a NOTIFY.REORG for all database data sets that were refreshed. If DBRC-ACTION(REDEFINE) is specified then IMS Cloning Tool will do a LIST.DB to provide a reference for current DBRC definitions, then do a DELETE.DB, INIT.DB, and any INIT.DBDS, INIT.PART, and INIT.AREA commands to redefine the target database. This value is only used if the DBRC-ACTION keyword is not specified on an IMSDBREFRESH command.

    The default value is REDEFINE.

    SET_IC_NEEDED_OFF = Y/N
    Optional keyword that indicates whether IMS Cloning Tool should reset the image copy needed flag for a target database after it has been refreshed and a NOTIFY.REORG was issued. A value of ‘Y’ indicates that IMS Cloning Tool should reset the image copy needed flag. A value of ‘N’ indicates that IMS Cloning Toll will not reset the image copy needed flag after doing the NOTIFY.REORG. This value is only used if the DBRC-ACTION keyword is not specified on an IMSDBREFRESH command and REORG is specified for the DBRC_ACTION keyword in GCLINI.

    The default value is Y.


Topic: Messages
Change Description: The following message is an addition to Chapter 7. Reference: Messages.

    GCL32314I JCLPDS record DSN: data set name does not match rename masks

    Explanation: The data set name found in a JCLPDS member did not match a RENAME-MASK specified on the RENAME command. The data set name will not be changed in the target JCLPDS member.

    User response: Verify that the source data set name is valid for the target IMS.

Publication number

SC19-2475-02

Original publication date

2012/12/19

Rate this page:

(0 users)Average rating

Document information


More support for:

IMS Tools
IMS Cloning Tool

Software version:

1.1.0

Operating system(s):

z/OS

Reference #:

7017830

Modified date:

2012-12-19

Translate my page

Machine Translation

Content navigation