PI48099: BBE1445E THE ITKB SERVER NAME IS INCORRECT ISSUED FOR INSUFFICIENT SECURITY ACCESS: SERVER NAME IS CORRECT

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When DB Sensor does not have sufficient security access to the
  IMS Tools KB server, it fails to connect to the server. In this
  case, DB Sensor issues message BBE1445E THE ITKB SERVER NAME IS
  INCORRECT, although the server name is correct.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: IBM IMS Database Reorganization Expert for   *
  *                 z/OS V4.1(FMID=H25N410) users who run        *
  *                 Smart Reorg utility.                         *
  *                 And, IBM IMS Database Solution Pack for      *
  *                 V1.2(FMID=HAHP120) or V2.1(FMID=HAHP210)     *
  *                 users who run FF Stand-alone Database Sensor *
  *                 (DB Sensor).                                 *
  ****************************************************************
  * PROBLEM DESCRIPTION: When a user who starts the DB Sensor    *
  *                      job does not have sufficient security   *
  *                      access to the IMS Tools KB server, DB   *
  *                      Sensor fails to connect to the server.  *
  *                      In this case, DB Sensor issues message  *
  *                      BBE1445E THE ITKB SERVER NAME IS        *
  *                      INCORRECT, although the server name is  *
  *                      correct.                                *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  The message text and explanation of BBBE1445E and HPSG2221W
  are changed.
  

Problem conclusion

•  ========================
  = DOCUMENTATION CHANGE =
  ========================
  The IBM IMS Database Reorganization Expert for z/OS User's
  Guide Version 4 Release 1 Suffix 4 (SC19-1137-04) should be
  changed as follows:
  > Troubleshooting
  >> Message and codes
  >>> Messages
  >>>> BBE messages
  ---------------------------------------------------------------
  | BBE1445E CONNECTION TO THE ITKB SERVER FAILED
  |
  | Explanation: The connection to the IMS Tools KB server
  | failed. This message might be issued for the following
  | reasons:
  | - The server configuration is incomplete.
  | - The server is not started.
  | - The server name that is specified by the ITKBSRVR
  |   keyword is incorrect.
  | - Insufficient access authority to repository.
    System action: DB Sensor processing ends with a return code
    of 8.
  | User response: Complete the following steps:
  | 1. Ensure that the server name specified on the ITKBSRVR
  |    keyword is correct.
  | 2. Ensure that the IMS Tools KB server is configured and
  |    started without any errors. For configuration steps,
  |    see the topic "Configuring IMS Tools Knowledge Base"
  |     in the Tools Base IMS Tools Knowledge Base User's Guide.
  | If the problem persists, contact your system administrator
  | to obtain the required level of authorization.
  ---------------------------------------------------------------
  >>>> HPSG messages
  | HPSG2221W CONNECTION TO THE ITKB SERVER FAILED
  |
  | Explanation: The connection to the IMS Tools KB server
  | failed. This message might be issued for the following
  | reasons:
  | - The server configuration is incomplete.
  | - The server is not started.
  | - The server name that is specified by the ITKBSRVR
  |   keyword is incorrect.
  | - Insufficient access authority to repository.
    System action: Processing continues, but no reports are
    stored in the IMS Tools KB Output repository.
  
  | User response: Complete the following steps:
  | 1. Ensure that the server name specified on the ITKBSRVR
  |    keyword is correct.
  | 2. Ensure that the IMS Tools KB server is configured and
  |    started without any errors. For configuration steps,
  |    see the topic "Configuring IMS Tools Knowledge Base"
  |     in the Tools Base IMS Tools Knowledge Base User's Guide.
  | If the problem persists, contact your system administrator
  | to obtain the required level of authorization.
  

Temporary fix

Comments

APAR Information

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

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

  UI31468

Modules/Macros

• BBESMSGT HPSGIT20 HPSGMSGT
  

Fix information

• Fixed component name

  IMS DB REORG EX

• Fixed component ID

  5655F7400

Applicable component levels

• R410 PSY UI31468

     UP15/09/26 P F509

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.