PI63567: FULL FUNCTION DB SENSOR ENHANCEMENT FOR RUNNING WITHOUT IMS TOOLS KNOWLEDGE BASE SERVER.

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This APAR enhances the stand-alone FF DB Sensor to run without
  IMS Tools Knowledge Base Server.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: IBM IMS Database Reorganization Expert for   *
  *                 z/OS V4.1(FMID=H25N410) users and            *
  *                 IBM IMS Database Solution Pack for           *
  *                 V2.1(FMID=HAHP210) users who run FF          *
  *                 Stand-alone Database Sensor(DB Sensor).      *
  ****************************************************************
  * PROBLEM DESCRIPTION: FF Stand-alone Database Sensor supports *
  *                      ITKBSRVR=*NO in the BBESIN data set.    *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  FF Stand-alone Database Sensor supports ITKBSRVR=*NO of GLOBAL
  command in the BBESIN data set to run without IMS Tools
  knowledge base server. If you specify ITKBSRVR=*NO, FF
  Stand-alone DB Sensor does not store sensor data or reports in
  the IMS Tools Knowledge Base repositories.
  

Problem conclusion

Temporary fix

Comments

• The following modules have been modified to support this new
  function.
   BBESACTL
   BBESENSR
   BBESINT0
   BBESMAIN
   BBESMSGT
   BBESSTMD
   BBESUSDF
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
   The documentation is modified as follows:
   ==============================================================
   IMS Solution Packs Database Sensor V2R1,
   User's Guide (SC19328301)
   ==============================================================
   >> FF Stand-alone DB Sensor JCL and control statements
   >>> GLOBAL command keywords for FF Stand-alone DB Sensor
  (The following syntax diagram is modified.)
   >>-GLOBAL---+....
               :                                                 :
  |            |           .-*NO-------------------------.       |
  |            +-ITKBSRVR=-+-IMS_Tools_KB_XCF_group_name-+-------+
  
  (The following description is modified.)
   ADXCFGRP=
     This keyword specifies whether to send notification to
     Autonomics Director. The notification is used as a trigger by
     Autonomics Director to schedule a policy evaluation. If you
     omit this keyword, ADXCFGRP=*NO is used as the default value.
  
     Important: If you want Autonomics Director to schedule a
     policy evaluation, you must specify the name of the
  |  Autonomics Director XCF group with this keyword.
  
    Autonomics_Director_XCF_group_name
       FF Stand-alone DB Sensor sends sensor data notification to
       Autonomics Director after storing sensor data in the Sensor
       Data repository of IMS Tools KB.  If you specify the
       Autonomics Director XCF group, you must specify DBRC=YES
  |    and ITKBSRVR=IMS_Tools_KB_XCF_group_name.
  
   ITKBSRVR=
     This keyword specifies the IMS Tools KB XCF group name
     (the IMS Tools KB server name). The sensor data and the DB
     Sensor reports are stored in the IMS Tools Knowledge Base
     repositories that are managed by this IMS Tools KB server.
  |  If you omit this keyword, ITKBSRVR=*NO is used as the
  |  default value.
  
  |  Important: If you want to analyze sensor charts on
  |  Management Console or schedule a policy evaluation by using
  |  Autonomics Director, you must specify the name of the
  |  IMS Tools KB XCF group with this keyword.
  
  |  IMS_Tools_KB_XCF_group_name
  |    FF Stand-alone DB Sensor stores sensor data and reports
  |    in the IMS Tools Knowledge Base repositories.
  
  |  *NO
  |    FF Stand-alone DB Sensor does not store sensor data or
  |    reports in the IMS Tools Knowledge Base repositories.
  |    If you specify ITKBSRVR=*NO, sensor data is available
  |    only through the Sensor Data Statistics report that
  |    is generated in the BBESPRT data set.
  
   >> Setting site default vaues for FF Stand-alone DB Sensor
   >>> Keywords for FF Site Default Generation utility
  
  (The Table 1 is modified.)
   ------------------------------------------
   Keyword            DB Sensor default value
   ------------------------------------------
   :
   ------------------------------------------
  |ITKBSRVR           *NO
   ------------------------------------------
  
   > Troubleshooting
   >> Messages and codes
   >>> FF DB Sensor messages
  (The following message is added.)
  |BBE1208W FAILED TO SEND SENSOR DATA NOTIFICATION TO AD.
  |  ITKB SERVER AND AD SERVER NAMES MUST BE SPECIFIED.
  |Explanation: DB Sensor did not send a sensor data notification
  |  to Autonomics Director because ITKBSRVR=*NO is specified in
  |  the BBESIN data set. To send a sensor data notification to
  |  Autonomics Director, both the ADXCFGRP keyword and the
  |  ITKBSRVR keyword must specify valid server names.
  |System Action: DB Sensor continues processing without sending
  |  a sensor data notification to Autonomics Director. When the
  |  process is complete, DB Sensor ends with return code 4.
  |User Response: If you want DB Sensor to send a sensor data
  |  notification to Autonomics Director to start a policy
  |  evaluation, specify ITKBSRVR=xxxx in the BBESIN data set,
  |  and rerun the job.
  

APAR Information

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

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

  UI38778

Modules/Macros

•    BBESACTL BBESENSR BBESINT0 BBESMAIN BBESMSGT
  BBESSTMD BBESUSDF
  

Fix information

• Fixed component name

  IMS DB REORG EX

• Fixed component ID

  5655F7400

Applicable component levels

• R410 PSY UI38778

     UP16/06/22 P F606

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.