RTEDEF(PCK$PARM)

The RTEDEF(PCK$PARM) member contains parameters that allow remote deployment of a runtime environment.

This member essentially specifies a mapping. A shadow value is specified that represents the value used to generate the runtime environment data sets on the local system (that is, the configuration LPAR). Note that this is the only place this mapping is done. All other values in the RTEDEF members should be specified using the attributes and high-level qualifiers of the target system (that is, the system that the runtime environment will be deployed to).

The list of *_HILEV parameters, along with RTE_USS_RTEDIR and GBL_USS_TKANJAR_PATH, are the only parameters supported for this mapping.

Note: If the GENERATE action detects that non-supported high-level qualifiers are being used in the RTEDEF, an error message will be displayed in KCIPRINT indicating incompatible parameters, and the GENERATE action workflow stops.

The RTEDEF(PCK$PARM) member contains the values described in the following table:

Parameter in member PCK$PARM or PCK$`lpar`	Target runtime environment parameter mapped in RTEDEF(`rte_name`)	Description
KFJ_LOCAL_PLIB_HILEV	RTE_PLIB_HILEV
KFJ_LOCAL_HILEV	RTE_HILEV
KFJ_LOCAL_VSAM_HILEV	RTE_VSAM_HILEV	Default VSAM high-level qualifier to be used when allocating VSAM data sets
KFJ_LOCAL_PDS_HILEV	RTE_PDS_HILEV	Default PDS high-level qualifier to be used to allocate PDS V1 data sets (if needed)
KFJ_LOCAL_TARGET_HILEV	GBL_TARGET_HILEV	SMP/E target high-level qualifier found in RTEDEF(GBL$PARM/GBL$`lpar`)
KFJ_LOCAL_USS_RTEDIR	RTE_USS_RTEDIR	Runtime environment z/OS® UNIX System Services root path used by Configuration Manager to save all z/OS UNIX-related artifacts
KFJ_LOCAL_USS_TKANJAR_PATH	GBL_USS_TKANJAR_PATH	SMP/E target directory containing TKANJAR files
KFJ_LOCAL_SMS_VOLUME	RTE_SMS_VOLUME	To support non-SMS environments
KFJ_LOCAL_SMS_VSAM_VOLUME	RTE_SMS_VSAM_STORCLAS	To support non-SMS environments
KFJ_LOCAL_SMS_UNIT	RTE_SMS_UNIT	To support non-SMS environments
KFJ_LOCAL_SMS_STORCLAS	RTE_SMS_STORCLAS
KFJ_LOCAL_SMS_VSAM_STORCLAS	RTE_SMS_VSAM_STORCLAS
KFJ_LOCAL_SMS_MGMTCLAS	RTE_SMS_MGMTCLAS
KFJ_LOCAL_SMS_VSAM_MGMTCLAS	RTE_SMS_VSAM_MGMTCLAS

Sample member RTEDEF(PCK$PARM)

The sample member, RTEDEF(PCK$PARM), is shown below.

Figure 1. Example of PCK$PARM

* Local RTE parameters                                             
                                                                   
KFJ_LOCAL_PLIB_HILEV          TSOUID.LOCAL                        
KFJ_LOCAL_HILEV                                                    
KFJ_LOCAL_VSAM_HILEV                                               
KFJ_LOCAL_PDS_HILEV                                                
                                                                   
* High-level qualifier of local SMP/E target libraries             
KFJ_LOCAL_TARGET_HILEV        "MONSUITE"                  
                                                                   
* Path to local z/OS UNIX files                                    
KFJ_LOCAL_USS_RTEDIR          "/var/rtehome"                       
                                                                   
* Local SMP/E target directory containing TKANJAR files (KGW, KJJ) 
KFJ_LOCAL_USS_TKANJAR_PATH    "/usr/lpp/kan/bin/IBM"               
                                                                   
* SMS Parameters                                                   
KFJ_LOCAL_SMS_VOLUME                                               
KFJ_LOCAL_SMS_VSAM_VOLUME                                          
KFJ_LOCAL_SMS_UNIT                                                 
KFJ_LOCAL_SMS_STORCLAS                                             
KFJ_LOCAL_SMS_VSAM_STORCLAS                                        
KFJ_LOCAL_SMS_MGMTCLAS                
KFJ_LOCAL_SMS_VSAM_MGMTCLAS

Example

The RTE_PLIB_HILEV value in RTEDEF(MYRTE) is as follows:

RTE_PLIB_HILEV                   TDCIT.REG

Specifying KFJ_LOCAL_PLIB_HILEV with a value of SYS3.PREGEN in RTEDEF(PCK$PARM) will allocate the data sets that will use a value of RTE_PLIB_HILEV using SYS3.PREGEN instead of TDCIT.REG. When using the DEPLOY action after having run the PACKAGE action and transferring the dump data sets to the target system, the original value as specified in RTEDEF(MYRTE), that is TDCIT.REG in this specific example, will be used to restore the data sets.