IBM Support

PM99022: CICS TG fails to start if it is unable to resolve the host address.

A fix is available

Obtain the fix for this APAR.

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • CICS TG fails to start if it is unable to resolve the host
address for the machine. The following messages are written:
CTG6525E Unable to start handler for the tcp: protocol, port:
         2006, because: [java.net.UnknownHostException: <host>:
         <host>]
CTG6513E CICS Transaction Gateway failed to initialize

Additional search words:
CTG6525 msgCTG6525E msgCTG6525
CTG6513 msgCTG6513E msgCTG6513

Local fix

  • 



Problem summary


    

  • ****************************************************************
* USERS AFFECTED: All users of CICS Transaction Gateway.       *
****************************************************************
* PROBLEM DESCRIPTION: CICS TG fails to start if it is unable  *
*                      to resolve the host address.            *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
While identifying the address or host name for statistics
PH_SBINDTCP and PH_SBINDSSL, it was possible for a
java.net.UnknownHostException to be returned when the host name
could not be resolved.
The UnknownHostException caused the affected protocol handler to
fail to start. The exception also caused the Gateway daemon to
fail to start.

    



Problem conclusion


    

  • CICS TG has been changed so that PH_SBINDTCP and PH_SBINDSSL
statistics are set to the address that the relevant protocol
handler is bound to.

    



Temporary fix


    

  • 



Comments


    

  • 



APAR Information




    

  • APAR number
    PM99022
    • 

  • Reported component name
    CTG V9 FOR Z/OS
    • 

  • Reported component ID
    5655Y2000
    • 

  • Reported release
    900
    • 

  • Status
    CLOSED  PER
    • 

  • PE
    NoPE
    • 

  • HIPER
    NoHIPER
    • 

  • Special Attention
    NoSpecatt / Xsystem
    • 

  • Submitted date
    2013-10-14
    • 

  • Closed date
    2014-01-22
    • 

  • Last modified date
    2014-02-05
    • 





    

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

    • 

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

    
PI09431 UI14443
    

    • 



Modules/Macros


    

  •    CTG00201 CTG00204

    



Fix information


    

  • Fixed component name
    CTG V9 FOR Z/OS
    • 

  • Fixed component ID
    5655Y2000
    • 



Applicable component levels


    

  • R900  PSY  UI14443
       UP14/01/28  P  F401
    • 



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":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"9.0","Edition":"","Line of Business":{"code":"","label":""}},{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMJ2","label":"CICS Transaction Gateway"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"9.0","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]
              

                                                                    

          
 
        

      

    

      

        

          

            
Document Information


            

            


                        

            Modified date:
            

            08 August 2024
            

            
                      

        


        

        


      

    

  



    

  

  
    
            

          
Page Feedback