How to: Upgrade existing runtime environments
bjct 50FV67GPSQ Visits (6151)
After you install new versions into a new set of SMP/E libraries via Serverpac, you might need to upgrade the FMIDs in existing runtime environments(RTE) by pointing the RTEs to the new libraries. For example, if you want to upgrade your environment from pointing to the old OMEGAMON family product V5.3.0 SMP/E library TDIT
1. Specify the RTE that you want to upgrade.
a. Start the installation and configuration tool by running the SMP/E target TKANCUS dataset that has the updated maintenance: EX 'gbl
b. Select option 3 (Configuration Workflow) to enter PARMGEN.
c. On panel KCIP@TLV, specify the new GBL_TARGET_HILEV, and then press Enter.
d. Press Enter to confirm the RTE information.
2. Refresh runtime environment.
a. On the PARMGEN main menu, select option 1(
b. Again, specify the new GBL_TARGET_HILEV, and then press Enter.
c. Specify a backup profile member as prompted.
d. Change Confirm ==> N to Y, and press Enter. The JCL for the KCIJPCFG job is displayed.
e. Review the JCL and resubmit the KCIJPCFG job/KCIJPPRF profile refresh job.
3. Edit profiles and override embeds to customize new features or parameters as required.
a. Select option 2 (Customize PARMGEN configuration profiles). The Customize PARMGEN Configuration Profile Members panel (KCIP@PG6) is displayed.
b. Type DLAJOB in the Command line and press Enter to review the composite KCIJPDLA job that auto-discovers the values to some parameters in the configuration profiles. Submit the job after you review the job settings.
c. Select the RTE, global, and variables profiles in turn as necessary and make the required customizations. If required, edit the appropriate embed members.
4. Re-create the runtime members and jobs.
a. Select option 3 (Create this RTE’s members and jobs). The Create the Members and Jobs panel (KCIP@PR1) is displayed.
b. Select option 1(
c. After the job is successfully finished, press F3 to return to the PARMGEN main menu.
5. Submit the jobs to complete the setup of the RTE.
a. Select option 4 (Submit batch jobs to complete PARMGEN setup). The Submit Batch Jobs To Complete PARMGEN Setup panel (KCIP@SUB) is displayed.
b. Submit the following jobs and any other jobs indicated by a Yes in the REQ column.
This job creates security-related members (load modules, encryption key, and other elements) based on the product security requirements.
If you are upgrading to OMEGAMON for IMS V5.5.0, OMEGAMON for CICS V5.5.0, and OMEGAMON for z/OS V5.5.0, you must rerun the KCIJPSEC job as part of the upgrade. For more information, see Basic upgrade requirements in OMEGAMON XE shared documentation.
This required job copies members of the target libraries that were installed by SMP/E to the read-only RK* libraries.
This job deploys the updated runtime members from the WK* libraries to the RK* production user libraries. If you run KCIJPW2R, run KCIJPCPR to back up the RK* production libraries.
You might need to submit one or more of the following jobs:
Now, the RTE is upgraded successfully. You can repeat the above steps to continue with the upgrade of other RTEs.
For more information, refer to OMEGAMON shared doc in IBM Knowledge Center: http