Copy SMP/E target libraries

Make a copy of your SMP/E target libraries using your defined SMP/E target copy settings.

Before you begin

The Configuration Manager target copy feature is used to create and maintain a copy of your SMP/E libraries, from which you can create or update your runtime environments.
Before you can copy the libraries, you must have created and updated your SMP/E target copy settings, as described in Define SMP/E target copy settings. You can then use your defined settings to copy the libraries, as described in this task.
Important: Make sure you have carefully reviewed your target copy settings before continuing with this task.

About this task

You use the GENERATE action with option TRGCOPY to copy your SMP/E target libraries from the original source to a new set of data sets, as defined in your SMP/E target copy settings in member RTEDEF(trg_copy_name).

Data sets for the copy of the SMP/E target libraries are allocated with the name trg_copy_hilev.trg_copy_name. Target copy libraries are always non-VSAM. Only the files for the products installed in your environment, as specified by the CONFIGURE_* flags in the RTEDEF(trg_copy_name) member, are copied.

When used to copy SMP/E target libraries, the GENERATE action supports the following settings
OPTION TRGCOPY
Creates a copy of your SMP/E target libraries from the original source to a new set of data sets, as defined in member RTEDEF(trg_copy_name).
TRG_COPY_NAME
Specifies the name of the member in the RTEDEF data set that contains the SMP/E target copy settings.
RTE_PLIB_HILEV
Specifies the high-level qualifier of the RTEDEF library.

Procedure

  1. Modify the KFJJMCM sample job in TKANSAM (see example below) to select a GENERATE action.
  2. Specify OPTION TRGCOPY.
  3. Specify the name of the target copy member for required parameter TRG_COPY_NAME.
  4. Specify the high-level qualifier of the RTEDEF in parameter RTE_PLIB_HILEV.
  5. Run the KFJJMCM job to copy your SMP/E target libraries from the original source to a new set of data sets.
    Job messages for the GENERATE action are written to the KCIPRINT SYSOUT data set.

Example

The following JCL job copies SMP/E target libraries from the original source to a new set of data sets, as defined in the SMP/E target copy member MYCOPY in data set TSOUID.PROD.RTEDEF. In this example, new data sets are allocated using the high-level qualifier TSOUID.PROD.MYCOPY. The number of data sets copied depends on the products selected for configuration in the target copy member.
Important: The high-level qualifier for the data set name specified in the KCIFLOW DD statement must match the GBL_TARGET_HILEV parameter value that is specified in the RTEDEF(trg_copy_name) member.
Figure 1. Example JCL to copy SMP/E target libraries
//UID#ZMCM JOB ,CLASS=A,MSGCLASS=X,NOTIFY=&SYSUID
/*JOBPARM SYSAFF=ZOS1
//S1       EXEC PGM=KCIOMEGA,REGION=0M,DYNAMNBR=256
//STEPLIB  DD DISP=SHR,DSN=MONSUITE.TKANMOD
//KCIFLOW  DD DISP=SHR,DSN=MONSUITE.TKANCUS(KFJOMEGA) 
//KCIVARS  DD *                                        
ACTION            GENERATE
OPTION            TRGCOPY
TRG_COPY_NAME     MYCOPY
RTE_PLIB_HILEV    TSOUID.PROD
/*

What to do next

You can use the copy of the SMP/E target libraries to create or update your runtime environments.