Upgrading OMEGAMON Data Broker

Upgrade the Zowe™ cross-memory server that runs OMEGAMON® Data Broker, and register the additional ZISDYNAMIC plug-in that OMEGAMON Data Broker now requires.

About this task

These upgrade steps are required because OMEGAMON Data Broker now requires:

  • A Zowe cross-memory server load module from Zowe 2.12.0 or later.
  • The ZIS dynamic linkage base plug-in, ZISDYNAMIC.

If you already run OMEGAMON Data Broker in the Zowe cross-memory server that is supplied with OMEGAMON Data Provider, then you can simply continue doing that. OMEGAMON Data Provider supplies a newer server load module in the same location as the old load module, TKANMODP(KAYSIS01), and the new ZISDYNAMIC plug-in in the same library, as TKANMODP(KAYSISDL).

However, if you run OMEGAMON Data Broker in a Zowe cross-memory server that is part of a separate installation of Zowe earlier than 2.12.0, then either:

  • Upgrade your separate installation of Zowe to a more recent version. For details, see the Zowe documentation.

    Ensure that the STEPLIB concatenation for your Zowe cross-memory server job step includes the latest OMEGAMON Data Broker load modules, supplied in TKANMODP(KAYB0001) and TKANMODP(KAYBNETL).

  • Switch to using the server load module that is supplied with OMEGAMON Data Provider. For details on configuring OMEGAMON Data Broker to run in the Zowe cross-memory server that is supplied with OMEGAMON Data Provider, see Configuring OMEGAMON Data Broker.

Whether you use the server supplied with OMEGAMON Data Provider or in a stand-alone installation of Zowe, perform the following procedure to register the ZISDYNAMIC plug-in.

Procedure

  1. Register the ZISDYNAMIC plug-in in the Zowe cross-memory server configuration member.
    • If you are using the server supplied with OMEGAMON Data Provider, insert the following line at the top of the PARMLIB(KAYSIPxx) configuration member:
      ZWES.PLUGIN.KAY.ZISDYNAMIC=KAYSISDL
    • If you are using the server in a separate installation of Zowe, insert the following line at the top of the PARMLIB(ZWESIPxx) configuration member:
      ZWES.PLUGIN.ZISDYNAMIC=ZWESISDL
      Important: Only register the ZISDYNAMIC plug-in once. For example, do not attempt to register the ZISDYNAMIC plug-in once referring to the ZWESISDL load module supplied with Zowe, and then again referring to the KAYSISDL load module supplied with OMEGAMON Data Provider. You do not need to copy the TKANMODP(KAYSISDL) member supplied with OMEGAMON Data Provider to the STEPLIB concatenation for the server in your separate installation of Zowe. If you use a server in a separate installation of Zowe, refer to the ZWESISDL plug-in load module supplied with Zowe.
  2. Change the name of the existing parameter that registers the OMEGAMON Data Broker plug-in in the Zowe cross-memory server configuration member.

    This change is not strictly necessary, but it's recommended for consistency with the name of the new parameter for the ZISDYNAMIC plug-in.

    Change the existing line:

    ZWES.PLUGIN.CIDB=KAYB0001

    to:

    ZWES.PLUGIN.KAY.CIDB=KAYB0001

    That is, insert the new qualifier .KAY between .PLUGIN and .CIDB.