Scenario RTE05: Deleting a product or component from a runtime environment

Occasionally, you might need to remove a product or component from a particular runtime environment. For example, you might want to remove z/OS Management Console, now that it has been incorporated into OMEGAMON for z/OS.

1. Refresh the PARMGEN work environment.

   This step updates interim libraries and recreates the configuration profiles with any new parameters.

   1. Select the RTE to which you want to add the product by providing the fully-qualified RTE name (RTE_PLIB_HILEV and RTE_NAME).
   2. From the Workflow - Primary Options Menu, select Set up PARMGEN work environment for an RTE.
      The following message is displayed, notifying you that you need to resubmit the modified KCIJPCFG job after you make changes:

      KCIP@MSG ---------------- PARMGEN MESSAGES --------------------------
      Command ===>                                                         
                                                                           
      While configuring an existing RTE profile, you have asked to         
      navigate to the KCIJPCFG option to review or make changes to the     
      KCIJPCFG job, which was run with highest condition code RC= 00000    
      on 2017/07/27. In most cases, if you change any KCIJPCFG             
      parameters, you will have to rerun the KCIJPCFG job and certain      
      subsequent PARMGEN configuration jobs.                               
                                                                           
      Press ENTER to continue with KCIJPCFG changes.                       
                                                                           
      Press F3 to abort.                                                   

   3. Press Enter to continue.
      The first setup panel (KCIP@PG1) is displayed.
   4. Press Enter until the Include Products in this PARMGEN RTE panel (KCIP@PGI) is displayed.

      Any products already configured into the environment are indicated by a slash (/).

   5. Deselect (remove the slash next to) any product that you do not want to include in the runtime environment.
      In the following example, z/OS Management Console is being deleted from the RTE, as it has now been incorporated into OMEGAMON for z/OS.

       --------------------- INCLUDE PRODUCTS IN THIS PARMGEN RTE - Row 1 to 19 of 26 
       Command ===>                                                  Scroll ===> PAGE 
                                                                                      
       Select (/) product(s) to CONFIGURE those product(s) in RTE=PLB1SP13            
       Products configured in the model RTE have been preselected (/).                
       Select or deselect products to include or exclude from configuration.          
                                                                                      
       When finished, change "N" to "Y" to confirm selections.  Confirm ==> N (Y, N)  
                                                                                      
         Kpp  Product Name/Version                                                    
         ---- ----------------------------------------------------------------------  
       _ KAH  System Automation Monitoring Agent V350                    
       _ KC5  OMEGAMON for CICS V550                             
       _ KHL  OMEGAMON z/OS Management Console V410                               
       _ KDO  Tivoli Decision Support for z/OS Agent V181                                
       / KDS  Tivoli Enterprise Monitoring Server V630                                
       _ KD4  ITCAM for SOA Agent V711                    
       / KD5  OMEGAMON for DB2 PE/PM V540                               
       _ KGW  OMEGAMON for CICS TG V550                       
       _ KI5  OMEGAMON for IMS V550        
       / KJJ  OMEGAMON for JVM V540 
       _ KMC  OMEGAMON for Messaging - WebSphere MQ Configuration V730 
       _ KMQ  OMEGAMON for Messaging - MQ V750     
       / KM5  OMEGAMON for z/OS V550                                     
       _ KNA  NetView for z/OS Agent V621                                     
       / KN3  OMEGAMON for Networks V550                       
       / KOB  OMEGAMON Enhanced 3270 User Interface V750                        
       _ KQI  OMEGAMON for Messaging - Integration Bus V750     
       _ KRG  Advanced Audit for DFSMShsm Agent V260                              
       _ KRH  Advanced Reporting and Management for DFSMShsm Agent V260           
       _ KRJ  Advanced Allocation Management Agent V330                        
       _ KRK  Automated Tape Allocation Manager for z/OS Agent V330             
       _ KRN  Advanced Catalog Management Agent V260                           
       _ KRV  Advanced Backup and Recovery for z/OS Agent V240                 
       _ KRW  Tape Optimizer for z/OS Agent V220              
       / KS3  OMEGAMON for Storage V540                       
       _ KYN  ITCAM for Application Diagnostics, TEMA V710.03                   
       End of data                                                                    

   6. Specify Y in the Confirm ==> field then press Enter to continue.
      The following panel is displayed:

      
      KCIP@BAK IMPORTANT - REFRESH THE LPAR RTE USER AND IBM PROFILES -------- 
       Command ===>                                                             
                                                                                
       If you changed any JVM RTE configuration values on the                 
       "SET UP/REFRESH PARMGEN WORK ENVIRONMENT" KCIJPCFG navigation          
       panels, or changed the configured product mix or upgraded product      
       versions, then you must regenerate/resubmit the KCIJPCFG/KCIJPPRF jobs.
       You must also refresh the PARMGEN profiles.                                   
                                                                                
       Specify a backup member name for the LPAR RTE to automate the          
       resubmission and refresh process.  A default backup member is provided.
       Blank-out the field if you do not want to refresh the profiles.        
                                                                                
         DEMO Backup member name   ===>  ________   (Required for KCIJPPRF)  
                                                                                
       PARMGEN automatically backs up the RTE profile in                        
       TDITN.IDTST.PARMGEN.WCONBACK, refreshes templates in IK* datasets, 
       rebuilds the profiles with the new values, merges in the profiles values
       from the backed-up LPAR RTE user profile, and generates a delta report.    
                                                                                
       Press F1 for information about the automated process.                    
      

   7. Enter a name for the profile backup member.
      The modified KCIJPCFG job is displayed.
   8. Submit the job.
      The KCIJPCFG job submits the KCIJPPRF job, which updates the libraries and merges the backed up profile with z/OS Management Console deleted.
   9. Return to the Workflow - Primary Options Menu panel. Wait until both jobs have completed before taking the next step. No return code is displayed for this step on the Workflow main panel until both jobs have completed.
