PH03383: MISLEADING MESSAGE SHOWING 'CQM163I - CANCEL THREAD' UNDER DSG

IBM Db2 Query Monitor for z/OS CAE Browser Client download
Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• A misleading lCQM163I message indicating a DSG thread was
  successfully canceled may be produced.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: IBM Db2 Query Monitor z/OS users of          *
  *                 components                                   *
  *                 CAE server starting script                   *
  *                 CAE Web client                               *
  *                    (Reorg Recommendation Monitor panel)      *
  *                 CAE server on Windows                        *
  *                 - CAE Server                                 *
  *                 - ISPF Data Sharing                          *
  *                 - Exceptions                                 *
  *                 - Current Activity                           *
  ****************************************************************
  * PROBLEM DESCRIPTION: 1. Issuing cancel thread in ISPF in     *
  *                         Data sharing mode always returns     *
  *                         'CQM163I - Cancel Thread has been    *
  *                         issued successfully'.                *
  *                      2. Message like: 'Already started local *
  *                         portal, but was not able to connect  *
  *                         to it at ...' may fill the log in    *
  *                         some specifically configured         *
  *                         environment.                         *
  *                      3. User can see an abnormal message     *
  *                         "Unexpected end of JSON input"       *
  *                         when try to open Exceptions          *
  *                         in Archive Connection.               *
  *                      4. A huge number of getpages in         *
  *                         Object perspective                   *
  *                         (Current Activity and Exceptions).   *
  *                      5. Extra characters in the message      *
  *                         about the absence of authorization   *
  *                         in Cancel thread in CAE.             *
  ****************************************************************
  * RECOMMENDATION: Apply the provided PTF and specify a new     *
  *                 configuration CAE option during startup.     *
  ****************************************************************
  1. Return code was not set correctly when issuing cancel thread
     in data sharing mode from ISPF, which caused displaying
     CQM163I message about successful cancel. In CAE Web client
     error message was returned, although it may have looked
     unclear.
  2. An environment might be configured in a way where java call
     of InetAddress.getLocalHost() returns non-local ip address as
     a result CAE server can't determine its own ip address and
     prints error message like: "Already started local portal, but
     was not able to connect to it at ..."
  3. When user opens an Exceptions Perspective from Archive
     Connection an error message "Unexpected end of JSON input"
     may appear.
  4. In some cases for Distributed threads an unreasonably large
     number of getpages could be displayed in Object perspective
     (Current Activity and Exceptions) in ISPF. CAE interface
     showed correct value.
  5. In some cases, extra characters are appeared in the message
     about the absence of authorization in Cancel thread in CAE.
  

Problem conclusion

• 1. Correction of setting the return code and its processing in
     ISPF for cancel thread command for Data sharing mode. Error
     message in CAE Web client is not updated.
  2. Provide a configuration option CQM_CAE_LOCAL_ADDRESS for CAE
     server on USS and "-Dcom.rocketsoft.kbm.explicitLocalHost"
     java option for CAE server on Windows which allow user to
     explicitly specify local address for CAE server.
  3. Unexpected message in CAE Web client Exceptions Perspective
     from Archive Connection has been fixed.
  4. Logic was corrected to display exact number of getpages in
     Object perspective (Current Activity and Exceptions) and this
     value matches with value in CAE.
  5. Correction of authorization message in CAE Web client for
     Cancel Thread functionality.
  
  Search Keywords:
  DATA SHARING ISPF CANCEL THREAD CQM163I CAE DNS IP ADDRESS
  EXCEPTIONS
  

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:

  PH13137 UI63611

Modules/Macros

• CQM#QAPI CQM#QAPX CQM#QSQL CQM$CNCL CQM$OBJS CQMBLOB  CQMCAEPT
  CQMJAR   CQMMEXXX CQMMINDX CQMSSV
  

Fix information

• Fixed component name

  DB2 QUERY MONIT

• Fixed component ID

  5655E6701

Applicable component levels

• R330 PSY UI63611

     UP19/06/17 P F906

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.