Define SMP/E target copy settings

Create a member in your RTEDEF library to contain your SMP/E target copy settings, and update the settings as needed.

Before you begin

The Configuration Manager target copy feature is used to create and maintain one or more copies of your SMP/E target libraries, from which you can create or update your runtime environments.

The first step in setting up the use of an SMP/E target library copy is to create a dedicated member in your RTEDEF library that will contain the target copy settings. To review the initial content of the SMP/E target copy member that will be created in this task, see RTEDEF(trg_copy_name).

About this task

You use the CREATE action with option TRGCOPY to create and initially populate a member in an RTEDEF library specifically for SMP/E target copy settings.

The CREATE action supports the following settings when creating the SMP/E target copy member:

OPTION TRGCOPY: Creates a target copy member inside the RTEDEF library. The member is named using the TRG_COPY_NAME parameter.
TRG_COPY_NAME: Specifies the name of the member to create in the RTEDEF data set to contain the SMP/E target copy settings. If the specified member already exists, it is not overwritten.
TRG_COPY_HILEV: (Optional) Specifies the high-level qualifier for the target copy data sets. If not specified, the RTE_PLIB_HILEV parameter value is used.
RTE_PLIB_HILEV: Specifies the high-level qualifier of the RTEDEF library; if the RTEDEF data set does not exist, it is created. This parameter value is also used as the default value for the high-level qualifier for the target copy data sets if TRG_COPY_HILEV is not specified.

After the member has been created, you must then review and update the settings, as needed. For more information about the created member, see RTEDEF(trg_copy_name).

Procedure

Modify the KFJJMCM sample job in TKANSAM (see example below) to select a CREATE action.
Specify OPTION TRGCOPY.
Specify a value for required parameter TRG_COPY_NAME to use as the name of the target copy member.
Specify the high-level qualifier of the RTEDEF in parameter RTE_PLIB_HILEV.
(Optional) Specify a value for parameter TRG_COPY_HILEV to use as the high-level qualifier for the target copy data sets.
Run the KFJJMCM job to create the SMP/E target copy member in the RTEDEF data set.
Job messages for the CREATE action are written to the KCIPRINT SYSOUT data set.
Review and update the RTEDEF(trg_copy_name) member, as needed.

Example

The following JCL job creates the SMP/E target copy member MYCOPY in data set TSOUID.PROD.RTEDEF. If the specified RTEDEF data set does not exist, it is created. If the specified member already exists, it is not overwritten.

Figure 1. Example JCL to create the SMP/E target copy member

//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                  CREATE
OPTION                  TRGCOPY
TRG_COPY_NAME           MYCOPY
RTE_PLIB_HILEV          TSOUID.PROD
/*

Figure 2. Example SMP/E target copy member

* High-level qualifier of SMP/E target libraries
GBL_TARGET_HILEV                 MONSUITE

* SMP/E target directory containing TKANJAR files (KGW, KJJ)
GBL_USS_TKANJAR_PATH             "/usr/lpp/kan/bin/IBM"

TRG_COPY_NAME                    MYCOPY
* High-level qualifier of the copy of SMP/E target libraries
TRG_COPY_HILEV                   TSOUID.PROD
* Directory for a copy of SMP/E TKANJAR files (KGW, KJJ)
TRG_COPY_TKANJAR_PATH            "/var/rtehome/MYCOPY/kan/bin/IBM"
* Directory for a copy of SMP/E TKAYHFS files (KAY)
TRG_COPY_TKAYHFS_PATH            "/var/rtehome/MYCOPY/kay"

CONFIGURE_TEMS_KDS               Y  * TEMS
CONFIGURE_E3270UI_KOB            Y  * Enhanced 3270                
CONFIGURE_CICS_KC5               Y  * CICS TS                      
CONFIGURE_CICS_TG_KGW            Y  * CICS TG                      
CONFIGURE_DB2_AGENT_KD5          Y  * Db2                          
CONFIGURE_IMS_KI5                Y  * IMS                          
CONFIGURE_JVM_KJJ                Y  * JVM                          
CONFIGURE_ZOS_KM5                Y  * z/OS                         
CONFIGURE_MESSAGING_KMQ          Y  * MQ                           
CONFIGURE_MESSAGING_KQI          Y  * Integration Bus              
CONFIGURE_NETVIEW_KNA            Y  * Netview                      
CONFIGURE_MFN_KN3                Y  * Network                      
CONFIGURE_STORAGE_KS3            Y  * Storage                      
CONFIGURE_OMEGAVIEW_KWO          Y  * Integration Monitor          
CONFIGURE_ITCAMAD_KYN            Y  * ITCAM for Applications       
CONFIGURE_ACM_KRN                Y  * Advanced Catalog Mgmt        
CONFIGURE_ARD_KRH                Y  * Advanced Rpt and Mgmt        
CONFIGURE_AAD_KRG                Y  * Advanced Audit               
CONFIGURE_AAM_KRJ                Y  * Advanced Alloc Mgmt     
CONFIGURE_ATAM_KRK               Y  * Automated Tape Alloc    
CONFIGURE_ABR_KRV                Y  * Advanced Backup and Rec 
CONFIGURE_ODP_KAY                Y  * Data Provider

What to do next

Use the new target copy member to make a copy of your SMP/E target libraries. See Copy SMP/E target libraries.

Note: Make sure to carefully review your target copy settings before continuing with the next step.