PARMGEN Configuration for OMEGAMON/TMS Products on z/OS

News


Abstract

PARMGEN Configuration for IBM Tivoli OMEGAMON XE and other Tivoli Management Services (TMS) dependent products
[Supplementary materials to the "IBM Tivoli OMEGAMON XE and Tivoli Management Services on z/OS PARMGEN Reference" (official documentation found in URL: http://pic.dhe.ibm.com/infocenter/tivihelp/v61r1/index.jsp?topic=%2Fcom.ibm.itm.doc_6.3%2Fwelcome.htm under "OMEGAMON XE shared publications")]

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:
Hide details for z/OS Product Families Supported by PARMGEN (Minimum Versions)z/OS Product Families Supported by PARMGEN (Minimum Versions)
*Products configured in ICAT RTEs that will be converted to PARMGEN RTEs would need to be at these minimum versions listed above.

  • IBM Tivoli Management Services on z/OS V6.2.2
    1. Component: Tivoli Enterprise Monitoring Server [TEMS] (KDS)
    2. Component: Common Agent configuration framework (KAG)
    3. Component: Common Persistent Datastore [PDS] configuration framework (KPD)
  • IBM Tivoli OMEGAMON XE on z/OS V4.2.0
    1. Component: OMNIMON Base V6.2.0 (KCN/KOB)
    2. Component: End-to-End V6.2.0 (KET)
    3. Component: OMEGAMON II for MVS (KOM/KM2)
    4. Component: OMEGAMON XE on z/OS (KM5)
  • IBM Tivoli OMEGAMON DE on z/OS V3.1.0
    1. Component: OMEGAVIEW (KMV)
    2. Component: OMEGAVIEW II for the Enterprise (KWO)
  • IBM OMEGAMON z/OS Management Console V4.1.0
    1. Component: OMEGAMON z/OS Management Console Agent (KHL)
  • IBM Tivoli OMEGAMON XE for IMS on z/OS V4.2.0
    1. Component: OMNIMON Base V6.2.0 (KCN/KOB)
    2. Component: End-to-End V6.2.0 (KET)
    3. Component: OMEGAMON II for IMS (KOI/KI2)
    4. Component: OMEGAMON XE for IMS on z/OS (KI5)
  • IBM Tivoli OMEGAMON XE for DB2 Performance Expert/Monitor V4.2.0
    1. Component: OMNIMON Base V6.2.0 (KCN/KOB)
    2. Component: OMEGAMON XE for DB2 PE/PM (KO2/KD2)
    3. Component: OMEGAMON XE for DB2 PE/PM Agent (KD5)
  • IBM Tivoli OMEGAMON XE for CICS on z/OS V4.2.0
    1. Component: OMNIMON Base V6.2.0 (KCN/KOB)
    2. Component: End-to-End V6.2.0 (KET)
    3. Component: OMEGAMON II for CICS (KOC/KC2)
    4. Component: OMEGAMON XE for CICS on z/OS (KC5)
    5. Component: OMEGAMON XE for CICS TG on z/OS (KGW)
  • IBM Tivoli OMEGAMON XE for CICS TG on z/OS V4.2.0
    1. Component: OMEGAMON XE for CICS TG on z/OS (KGW)
  • IBM Tivoli OMEGAMON XE for Storage on z/OS V4.2.0
    1. Component: OMNIMON Base V6.2.0 (KCN/KOB)
    2. Component: OMEGAMON II for SMS (KDF)
    3. Component: OMEGAMON XE for Storage on z/OS (KS3)
  • IBM Tivoli OMEGAMON XE for Mainframe Networks V4.2.0
    1. Component: End-to-End V6.2.0 (KET)
    2. Component: OMEGAMON II for Mainframe Networks (KON)
    3. Component: OMEGAMON XE for Mainframe Networks (KN3)
  • IBM Tivoli NetView for z/OS Agent V5.4.0
    1. Component: NetView for z/OS Agent (KNA)
  • IBM Tivoli OMEGAMON XE for Messaging on z/OS V7.0.1
    1. Component: OMEGAMON XE for WebSphere MQ Configuration (KMC)
    2. Component: OMEGAMON XE for WebSphere MQ Monitoring (KMQ)
    3. Component: OMEGAMON XE for WebSphere Message Broker Monitoring (KQI)
  • IBM Tivoli Composite Application Manager (ITCAM) for SOA V7.1.1
    1. Component: ITCAM for SOA Agent (KD4)
  • IBM Tivoli Decision Support for z/OS V1.8.1
    1. Component: Tivoli Decision Support Agent (KDO)
  • IBM Tivoli System Automation for z/OS V3.3.0
    1. Component: System Automation Monitoring Agent (KAH)
  • IBM Tivoli Advanced Audit for DFSMShsm V2.3.0
    1. Component: Advanced Audit for DFSMShsm Agent (KRG)
    2. Component: Common TEP Interface (KRS)
  • IBM Tivoli Advanced Reporting and Management for z/OS V2.3.0
    1. Component: Advanced Reporting Agent (KRH)
    2. Component: Common TEP Interface (KRS)
  • IBM Tivoli Allocation Optimizer for z/OS V3.1.0
    1. Component: Allocation Optimizer Agent (KRJ)
    2. Component: Common TEP Interface (KRS)
  • IBM Tivoli Automated Tape Allocation Manager for z/OS V3.2.0
    1. Component: Automated Tape Allocation Manager Agent (KRK)
    2. Component: Common TEP Interface (KRS)
  • IBM Tivoli Advanced Catalog Management for z/OS V2.3.0
    1. Component: Advanced Catalog Management Agent (KRN)
    2. Component: Common TEP Interface (KRS)
  • IBM Tivoli Advanced Backup and Recovery for z/OS V2.2.0
    1. Component: Advanced Backup and Recovery Agent (KRV)
    2. Component: Common TEP Interface (KRS)
  • IBM Tivoli Tape Optimizer for z/OS V2.2.0
    1. Component: Tape Optimizer for z/OS Agent (KRW)
    2. Component: Common TEP Interface (KRS)
  • IBM Tivoli Composite Application Manager (ITCAM) for Application Diagnostics on z/OS V7.1.0
    1. Component: ITCAM for Application Diagnostics, TEMA (KYN)
  • ITCAM for Transactions, File Transfer Enabler for z/OS V7.1.0
    1. Component: File Transfer Enabler for z/OS Agent (KT1)



Enablement Support : ( Date Last Updated: 20140301)

A. Download the latest GA star PARMGEN PTFs and let s get started!
APAR#
FMID / PTF#
Interim Feature (IF) Release Date
OA40649 OA41145 HKCI310/UA67787 HKDS623/UA67687 February 28, 2013 (1Q13A)
OA41710 OA42423 HKCI310/UA69076 HKDS630/UA69363 June 30, 2013 (2Q13A)
OA42733 HKCI310/UA70760 September 30, 2013 (3Q13A)
OA43392 HKCI310/UA71054 October 25, 2013 (4Q13A)
OA44054 HKCI310/UA71761 December 31, 2013 (4Q13B)
OA43859 HKCI310/UA72225 *GA* February 28, 2014 (1Q14A) star
OA44620 HKCI310/UAnnnnn *ETA GA TBD* (2Q14A)
Subscribe: http://www.ibm.com/support/electronicsupport/ Sign-up for IBM MyNotifications: https://www.ibm.com/support/mynotifications


B. Download any cross-product dependency application PTFs:(Date Last Updated: 20131101)

APAR#
FMID / PTF#
Interim Feature (IF) Release Date
PM97298 PM97296 PM97294 PM99043 HKDB520/UK97830 HKDB520/UK98105 HKDB520/UK98279 HKDB520/UK98703 *GA* October 28, 2013*star Important: These HKDB520 PTFs must be applied prior to performing any ICAT or PARMGEN configuration work, if you upgrade the SMP/E environment to OMXE for DB2 PE/PM V5.2.0 (HKDB520 FMID). For upgrade considerations, refer to the "Version requirements" and "Basic upgrade requirements" sections of the common Upgrade Guide.
PM96412 HKDB511/UK98702 HKDB510/UK98701 HKDB420/UK98700 *GA* October 28, 2013*star Important: These HKDBvvv PTFs must be applied prior to performing any PARMGEN configuration work if you apply the PARMGEN 4Q13A (HKCI310 PTF UA71054) IF.
Hide details for Deployment considerations: OMEGAMON XE shared publications URL referenceDeployment considerations: OMEGAMON XE shared publications URL reference

Deployment considerations: Helpful reference URL:http://publib.boulder.ibm.com/infocenter/tivihelp/v61r1/index.jsp?topic=%2Fcom.ibm.itm.doc_6.3%2Fwelcome.htm then navigate to the "OMEGAMON XE shared publications" link where these common publications may be found:

  1. Quick Start Guide:http://publib.boulder.ibm.com/infocenter/tivihelp/v61r1/topic/com.ibm.omegamon_share.doc_6.3.0.1/om_common_510_quickstart_02.htm
  2. Common Planning and Configuration Guide: http://publib.boulder.ibm.com/infocenter/tivihelp/v61r1/topic/com.ibm.omegamon_share.doc_6.3.0.1/zcommonconfig/zcommonconfig.htm
  3. PARMGEN Reference (Scenarios-based):http://publib.boulder.ibm.com/infocenter/tivihelp/v61r1/topic/com.ibm.omegamon_share.doc_6.3.0.1/parmgenref/parmgenref.htm
  4. Common Parameter Reference (List of common PARMGEN profile parameters): http://publib.boulder.ibm.com/infocenter/tivihelp/v61r1/topic/com.ibm.omegamon_share.doc_6.3.0.1/commonparmref/commonparmref.htm
  5. Configuring the Tivoli Enterprise Monitoring Server on z/OS:http://publib.boulder.ibm.com/infocenter/tivihelp/v61r1/topic/com.ibm.omegamon_share.doc_6.3.0.1/ztemsconfig/ztemsconfig.htm
  6. OMEGAMON Enhanced 3270 User Interface Guide:http://publib.boulder.ibm.com/infocenter/tivihelp/v61r1/topic/com.ibm.omegamon_share.doc_6.3.0.1/e3270/e3270_interface.htm
  7. Upgrade Guide:http://publib.boulder.ibm.com/infocenter/tivihelp/v61r1/topic/com.ibm.omegamon_share.doc_6.3.0.1/upgrade/tmsz_upgrade.htm

Deployment considerations: Helpful reference Additional handy planning, ordering, installation/maintenance and configuration-related technotes:
  1. Planning and Ordering: "OMEGAMON and TMS on z/OS ”: URL:http://www.ibm.com/support/docview.wss?uid=swg21631828&lnk=uctug_tivoli_nwsltr_ITMV6
  2. Planning and Ordering: "Locating ITM Workspace Application Support Files for z/OS Agents ”: URL: http://www.ibm.com/support/docview.wss?uid=swg21255545
  3. Planning and Ordering: "Preinstallation Requirements and Instructions ”: URL: http://www.ibm.com/support/docview.wss?uid=swg21318692
  4. Installation: "Recommended Maintenance Service Levels for Tivoli OMEGAMON XE and Tivoli Advanced Reporting products on ITM V6.x: URL: http://www.ibm.com/support/docview.wss?uid=swg21290883
  5. Installation: "ITM Platform Maintenance Tables ”: URL: http://www.ibm.com/support/docview.wss?rs=203&uid=swg27008514
  6. Upgrading: Feature documents: OMEGAMON V510 ITM V623 on z/OS”: URL: http://www.ibm.com/support/docview.wss?uid=swg21626495


Once the latest HKCI310/HKDS vvv configuration 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.TARGET.TKANCUS '
============================================
(where &gbl_target_hilev = IBM.TARGET in this example)



Details :
  • Section: What's New in 1Q14A?star *GA*<--- *** Required reading ***(Date Last Updated: 20140301)
PARMGEN 1Q14A Whats New (HKCI310 PTF UA72225 APAR OA43859) Interim Feature D20140217.zipPARMGEN 1Q14A Whats New (HKCI310 PTF UA72225 APAR OA43859) Interim Feature D20140217.zip

  • Section: What Will Be in 2Q14A? <--- (Date Last Updated: 20140301)
<placeholder document>

  • *Section: (Reference Only) Previous nQyyA/nQyyB Interim Features (IFs)(Date Last Updated: 20140301) in the "Attachments"

  • *Section: FAQS (Date Last Updated: 20130803) in the "Attachments"

  • *Section: (Reference Only) Sample RTE Implementation Scenarios (Date Last Updated: 20130627) in the "Attachments"

  • *Section: (Reference Only) RFEs for Prioritization in the "Attachments"

*Note: In the " Attachments :" section of this technote is a detailed discussion of the FAQs and topics labeled " (Reference Only)" PARMGEN topics.
TIP: : As you navigate through the larger sections of this document, do a FIND on " Date Last Updated:" to quickly see if the frequently-subscribed Section(s) such as " Section: What's New in nQyyA/nQyyB IF?", " Section: What will be in nQyyA/nQyyB IF?" or " Section: FAQs" have been updated recently.
Each applicable Section will have a " ( Date Last Updated: yyyymmdd)" label for readability and ease-of-use.



Presentations and Upcoming Training Sessions : ( Date Last Updated: 20140301)
===========================================
  • Section B. Pulse 2014 PARMGEN Session E03 Hands-on Lab Guide
Pulse 2014 Session E03 PARMGEN Hands on Lab Guide - D20140301.zip ( Date Last Updated: 20140301)
At the IBM Pulse 2014 Conference in Las Vegas, Nevada held in February 2014, PARMGEN hosted a hands-on lab training. For your reference, Session E03 PARMGEN Hands-on Lab. Guide is also now available for downloading.

Two scenarios are supplied to get you acquainted with the PARMGEN method of configuration.
  1. Scenario PGN01: Create an SMP-sharing runtime environment (RTE) with a z/OS Hub TEMS and OMEGAMON Agents. This first scenario simulates a brand new deployment such as a new install or a deployment for a Proof of Concept (PoC) to cater to our first time users.
  2. Scenario PGN02: Convert an existing Configuration Tool (ICAT) RTE to PARMGEN and upgrade the products to the current release. This second 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 ICAT may be harvested and re-used in PARMGEN.

  • Section C. SHARE Conference in Boston held August 12 - 16, 2013 (Date Last Updated: 20130825)
Check out the PARMGEN Session 14116 in the URL provided. The presentation covered the following agenda topics:

URL: https://share.confex.com/share/121/webprogram/Session14116.html


  • Section D. Support Technical Exchange (STE):
    Title **Part 2** Good news for maintenance windows - install, configure and upgrade OMEGAMON/ITM suite faster using JOBGEN/PARMGEN
    Course number 20121001102132516
    Date 01/09/2013 @ 10:00 a.m. - 1:00 p.m. ET (US)
    Description This Support Technical Exchange (STE) session plans to cover the following topics:
    ** Part 2 is focused on the live demonstration of creating 2 PARMGEN RTE Scenarios
    ** Part 1 covered up to slide #50 of the attached PDF
    1. What is new with PARMGEN and OMEGAMON XE V510s in 2012
    2. What will be in PARMGEN 4Q12 Interim Feature (IF)?
    3. What will be in PARMGEN 1Q13 Interim Feature (IF)?
    4. Demonstrate key RTE implementation scenarios covered in the 4Q12 refresh of the PARMGEN Reference Guide
    Note: This 3-hour recorded STE will be a live mainframe demonstration for the majority of the time to allow for a more interactive session with the audience.
    Playback Centra URL:
    Centra Password:
    https://de202.sabameeting.com:443/GP/main/00000183cb250000013b0d4e155b8283

    tiv0li (0 is a zero)



Attachments:

  • Section: (Reference Only) Previous nQyyA/nQyyB Interim Features (IFs) (Date Last Updated: 20140301)
Hide details for Section: (Reference Only) Previous nQyyA/nQyyB Interim Features (IFs) Section: (Reference Only) Previous nQyyA/nQyyB Interim Features (IFs)
The following Interim Features (IFs) from previous maintenance cycles are also available for reference. These PTFs below are superceded by the latest HKCI310 and HKDS623 PTFs noted in the "Enablement Support" Section of this technote. The "What's New? (GA)" Section features the latest IFs available and their contents. ===END " Section: What's New in 4Q13B? "===
===END " Section: What's New in 4Q13A? "===

===END " Section: What's New in 3Q13A? "===


===END " Section: (Reference Only) Previous nQyyA/nQyyB Interim Features (IFs) "===


  • Section: FAQs: (Date Last Updated: 20130803)
Hide details for Section: FAQs: Section: FAQs:
Section: FAQs:
  • FAQ Index: The following "FAQ#nn QUESTION:" entries list the queries addressed in this section. Navigate to the
  • FAQ Details" section below for the detailed discussion. For ease-of-use, the FAQs have been grouped by popular search keywords that may be used and/or basic category where an FAQ may be classified under so the FAQ#nn are not in any ascending or descending order, but rather grouped by category based on when the FAQ was logged.

Next FAQ#nn:
==========================================================
FAQ#55 QUESTION : <placeholder>
==========================================================
PARMGEN FAQs D20130803.zipPARMGEN FAQs D20130803.zip
===END " FAQ#nn "===
===END " Sub-section: FAQ Details "===

===END " Section. FAQs "===


  • Section: Sample RTE Implementation Scenarios: (Date Last Updated: 20130627)
Hide details for Section: Sample RTE Implementation Scenarios Section: Sample RTE Implementation Scenarios
Section. Sample RTE Implementation Scenarios:
  • The latest version of the PARMGEN Reference Guide (Scenarios-based) is now posted in the IBM Tivoli Monitoring and OMEGAMON XE Infocenter (official documentation found in URL: http://pic.dhe.ibm.com/infocenter/tivihelp/v61r1/index.jsp?topic=%2Fcom.ibm.itm.doc_6.3%2Fwelcome.htm under "OMEGAMON XE shared publications"). Please refer to the Infocenter for an updated copy.
  • TIP: : Please always use the latest version (under "Version 6.3.0" March 2013) -- they are downward compatible (i.e., use the shared publications under "Version 630" link although you may still have ITM V623 installed and configured)
  • The latest version of the Common Parameter Reference Guide is also now posted in the Infocenter (prior version from February 2011).

===============================================================
===END " Section: Sample RTE Implementation Scenarios "===


  • Section: RFEs for Prioritization (Futures):
Hide details for Section: Request For Enhancements (RFE) for Future Consideration/Known Limitations for Future Implementation: Section: Request For Enhancements (RFE) for Future Consideration/Known Limitations for Future Implementation:
Section. Request For Enhancements (RFE) for Future Consideration/Known Limitations for Future Implementation:
The following enhancements and issues have been queued for further consideration (for enhancements) and for further implementation (known issues/limitation in the GA release):
Parameter Generator (PARMGEN) Workflow UI - Future RFEs for Prioritization (Technote #1417935).zipParameter Generator (PARMGEN) Workflow UI - Future RFEs for Prioritization (Technote #1417935).zip
A. Future Enhancements:
======================================================================
  • RFE: <Next>
  • DESCRIPTION: <Next>
  • STATUS: <Next>
  • Tip: <Next>
======================================================================

B. Known Issues/Limitations:
======================================================================
  • ISSUE: <Next>
  • DESCRIPTION: <Next>
  • FIX: <Next>
  • Tip: <Next>
======================================================================

===END " Section: RFEs for Prioritization (Futures) "===




    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 for z/OS z/OS 5.1.0
    Systems and Asset Management Tivoli OMEGAMON XE for DB2 Performance Monitor for 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 Tivoli Monitoring Version 6 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.

    Rate this page:

    (0 users)Average rating

    Add comments

    Document information


    More support for:

    Tivoli Monitoring Version 6

    Software version:

    6.2.2, 6.2.3, 6.3.0

    Operating system(s):

    z/OS

    Reference #:

    1417935

    Modified date:

    2014-03-05

    Translate my page

    Machine Translation

    Content navigation