search cancel

RC/Migrator for DB2 for Z/OS : Reuse an existing customized Utility Model in my new Model.

book

Article ID: 134091

calendar_today

Updated On:

Products

RC/Migrator for DB2 for z/OS

Issue/Introduction

The IMPORT command provides the ability to select a model from which to import one or more utility definitions (including symbols and text) into a currently edited model.

Utilities in the current model can also be replaced with the imported utility definition. The IMPORT command provides the ability to propagate utility definition changes across multiple subsystems.

Environment

Release: R20

Component: RCM

Resolution

This can be done using the IMPORT command when editing the Model. An existing customize model that is required can be reused in other models to save reentry or modification work.

From time to time a vanilla provided model utility delivered at a new release may be altered to cope with some change in the environment.

The Import command can be used to update a model that has been used before with the new code provided by the new release. Note that it is a complete replacement not a smart update so any customization in the target utility will be overwritten by the imported Utility.  

The COMMAND entered at the command prompt is : IMPORT

The IMPORT command will provide the ability to select a model to import one or more utility definitions (including symbols and text) into your current model.

It can be abbreviated as : IMP

 

Start by updating your target model using the "U" line command as you normally do when updating it. 

ROPMODS1 ----------- CA General Model Services ----------- yyyy/mm/dd hh:mm:ss
COMMAND ===>                                                  SCROLL ===> CSR

DB2 SSID ===> ssid
MODEL ID ===> IMPORT   CREATOR ===> authid1      Always show @DEFAULT Model IDs
--------------------------------------------------------------------- authid1

                                                S +---- LAST UPDATE ----+
CMD MODEL ID DESCRIPTION               CREATOR  O   USER     DATE   TIME
 U IMPORT   IMPORT NEW UTILITY        authid1  U authid1  yy/mm/dd hh:mm

 

Then enter COMMAND ===> import

ROPMODU1 ----------- CA General Model Utilities ---------- 2021/10/20 20:45:53
COMMAND ===> import                                           SCROLL ===> CSR

MODEL ID ===> IMPORT   DESCRIPTION ===> IMPORT NEW UTILITY
CREATOR  ===> authid1  SHAREOPTION ===> U (U,Y,N) SSID ===> ssid
--------------------------------------------------------------------- authid1

                                                   + ---- LAST UPDATE ---- +
CMD SYM UTILITY  OB DESCRIPTION               SIZE + USER     DATE    TIME +
_   D  BIND     P  BIND (DSN)                      authid1  yy/mm/dd hh:mm
_   Y  CHECK    TS IBM CHECK DATA            RPI   authid1  yy/mm/dd hh:mm

A list of models will be displayed for selection.

From the list of Models displayed 'S' select the one you want to import from.

ROPMODS1 ----------- CA Model Services Import ----------- YYYY/MM/DD HH:MM:SS 

COMMAND ===> SCROLL ===> CSR
DB2 SSID ===> SSID
MODEL ID ===> IBMUNLD CREATOR ===> AUTHID Always show @DEFAULT Model IDs
--------------------------------------------------------------------- AUTHID
                                              S +---- LAST UPDATE ----+
CMD MODEL ID DESCRIPTION CREATOR                       O  USER    DATE     TIME
S IBMUNLD TEMPLATE OF @DEFAULT                AUTHID1 U AUTHID YYYY/MM/DD HH:MM

 

At the CA Model Utilities Import screen line command I=Import/Exclude is available.

Enter "I" next to the Utilities that are required to be imported. More than one can be selected like this.

ROPMODU1 ----------- CA Model Utilities Import  ----------   yyyy/mm/dd hh:mm
COMMAND ===>                                                  SCROLL ===> CSR

MODEL ID ===> IBMUNLD DESCRIPTION ===> TEMPLATE OF @DEFAULT 
CREATOR  ===> authid1  SHAREOPTION ===> U (U,Y,N) SSID ===> ssid
--------------------------------------------------------------------- authid1

                                                   + ---- LAST UPDATE ---- +
CMD IMP UTILITY  OB DESCRIPTION               SIZE + USER     DATE    TIME +
I   _  SEQUENCE SQ GET/PUT MAX ASSIGNED           authid1  yy/mm/dd hh:mm
_   _  UNLOAD   T  BP UNLOAD                 RPI   authid1 yy/mm/dd hh:mm
_   _  UNLOAD_B T  BP UNLOAD - BEFORE        RPI   authid1 yy/mm/dd hh:mm
_   _  UNLOAD_R T  BP UNLOAD - RECOVERY      RPI   authid1 yy/mm/dd hh:mm
_   _  XUNLD    T  BP UNLOAD VB - FUNLD ALT  RPI   authid1 yy/mm/dd hh:mm
_   _  XUNLD_R  T  BP UNLOAD VB - RECOVERY   RPI   authid1 yy/mm/dd hh:mm

The letter "I" will appear in the IMP column next to the Utility after the "I" line command is entered.

ROPMODU1 ----------- CA Model Utilities Import  ---------- yyyy/mm/dd hh:mm
COMMAND ===>                                                  SCROLL ===> CSR

MODEL ID ===> IBMUNLD DESCRIPTION ===> TEMPLATE OF @DEFAULT 
CREATOR  ===> authid1  SHAREOPTION ===> U (U,Y,N) SSID ===> ssid
--------------------------------------------------------------------- authid1

                                                   + ---- LAST UPDATE ---- +
CMD IMP UTILITY  OB DESCRIPTION               SIZE + USER     DATE    TIME +
_   I  SEQUENCE SQ GET/PUT MAX ASSIGNED           authid1 yy/mm/dd hh:mm
_   _  UNLOAD   T  BP UNLOAD                 RPI   authid1 yy/mm/dd hh:mm
_   _  UNLOAD_B T  BP UNLOAD - BEFORE        RPI   authid1 yy/mm/dd hh:mm
_   _  UNLOAD_R T  BP UNLOAD - RECOVERY      RPI   authid1 yy/mm/dd hh:mm
_   _  XUNLD    T  BP UNLOAD VB - FUNLD ALT  RPI   authid1 yy/mm/dd hh:mm
_   _  XUNLD_R  T  BP UNLOAD VB - RECOVERY   RPI   authid1 yy/mm/dd hh:mm

If an already selected utility has been marked for import by mistake the "I" line command can be re-entered in order to undo the import flag. The "I" in the IMP column will then disappear.

The "I" line command can be entered multiple times at the same time and then one enter will process them.

PF3 when all are selected.

If there is a Utility with the same name in your target model the Import will require a decision be made to replace the existing one with the new one. Enter Y or N and continue.

ROPMODU1 ----------- CA Model Utilities Import  ---------- yyyy/mm/dd hh:mm:ss
COMMAND ===>                                                  SCROLL ===> CSR

MODEL ID ===> IBMUNLD DESCRIPTION ===> TEMPLATE OF @DEFAULT 
CREATOR  ===> authid1  SHAREOPTION ===> U (U,Y,N) SSID ===> ssid
-                        Utility Import Confirmation

    The SEQUENCE utility has been selected for import, but it exists
  already in the current Model.

    Do you want to import and replace this utility in the current Model
    definition?  N (Y to replace)

    Enter N to bypass the import of this utility. If more utilities are
    queued for import, they will still be processed.

If the import has been completed without error the message "RO132I Model utility entries successfully imported." will be displayed and the screen will return to the original Utility list that is being worked.

The last update date and time and user will be reflected in the LAST UPDATE columns. It will be the date of the import not the last date it had previously been modified. The Model is then able to be saved when editing has been completed.

 

Additional Information

Import One or More Utilities