Troubleshooting the Web services server adapter

If you are experiencing a problem with the Web services server adapter, read through the following information to find out how to diagnose the problem.

The Web services server adapter DFHMASWS enables an adapter service to send a Web service request to a service provider using the existing Web services support in CICS. If the error message CIA08112E is in the error file dump or a SOAP fault message, this indicates that an error occurred in the runtime environment when it tried to issue the Web service request.
  1. Check the CICS job log for any DFHPI prefixed error messages. A DFHPI prefixed message could indicate that there is an underlying problem with the Web services support in the CICS region. If there are any DFHPI messages, follow the guidance in the message details to fix the problem. You can also check the Diagnosing problems section of the CICS Web Services Guide.
  2. Analyze the dump of the error file to see if this indicates what the problem is.
    1. Look for the error message CIA08112E. The details of the error entry are below the message. Here is an example of what you might see:
      ---------------------------------------------------------------------------------------------------------------
      Processed:  Date:  04/27/06     Time:  13:48:04:       PutApplid:               PutTranid:                   
          Error:  CIA08112E    Normal processing                                                                   
                                                                                                                    
         Userid:  CICSUSER     Applid:               Tranid:  CMAO     Eibtaskn:   0000093  AbsTime:  003355134483920
        Request:  SAMPCARN       Mode:  Sync        Program:  DFHMASWS     Type:  System                             
       Activity:  PlaceOrder                      Node Name:                                                         
          Event:  DFHINITIAL                     Event type:  System       Step:  MAIN                               
       Proctype:  DFHMAINA                          Process:  003355134483840T160                                  
      Failed Processtype:                    Failed Process:                                                        
       ReplyToQ:                                                    ReplyToQMgr:                                     
       MQ MsgId:                                MQ CorrelId:                                                        
                                                                                                                    
      Error detail:  Web Service request                                                                            
       Web Service Resource Name:  testPlaceOrder                      CICS Resp:  00000016     CICS Resp2:  00000004
           Web Service Operation:  DFH0XCMNOperation                                                                 
      Overriding Web Service URI:  12345678901234567890123456789012345678901234567890123456789012345678901234567890  
      ---------------------------------------------------------------------------------------------------------------
      In the example, the value Program: DFHMASWS indicates that the error occurred in the Web services server adapter.
    2. Check the meaning of the CICS RESP2 code for the INVOKE WEBSERVICE command in the CICS Web Services Guide. In the example above, CICS returned a RESP code of 16 and a RESP2 code of 4, which indicates that the URI is invalid.
  3. Fix the problem and invoke the adapter service again to ensure it works correctly. In the example above, you would need to change the URI that is passed to the Web service server adapter. Depending on the nature of the problem, you might need to redeploy your adapter service into CICS. For details on how to do this, see Updating an existing adapter service.