PK36349: FORWARD TAKE ACTION COMMANDS TO NETVIEW FOR Z/OS CONFIGURATION OPTION AVAILABLE

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• An optional Forward Take Action commands to NetView for z/OS
  configuration option is now available on the "Specify advanced
  agent configuration values" panel.  This function provides the
  capability to forward Take Action commands to IBM Tivoli NetView
  for z/OS V5.2 (and higher versions) for Take Action command
  

Local fix

• n/a
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: OMEGAMON XE for DB2 PE/DB2PM                 *
  *                 users of component:                          *
  *                 -   OMEGAMON XE Agent                        *
  *                 -   ICAT                                     *
  ****************************************************************
  * PROBLEM DESCRIPTION: 1.This is the Agent relink support for: *
  *                        FIXPACK 3.6.0-TIV-MgtSrvDS-FP0006     *
  *                        at Build level L186330.               *
  *                      2.This is the batch mode configuration  *
  *                        support for the following             *
  *                        enhancements:                         *
  *                        a. "Forward Take Action commands to   *
  *                           NetView for z/OS" .                *
  *                        b. "Network interface list"           *
  *                                                              *
  *                      The following new Agent batch           *
  *                      parameters support these enhancements:  *
  *                      a. "Forward Take Action commands to     *
  *                         NetView for z/OS" .                  *
  *                      New Parameter Name   Default Value      *
  *                      --------------------------------------  *
  *                      KD5_AGT_PPI_RECEIVER "CNMPCMDR"         *
  *                      KD5_AGT_PPI_SENDER   ""                 *
  *                                                              *
  *                      b. Network interface list:              *
  *                      New Parameter Name   Default Value      *
  *                      --------------------------------------  *
  *                      KD5_AGT_TCP_KDEBLST  ""                 *
  *                                                              *
  *                      3. This is the batch configuration      *
  *                         support for changes in the initial   *
  *                         default setting of the following     *
  *                         batch parameter:                     *
  *                      Parameter Current DEF() New DEF()       *
  *                      --------------------------------------  *
  *                      KD5_AGT_STOR_MIN_EXT    DEF(60000)      *
  *                      DEF(150000)                             *
  *                                                              *
  *                      4.With system variable support enabled, *
  *                        ICAT configuration generates invalid  *
  *                        substitution JCL for DDname RKANPAR   *
  *                         and data set type RKANPARU in CUA    *
  *                         JCL procedure.                       *
  *                                                              *
  *                      5. OMEGAMON XE for DB2 Agent cannot     *
  *                         be configured when OMEGAMON XE for   *
  *                         DB2 PE on z/OS has not been          *
  *                         previously configured.               *
  ****************************************************************
  * RECOMMENDATION: APPLY this PTF                               *
  ****************************************************************
  1. This is the Agent relink support for: Fixpack
     3.6.0-TIV-MgtSrvDS-FP0006 at Build level L186330.
  2. This is the batch mode configuration support for the
     following enhancements:
     a. "Forward Take Action commands to NetView for z/OS"
     b. "Network interface list"
     The following new Agent batch parameters support these
     enhancements:
     a. Forward Take Action commands to NetView for z/OS:
     New Parameter Name        Default Value
     --------------------      -------------
     KD5_AGT_PPI_RECEIVER      "CNMPCMDR"
     KD5_AGT_PPI_SENDER        ""
     b. Network interface list:
     New Parameter Name        Default Value
     --------------------      -------------
     KD5_AGT_TCP_KDEBLST       ""
  3. This is the batch configuration support for changes in the
     initial default setting of the following batch parameter:
     Parameter Name         Current DEF()    New DEF()
     --------------------   -------------    -----------
     KD5_AGT_STOR_MIN_EXT   DEF(60000)       DEF(150000)
  4. With system variable support enabled, ICAT configuration
     generates invalid substitution JCL for DDname RKANPAR and
     data set type RKANPARU in CUA JCL procedure.
  
  5. OMEGAMON XE for DB2 Agent cannot be configured when
     OMEGAMON XE for DB2 PE on z/OS has not been previously
     configured.
  

Problem conclusion

Temporary fix

Comments

• 1. Relink the Agent modules to pick-up platform support
     for Fixpack 3.6.0-TIV-MgtSrvDS-FP0006 at Build level L186330.
  2. Provide batch mode configuration support for the following
     enhancements by supporting these new batch parameters:
     a. "Forward Take Action commands to NetView for z/OS"
     New Parameter Name        Default Value
     --------------------      -------------
     KD5_AGT_PPI_RECEIVER      "CNMPCMDR"
     KD5_AGT_PPI_SENDER        ""
     b. "Network interface list"
     New Parameter Name        Default Value
     --------------------      -------------
     KD5_AGT_TCP_KDEBLST       ""
  3. Modify the initial default for the KD5_AGT_STOR_MIN_EXT
     parameter.
     This default will not affect existing configuration --
     it is only used in a brand new RTE that will be created
     via batch mode and this parameter is not defined in the
     parameter deck.
  4. Modify scripts KD260SS1 and KD261SS1 to generate correct JCL
     for DDname RKANPAR and data set type RKANPARU in CUA
     JCL procedure.
  5. Allow OMEGAMON XE for DB2 Agent to be configured
     without first configuring OMEGAMON XE for DB2 PE, if
     OMEGAMON XE for DB2 Agent only needs to register with
     the local TEMS for purposes of adding TEMS application
     support.
  ----------------------------------------------------------------
   Keywords: FORWARD TAKE ACTION COMMANDS TO NETVIEW FOR Z/OS
             KGLHC_PPI_RECEIVER=CNMPCMDR KGLHC_PPI_SENDER
             NETWORK INTERFACE LIST KDEB_INTERFACELIST
             KD5_AGT_PPI_RECEIVER KD5_AGT_PPI_SENDER
             KD5_AGT_TCP_KDEBLST KD5_AGT_STOR_MIN_EXT
             RKANPAR RKANPARU CUA JCL
  

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UK21259 UK21274

Modules/Macros

•    KD2CVCFG KD2SLEXT KD260SE1 KD260SS1 KD261DFI
  KD261SE1 KD261SS1 KD5AGENT KD5BHELP KD5CEXIT KD5CRDME KD5DDICT
  KD5DRNEW KD5SBATO KD531CCB KD531CCU KD531DFI KD531HU  KD531HUA
  KD531HUB KD531HUC KD531HUD KD531MCU KD5310CB KD5310PC KD5310SP
  KD541CCB KD541CCU KD541DFI KD541HU  KD541HUA KD541HUB KD541HUC
  KD541HUD KD541MCU KD5410CB KD5410PC KD5410SP
  

Fix information

• Fixed component name

  OM XE DB2PE/PM

• Fixed component ID

  5655OPE00

Applicable component levels

• R310 PSY UK21259

     UP07/01/19 P F701

• R410 PSY UK21274

     UP07/01/19 P F701

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.