PM01906: CICS WEB SERVICES SAMPLE DOES NOT INVOKE SCA SERVICES

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• A CICS Web Service sample was used to build a demo to showcase
  the operation between CICS and WAS using SCA services, but SCA
  services are not invoked.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: DFHPI0506 is issued when using the CICS *
  *                      catalog manager sample application with *
  *                      SCA.                                    *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The Service component architecture scenario "Creating a
  composite from a Web service provider" is being followed.  The
  catalog manager sample application has been installed but the
  ECFG transaction has never been run, or has been run but the
  hostname specified in the URI is invalid.
  
  When the Catalog manager sample is run DFH0XWOD gets called
  to invoke the dispatchOrder service.  An INVOKE WEBSERVICE
  command is issued specifying a URI which was set using the ECFG
  transaction.  This URI will get used in preference to the URI
  in the deployed SCA composite.  When the URI is parsed the
  hostname is found to be invalid and the INVOKE WEBSERVICE
  returns INVREQ with RESP2=4.  Message DFHPI0506 is also issued.
  

Problem conclusion

• DFH0XWOD has been changed to issue an INVOKE SERVICE command
  without the URI option if the original INVOKE WEBSERVICE fails
  with INVREQ and RESP2=4.
  
  The CICS Transaction Server for z/OS Version 4 Release 1
  Application Programming Reference (SC34-7023-01) will be
  updated as follows;
  
  In the INVOKE SERVICE section change the last sentence of the
  description of the URI option to read
  
  "Do not specify this option for Web services that use
   WS-Addressing or for SCA applications."
  
  
  The CICS TS 4.1 Information Center will also be updated.
  In "Scenarios -> Service component architecture Scenarios ->
  Creating a composite from a Web service provider" replace
  the content of the section headed "Before you begin" with the
  following;
  
  "Ensure that APAR PM01906 is applied to your CICS region. The
  catalog example application must also be installed in the CICS
  region, including the pipelines for the Web services enablement
  of the catalog application.
  
  You must also remove the URI value from the example application
  using the ECFG transaction.  For SCA applications, do not
  specify the URI option directly on the INVOKE SERVICE command.
  CICS uses the URI that is specified in the Web service binding
  instead."
  

Temporary fix

• CICS AR601
  ++ APAR (AM01906).
  ++ VER (C150) FMID(JCI6601).
  ++ MACUPD (DFH0XWOD) DISTLIB(ADFHSAMP) SYSLIB(SDFHSAMP)
     /* MODULE: DFH0XWOD --- TYPE: COBOL */.
  ./ CHANGE NAME=DFH0XWOD,SEQFLD=738
                       URI(WS-ENDPOINT-URI)           74340000
        * Determine URI at runtime          @BA01906A 74422000
             IF RESP = DFHRESP(INVREQ) AND RESP2 = 4
                                 THEN                 74424000
               EXEC CICS INVOKE
            SERVICE(WS-WEBSERVICE-NAME)               74426000
                         CHANNEL(WS-CHANNELNAME)      74428000
                         OPERATION(WS-OPERATION)      74430000
                         RESP(RESP) RESP2(RESP2)      74432000
               END-EXEC                               74434000
             END-IF.                                  74436000
                                                      74438000
                     MOVE 'Error calling dispatch service
                                      - INVREQ'       74640000
                         TO CA-ORD-RESPONSE-MESSAGE   74660000
                     MOVE 30 TO CA-ORD-RETURN-CODE    74680000
  ./ ENDUP
  

Comments

APAR Information

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

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

  UK59766

Modules/Macros

•    DFH0XWOD
  

Fix information

• Fixed component name

  CICS TS Z/OS V4

• Fixed component ID

  5655S9700

Applicable component levels

• R601 PSY UK59766

     UP10/08/23 P F008

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.