Initial runtime environment library members

The CREATE action populates the RTEDEF library with an initial set of configuration profile members for a basic runtime environment.

There are hundreds of OMEGAMON parameters. However, to configure a runtime environment that uses basic functions, you only need to specify the few dozen parameters in these initial members. All other parameters use their default values.

Edit the members to specify appropriate parameters for your runtime environment.

Characteristics of the runtime environment defined by the initial members

The parameters in the initial members define a runtime environment with the following characteristics:

Table 1. Characteristics of the initial runtime environment definition
Characteristic	Defined by these parameters
Static hub monitoring server.	`KDS_TEMS_TYPE HUB` Default parameter value (not specified in the initial set of parameters): `KDS_TEMS_HA_TYPE none`
All installed components configured. The CREATE action detects which component products, such as monitoring agents, are installed and sets the corresponding CONFIGURE_* parameters to `Y`.	`CONFIGURE_* Y`
Runtime members shared with target libraries. Rather than being a full stand-alone set, the runtime members refer to some SMP/E installation target libraries (or, more typically, a copy that you have created of those target libraries).	Default parameter values (not specified in the initial set of parameters): `RTE_TYPE SHARING RTE_SHARE SMP`

The initial members include only a few product-specific members

Only a few component products require you to specify parameter values for their basic functions. Most work out-of-the-box using default parameter values.

The CREATE action creates Kpp$PARM members only for the following components, and only if they are installed:

Monitoring server (KDS$PARM)
CICS® TG monitoring agent (KGW$PARM)

The CREATE action creates these members based only on which components are installed. The CREATE action is not sensitive to CONFIGURE_* parameters in an existing RTEDEF(rte_name) member. The CREATE action neither reads nor overwrites existing RTEDEF members. For example, if the CICS TG monitoring agent is installed in the target libraries, then the CREATE action creates an RTEDEF(KGW$PARM) member, even if an RTEDEF(rte_name) member already exists and specifies CONFIGURE_CICS_TG_KGW N.

To set parameter values for other products, you must create the corresponding product-specific Kpp* members.

Special considerations for SYSPLEX rollout

Specify an additional parameter, KFJ_LOCAL_PLIB_HILEV, in your KCIVARS DD statement when running the CREATE action to have the RTEDEF created using the value in KFJ_LOCAL_PLIB_HILEV.

When this parameter is specified, the generated kfj_local_plib_hilev.RTEDEF data set will contain an additional member called PCK$PARM. This member allows locally generated runtime environment data sets to have a different high-level qualifier than the data sets that will be used on the deployment (target) system.

Just like for other members in the RTEDEF, there is a SYSPLEX-wide member called RTEDEF(PCK$PARM) and an LPAR-specific member, RTEDEF(PCK$lpar), supported. The CREATE action will generate the RTEDEF(PCK$PARM) member.

If any of the parameters in PCK$PARM are not defined, Configuration Manager will use the KFJ_LOCAL_PLIB_HILEV parameter to generate default values for all of the high-level qualifier parameters. For the remaining parameters, the target runtime environment parameter will be used as the default.

The target runtime environment parameter will be used to allocate the respective data sets.

For more information about the PCK$PARM member, see RTEDEF(PCK$PARM).

Using an SMP/E target copy

Specifying the CREATE action with option TRGCOPY creates member RTEDEF(trg_copy_name). This member contains source and destination information used to create and maintain a copy of your SMP/E target libraries. This member is used only when the CREATE or GENERATE action is run using option TRGCOPY. For more information, see RTEDEF(trg_copy_name) and Using SMP/E target library copies.