Troubleshooting the web service server adapter

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

About this task

The web service server adapter DFHMASWS enables a service flow to send a web service request to a service provider using the existing web services support in CICS. If the error message DFHMA08112E is in the error file dump or a SOAP fault message, it indicates that an error occurred in the runtime environment when it tried to issue the web service request.

Procedure

  1. Check the CICS job log for any DFHPI-prefixed error messages. A DFHPI-prefixed message can indicate that the web services support in the CICS region has an underlying problem. If you have DFHPI messages, follow the guidance in the message details to fix the problem. You can also check .
  2. Analyze the details of the error message to see if it indicates what the problem is.
    1. Look for the error message DFHMA08112E. 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:  DFHMA08112E    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 previous example, CICS returned a RESP code of 16 and a RESP2 code of 4, which indicate that the URI is not valid.
  3. Fix the problem and invoke the service flow again to ensure it works correctly. In the previous example, you must change the URI that is passed to the web service server adapter. Depending on the nature of the problem, you might have to redeploy your service flow into CICS. For details on how to do this, see Updating an existing service flow.


dfhcr_troubleshoot_webservice.html | Timestamp icon Last updated: Sunday, 4 June 2017