IBM Support

PH44683: ALLOW DUPLICATE URIMAPS WITH USAGE(CLIENT) TO BE INSTALLED

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as new function.

Error description

  • CICS does not allow URIMAPs with the same endpoint (host, port
    and path) as an existing URIMAP to be installed.
    
    If different CICS applications need to access the same external
    service, and also need to use application specific security
    settings (e.g. certificates or ciphers), then this is not
    possible.
    
    This APAR has been raised to allow URIMAPs with USAGE(CLIENT)
    to be installed when they have the same endpoint as an existing
    URIMAP.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users                               *
    ****************************************************************
    * PROBLEM DESCRIPTION: CICS does not allow URIMAPs to be       *
    *                      installed if they have the same         *
    *                      endpoint as an already installed        *
    *                      URIMAP.                                 *
    ****************************************************************
    CICS does not allow URIMAPs with the same endpoint (host, port
    and path) as an existing URIMAP to be installed.
    
    If different CICS applications need to access the same external
    service, and also need to use application specific security
    settings (e.g. certificates or ciphers), then this is not
    possible.
    

Problem conclusion

Temporary fix

Comments

  • CICS has been changed to allow URIMAPs with USAGE(CLIENT) to be
    installed even if they have the same endpoint (HOST, PORT and
    PATH) as an existing URIMAP.
    
    These duplicate URIMAPs can only be referenced directly by name
    on the EXEC CICS WEB OPEN and EXEC CICS INVOKE SERVICE commands.
    
    An EXEC CICS INVOKE SERVICE command that does not specify a
    URIMAP on the command, but relied on matching an installed
    URIMAP, will only match the first URIMAP to be installed with
    the required endpoint.
    
    The CICS TS 5.4, 5.5 and 5.6 documentation will be updated to;
     - Indicate that the duplicate URIMAP restriction has been
       removed for URIMAPs with USAGE(CLIENT).
     - Describe the new DFHWS-URIMAP context container that will
       appear as part of a PIPELINE.
    ×**** PE22/08/17 FIX IN ERROR. SEE APAR PH48753  FOR DESCRIPTION
    

APAR Information

  • APAR number

    PH44683

  • Reported component name

    CICS TS Z/OS V5

  • Reported component ID

    5655Y0400

  • Reported release

    100

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2022-03-07

  • Closed date

    2022-04-25

  • Last modified date

    2022-12-14

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

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

    UI80270 UI80271 UI80272 UI80273 UI80274 UI80275 UI80276 UI80277
    UI80278 UI80279 UI80280 UI80281 UI80282

Modules/Macros

  • DFHJSON  DFHPIA1  DFHPIAD  DFHPIAP  DFHPIAT  DFHPICA  DFHPICC
    DFHPIDM  DFHPIDSH DFHPIDSQ DFHPIDUF DFHPIII  DFHPIIW  DFHPIJG
    DFHPIJP  DFHPIJP1 DFHPIJS  DFHPIJW  DFHPILN  DFHPIMM  DFHPIPL
    DFHPIPM  DFHPIPM2 DFHPIPMT DFHPIPS  DFHPIRE  DFHPIRI  DFHPIRL
    DFHPIRM  DFHPIRN  DFHPIRS  DFHPIRT  DFHPISC  DFHPISF  DFHPISN
    DFHPIST  DFHPITC  DFHPITC1 DFHPITC2 DFHPITC3 DFHPITE  DFHPITH
    DFHPITJ  DFHPITL  DFHPITQ  DFHPITRI DFHPITS  DFHPIUCD DFHPIUCH
    DFHPIUCL DFHPIUCO DFHPIUDL DFHPIUE  DFHPIWR  DFHPIWT  DFHPIXI
    DFHPIXM  DFHPIXO  DFHSJJI  DFHSJNA  DFHWBA   DFHWBAP  DFHWBAPF
    DFHWBDUF DFHWBRP  DFHWBSC  DFHWBSR  DFHWBUR  DFHWBXM  DFHWBXN
    DFHWSADH DFHWSATH DFHWSATR DFHWSATX DFJ@H360
    

Fix information

  • Fixed component name

    CICS TS Z/OS V5

  • Fixed component ID

    5655Y0400

Applicable component levels

  • R100 PSY UI80278

       UP22/04/26 P F204

  • R101 PSY UI80280

       UP22/04/26 P F204

  • R102 PSY UI80281

       UP22/04/26 P F204

  • R103 PSY UI80282

       UP22/04/26 P F204

  • R10D PSY UI80279

       UP22/04/26 P F204

  • R200 PSY UI80274

       UP22/04/26 P F204

  • R201 PSY UI80275

       UP22/04/26 P F204

  • R202 PSY UI80276

       UP22/04/26 P F204

  • R203 PSY UI80277

       UP22/04/26 P F204

  • R300 PSY UI80270

       UP22/04/26 P F204

  • R301 PSY UI80271

       UP22/04/26 P F204

  • R302 PSY UI80272

       UP22/04/26 P F204

  • R303 PSY UI80273

       UP22/04/26 P F204

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.

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"5.4","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Document Information

Modified date:
14 December 2022