PM15358: CONTEXT AND SCOPE IN A CMCI REQUEST NOT URL-ENCODED CAN'T HANDLE CHARACTERS SUCH AS #'S DUE TO THEIR MEANING IN A URL

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Receive the following error message in your CICS Explorer:
  MESSAGE CNX0220E A connection error has occurred: INVALIDPARM,
  PARM
  .
  Upon review, it was determined that the Context and Scope in a
  CMCI request is not being URL-encoded and so can't handle
  characters such as # (pound signs) in them due to their meaning
  in a URL.
  

Local fix

• Additional Keywords: CICS Explorer APAR is IZ76428. This will
  need to be applied as well to fix this issue.
  KIXREVCTC
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM V4R1M0 Users                 *
  ****************************************************************
  * PROBLEM DESCRIPTION:    You open CICS Explorer and try to    *
  *                      connect to an System Management Single  *
  *                      Server (SMSS) whose applid contains a   *
  *                      pound sign (#).  You see the following  *
  *                      error message:                          *
  *                                                              *
  *                         MESSAGE CNX0220E A connection error  *
  *                           has occurred: INVALIDPARM,CONTEXT  *
  *                                                              *
  *                      The same message appears when you try   *
  *                      to connnect to a CICSplex whose plex-   *
  *                      name contains a pound sign.             *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves this    *
  *                 APAR, all Web User Interface (WUI) servers   *
  *                 and System Managed Single Server (SMSS)      *
  *                 regions must be recycled to pick up the up-  *
  *                 dated CMCI server.  Note that regions do     *
  *                 not have to be restarted at the same time.   *
  *                                                              *
  *                 CICS Explorer APAR IZ76428 must be applied   *
  *                 to any CICS Explorer clients which connect   *
  *                 to an updated server to properly encode the  *
  *                 incoming message.                            *
  *                                                              *
  *                 Any user applications which connect to a     *
  *                 CMCI server must be updated to URL-encode    *
  *                 Context and Scope for transmission to the    *
  *                 CMCI server.                                 *
  ****************************************************************
     The Context and Scope in a CMCI request is not being URL-
  encoded and so can't handle characters such as # (pound signs)
  due to their meaning in a URL.  This affects Context and Scope
  in CICS Explorer clients connecting to V4.1 CICSplexes, and
  the Applid of SMSS regions to which CICS Explorer connects.
  

Problem conclusion

• Module DFHWUPFM (WUPFM - CMCI Request Formatter) was modi-
  fied to accept and decode URL-encoded values for Context and
  Scope.  With CICS Explorer APAR IZ76428 which causes URLs
  submitted by CICS Explorer to be properly encoded, this allows
  Context and Scope values containing special characters to be
  sent to the CMCI Server.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

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

  UK58222

Modules/Macros

• DESWUPFM DFHWUPFM
  

Fix information

• Fixed component name

  CICS TS Z/OS V4

• Fixed component ID

  5655S9700

Applicable component levels

• R60M PSY UK58222

     UP10/06/29 P F006

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.