IBM Support

PARMGEN Configuration for OMEGAMON/TMS Products on z/OS

News


Abstract

PARMGEN Configuration for OMEGAMON and other z/OS Tivoli Management Services (TMS) dependent products

Content


Introduction:
This is PARMGEN configuration support for configuring the IBM Tivoli OMEGAMON XE and other Tivoli Management Services (TMS) dependent products on z/OS.

The products listed below, along with their dependent configurable components, are supported to create a brand new runtime environment (RTE) using the new PARMGEN mode in lieu of using the current ICAT z/OS Configuration Tool. The following versions are listed as the minimum* versions that PARMGEN mode supports for these products:


Viewing Tip: To navigate to each section in this technote more easily, do a FIND on "Date Last Updated:" text. (Date Last Updated: yyyymmdd)

Section A. Enablement Support: (Date Last Updated: 20161201)

Hide details for Section A1. Download the latest GA PARMGEN PTFs and let's get started!Section A1. Download the latest GA PARMGEN PTFs and let's get started!
Section A1. Download the latest GA star PARMGEN PTFs and let’s get started! (Date Last Updated: 20161130)

APAR#
FMID / PTF# / RSU yymm or PUT yymm
Interim Feature (IF) Release Date
OA48678 HKCI310 / UA80256 / RSU1603 *GA* February 22, 2016 (1Q16) starstarstarstarstar Note: The PARMGEN PTF must be applied if you plan to exploit product features called out in the "What's New in PARMGEN">"PARMGEN PTF UA80256 for APAR OA48678 (1Q16 Interim Feature)" overview topic in the "OMEGAMON XE shared documentation">"Version 6.3.0 Fix Pack 2 and above" documentation (URL: http://www.ibm.com/support/knowledgecenter/SSAUBV/com.ibm.omegamon_share.doc_6.3.0.2/common/new_parmgen_ptfua80256_aparoa48678.htm). For low-level details, refer to this PARMGEN technote's "Section C. What's New in Cumulative PARMGEN Interim Features (IF)">"Section C3. What's New in 1Q16 PARMGEN IF?".
OA49893 HKCI310 / UA81228 / PUT1607 *GA* July 12, 2016 (2Q16) starstarstarstarstar Note: The PARMGEN PTF must be applied if you plan to exploit product features called out in the "What's New in PARMGEN">"PARMGEN PTF UA81228 for APAR OA49893 (2Q16 Interim Feature)" overview topic in the "OMEGAMON XE shared documentation">"Version 6.3.0 Fix Pack 2 and above" documentation (URL: http://www.ibm.com/support/knowledgecenter/SSAUBV/com.ibm.omegamon_share.doc_6.3.0.2/common/new_parmgen_ptfua81228_aparoa49893.htm). For low-level details, refer to this PARMGEN technote's "Section C. What's New in Cumulative PARMGEN Interim Features (IF)">"Section C2. What's New in 2Q16 PARMGEN IF?".
OA50912 HKCI310 / UA82508 / RSUyymm *GA* November 11, 2016 (4Q16A) starstarstarstarstar Note: The PARMGEN PTF must be applied if you plan to exploit product features called out in the "What's New in PARMGEN">"PARMGEN PTF UA82508 for APAR OA50912 (4Q16A Interim Feature)" overview topic in the "OMEGAMON XE shared documentation">"Version 6.3.0 Fix Pack 2 and above" documentation (URL: http://www.ibm.com/support/knowledgecenter/SSAUBV/com.ibm.omegamon_share.doc_6.3.0.2/common/new_parmgen_ptfua82508_aparoa50912.htm). For low-level details, refer to this PARMGEN technote's "Section C. What's New in Cumulative PARMGEN Interim Features (IF)">"Section C1. What's New in 4Q16 PARMGEN IF?".
OA51503 HKCI310 / UA83283 / RSUyymm *ETA GA* December 09, 2016 (4Q16B)


Hide details for Section A2. Download any cross-product dependency application PTFs relating to product deployment:( Section A2. Download any cross-product dependency application PTFs relating to product deployment:(
Section A2. Download any cross-product dependency application PTFs relating to product deployment: ( Date Last Updated: 20161201)
    Post-SMP/E considerations : At a minimum, the product PTFs listed require that the PARMGEN KCIJPLOD "Copy SMP/E members from TK*->RK* read-only (RO) libraries" maintenance job is rerun to deploy any updated RO elements to the applicable product started task(s) for each monitored LPAR. Also refer to the respective PTFs for additional HOLDDATA information.
    APAR#
    FMID / PTF# / RSU yymm or PUT yymm
    Interim Feature (IF) Release Date
    OA51359 HKJJ540 / UA83018 / RSUyymm *GA* November 2016 Note: This HKJJ540 PTF must be applied if you plan to exploit the new IBM OMEGAMON for JVM V5.4.0 Agent features delivered in a new V5.4.0 version of OMEGAMON for JVM. For more information, refer to the OMEGAMON for JVM V5.4.0 IBM Knowledge Center documentation "What's New in V5.4.0?" topic (URL:http://www.ibm.com/support/knowledgecenter/SSMTJ5_5.4.0/com.ibm.omegamon_jvm.doc/whats_new_v540.htm).
    OA51412 OA51463 HKS3540 / UA83245 / RSUyymm *GA* November 2016 Note: These HKS3540 PTFs must be applied if you plan to exploit the new IBM OMEGAMON for Storage V5.4.0 Agent features delivered in a new V5.4.0 version of OMEGAMON for Storage. For more information, refer to the OMEGAMON for Storage V5.4.0 IBM Knowledge Center documentation "What's New in V5.4.0?" topic (URL:http://www.ibm.com/support/knowledgecenter/SS2JFP_5.4.0/com.ibm.oxes.doc/new.HTML).
    OA51082 HKM5530 / UA82561 / RSUyymm *GA* November 2016 Note: This HKM5530 PTF must be applied if you plan to exploit a number of recent OMEGAMON XE on z/OS V5.3.0 Fix Pack 4 features. Review the PTF HOLDDATA for more information.
    OA51033 HKOB730 / UA82725 / RSUyymm *GA* September 2016 Note: This HKOB730 PTF must be applied if you plan to upgrade to the new IBM OMEGAMON for JVM V5.4.0 and IBM OMEGAMON for Storage V5.4.0.
    Subscribe: http://www.ibm.com/support/electronicsupport/ Sign-up for IBM MyNotifications: http://www.ibm.com/support/mynotifications



Once the recommended PTFs are applied, execute the PARMGEN code from your &gbl_target_hilev. TKANCUS OMEGAMON/ITM SMP/E target library as shown in the example invocation below:
    ============================================
    ISRTSO ISPF Command Shell
    Enter TSO or Workstation commands below:
    ===> EXEC 'IBM.ITM63053.TKANCUS'
    ============================================
    (where &gbl_target_hilev = IBM. ITM63053 in this example)



Section B. Pointers to Shared Publications and Blogs : ( Date Last Updated: 20161130)
    Section B1. OMEGAMON XE shared publications in IBM Knowledge Center: ( Date Last Updated: 20161111)
    Hide details for Deployment considerations: OMEGAMON XE shared publications URL reference Deployment considerations: OMEGAMON XE shared publications URL reference

      Deployment considerations: Helpful reference URL: http://www.ibm.com/support/knowledgecenter/SSAUBV/ then navigate to the " OMEGAMON XE shared publications " link where these common publications may be found:. The OMEGAMON XE shared documentation and the OMEGAMON XE product documentation have moved from the Information Center to the new IBM® Knowledge Center. The most current documentation is found in the IBM® Knowledge Center

      >> Tivoli OMEGAMON XE Family of Products welcome page
      >> OMEGAMON XE shared documentation
      >> Version 6.3.0 Fix Pack 2 (and above)
      (URL: http://www.ibm.com/support/knowledgecenter/SSAUBV/)

      *** IMPORTANT *** IMPORTANT *** IMPORTANT *** IMPORTANT ***
      The PARMGEN configuration infrastructure improvements delivered in each Interim Feature (IF) apply to all the products. Please always refer to the OMEGAMON XE shared documentation at its latest version in the IBM® Knowledge Center, regardless of the product version or product family (OMEGAMON, ITCAM, NetView, System Automation, Tivoli Advanced Storage, Tivoli Decision Support, and other z/OS Tivoli Management Services (TMS)-dependent Agents).

      Please ensure that you are using the latest versions of these key deployment topics:

        o Downloadable PDF files
        o What's New
          - What's New in PARMGEN
          - What's New in the OMEGAMON enhanced 3270 user interface
        o Getting Started o Planning
          - Planning a first deployment
          - Planning an upgrade or installation
            * Version requirements
            * Basic upgrade requirements
        o Installing
        o Configuring
          - Overview of the PARMGEN configuration method
          - Quick configuration mode
          - Replicating configured runtime environments (RTEs)
          - Completing the configuration post-PARMGEN configuration process
        o Runtime Environment (RTE) Scenarios and how-tos
          - RTE Implementation scenarios (ideal for your first-RTE set-up)
          - RTE SMP/E maintenance and upgrade scenarios
          - RTE reconfiguration scenarios
          - RTE deployment scenarios
          - How-to's
        o Upgrading
        o Reference
          - Maintaining the persistent datastore
          - Variables in PARMGEN configuration
          - Common parameters (GBL_*, RTE_*, Common Kpp_AGT_* parameters)
          - OMEGAMON enhanced 3270 user interface user's guide
      These IBM® Knowledge Center OMEGAMON XE shared publications topics follow the PARMGEN infrastructure modifications delivered in each PARMGEN Interim Feature.
Hide details for Section B2. PARMGEN Blogs: Related blogs in  z Systems>>System z Management community Section B2. PARMGEN Blogs: Related blogs in z Systems>>System z Management community


    Section B3. PARMGEN Video Gallery: ( Date Last Updated: 20161130)
Hide details for Section B3. PARMGEN Video Gallery: Section B3. PARMGEN Video Gallery:


Section C. What's New in Cumulative PARMGEN Interim Features (IFs) : ( Date Last Updated: 20161111)









    • Additional references (Presentations):
      • See latest PARMGEN Hands-on Lab Guide attached below (in Section D2. InterConnect 2015 PARMGEN Hands-on Lab Guide (Lab 5644)). Lab Guide is based on the latest PARMGEN 1Q15 IF design.


Section D. OMEGAMON Deployment Customer Open Q&A Sessions/Hands-on Lab Guides : ( Date Last Updated: 20161028)


At the IBM InterConnect 2015 Conference in Las Vegas, Nevada held in February 2015, PARMGEN hosted a hands-on lab training. For your reference, Lab 5644 PARMGEN Hands-on Lab. Guide is also now available for downloading.
Three scenarios are supplied to get you acquainted with the PARMGEN Quick Configuration mode.
  1. QCF10 Scenario: A sharing-with-SMP/E runtime environment (RTE) contains LPAR-specific libraries and references the read-only target libraries managed by SMP/E. Because an RTE that shares the SMP/E target libraries is updated when the SMP/E maintenance is applied, a sharing-with-SMP/E configuration is good for testing maintenance before other RTEs are updated. Because the RTE contains a hub monitoring server, it can operate by itself and show data right away. However, you do not want this type of RTE in a production environment, because you do not want maintenance to be applied without testing. You can use the IBM-provided RTE model profile @MDLHSS to configure this RTE or you can configure it from scratch.
  2. How-to#5 Scenario: This second scenario extends exercise #2 and simulates converting an existing RTE that does not currently use variables to an RTE that leverages system and user variables.
  3. QCF11 Scenario: The third scenario simulates a real-world upgrade for an existing customer who has a mix of products. In the real world, perhaps not all of your products would be upgraded, but all in the RTE are converted to use PARMGEN where existing configuration values established in the legacy configuration tool, ICAT, are harvested and re-used in PARMGEN.



    Native Language Translations

    Additional Language
    Technotes:
    This is not a required field. Use these fields to specify the DocNumber of native version translations of this content Doc Link
    Japanese
    Cross reference information
    Segment Product Component Platform Version Edition
    Systems and Asset Management Tivoli OMEGAMON XE for CICS on z/OS z/OS 5.1.0
    Systems and Asset Management Tivoli OMEGAMON XE for DB2 Performance Expert on z/OS z/OS 5.1.0
    Systems and Asset Management Tivoli OMEGAMON XE for DB2 Performance Monitor on z/OS z/OS 5.1.0
    Systems and Asset Management Tivoli OMEGAMON XE for IMS on z/OS z/OS 4.2.0
    Systems and Asset Management Tivoli OMEGAMON XE on z/OS z/OS 5.1.0
    Systems and Asset Management Tivoli Management Server for Distributed Systems on z/OS z/OS 6.2.2
    Systems and Asset Management IBM Tivoli Monitoring V6 z/OS 6.2.2
    Systems and Asset Management Tivoli OMEGAMON DE on z/OS 5.1.0
    Systems and Asset Management Tivoli OMEGAMON XE for Mainframe Networks ITCAM for RT Enabler for z/OS 5698-B01 v620 z/OS 4.2.0
    Systems and Asset Management IBM OMEGAMON z/OS Management Console z/OS 4.1.0
    Systems and Asset Management Tivoli OMEGAMON XE for Messaging for z/OS z/OS 7.0.1
    Storage Management Tivoli OMEGAMON XE for Storage on z/OS z/OS 4.2.0
    Systems and Asset Management Tivoli System Automation for z/OS z/OS 3.3
    Systems and Asset Management Tivoli NetView for z/OS z/OS V6R1
    Systems and Asset Management Tivoli Composite Application Manager for Transactions for z/OS z/OS
    Systems and Asset Management Tivoli Composite Application Manager for SOA Platform z/OS 7.1.1
    Systems and Asset Management Tivoli Composite Application Manager for Application Diagnostics on z/OS z/OS 7.1
    Storage Management Tivoli Advanced Audit for DFSMShsm z/OS 2.1
    Storage Management Tivoli Advanced Backup and Recovery for z/OS z/OS 2.1
    Storage Management Tivoli Advanced Catalog Management for z/OS z/OS 2.1
    Storage Management Tivoli Advanced Reporting for DFSMShsm z/OS 2.1
    Storage Management Tivoli Advanced Allocation Management z/OS 3.1
    Storage Management Tivoli Automated Tape Allocation Manager for z/OS z/OS 3.1
    Storage Management Tivoli Tape Optimizer on z/OS z/OS 2.2
    Systems and Asset Management Tivoli Decision Support for z/OS z/OS 1.8.1

    Product Alias/Synonym

    z/OS ICAT Installation and Configuration Assistance Tool - Configuration Tool for z/OS-based OMEGAMON/ITM suite of products.

    Document information

    More support for: IBM Tivoli Monitoring V6

    Software version: 6.3.0

    Operating system(s): z/OS

    Reference #: 1417935

    Modified date: 01 December 2016