2. Recreate the runtime environment members and jobs.
   1. From the Primary Options Menu, select Create the RTE members and jobs.

      The $PARSE/$PARSESV: Create the RTE Members and Jobs panel (KCIP@PRS) is displayed.

      KCIP@PR1 -------------- CREATE THE RTE MEMBERS AND JOBS -----------------------
      Option ===>                                                                    
                                                                                     
      Select option 1 to SUBMIT the full $PARSE job in WCONFIG for   RTE=SYSA.     
      $PARSE composite job creates product runtime members and jobs in    all the    
      PARMGEN WK* work libraries. 
      Tips:                                                   
      o: Press F5 to access the library-specific $PARSE* jobs (ideal in an RTE    
         reconfiguration scenario). First-time RTE deployment must run $PARSE.    
      o: Select R to submit the KCIJPUP1 job to refresh the IK* product and 
         WCONFIG *$IBM profiles before recreating the runtime members.   
                                                                                    
      Enter ns (1s-2s) for detailed job/task status.                                 
                                                                                     
                         Description                    Job Name   Status     Date   
         ---------------------------------------------- -------- --------- ----------
      R  Refresh IK* templates/WCONFIG *$IBM profiles.  KCIJPUP1    
                                                                                
      1. Create runtime members/jobs in all WK* libs.   $PARSE    
                                                                                     
      Press F1=Help for more information.  Type UTIL to access utility menu.

   2. Select option 1 to submit the generated $PARSE or $PARSESV composite job.
      The $PARSE or $PARSESV member is presented, depending upon whether or not variables are enabled in the RTE.
   3. Review the member for any jobs that need to be submitted manually, then submit the job.
      Return to the main Workflow panel.
3. Submit the batch jobs to complete the PARMGEN setup:
   1. On the Workflow main panel, select Submit batch jobs to complete PARMGEN setup.

      The SUBMIT Submit batch jobs to complete PARMGEN setup panel (KCIP@SUB ) is displayed.

   2. Select option 1 to submit the KCIJPSUB composite submit job, or select the other options to submit each job separately.

      If you select option 1, first review the KCIJPSUB job, and edit the job according to which of the conditional jobs need to be submitted automatically.

   3. Check for good condition codes.
   4. If you do not receive good condition codes, review the resulting output:
      • $IVPRPT report, which is stored in the WCONFIG library
      • WSUPERC SYSTSPRT report, which is stored in the WSUPERC sequential library

      Note: The WSUPERC step will encounter an informational condition code of 4 if OMEGAMON for Db2 on z/OS is not configured in this runtime environment as there are no xKD2* libraries to compare.
   5. Correct any errors, and rerun any jobs that did not complete successfully.