A fix is available
APAR status
Closed as program error.
Error description
Web services monitoring
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All * **************************************************************** * PROBLEM DESCRIPTION: Add support for the new CICS Global * * User Exit point XWSPRROO. * **************************************************************** * RECOMMENDATION: * **************************************************************** Supply support for the new GLUE XWSPRROO and a sample exit DFH$PIEX in order to facilitate CICS web services monitoring.
Problem conclusion
Support for XWSPRROO has been implemented and sample DFH$PIEX provided. The CICS Transaction Server for z/OS Customization Guide Version 3 Release 2 SC34-6814-01 has been altered to add a new section after 'Monitoring domain exit XMNOUT' called 'Pipeline domain exits' as follows:- "Pipeline domain exits Use the pipeline domain exit to customize the processing that occurs for outbound Web services in the pipeline. Exit XWSPRROO The XWSPRROO exit enables you to access containers on the current channel after the Web services provider application has issued the Web service response message and before CICS creates the body of the response message. You can use this exit to issue API and SPI commands to examine the containers on the current channel. You cannot issue a SOAP fault or update any of the containers. CICS ignores any return code specified in register 15 after the global user exit program has finished. Exit-specific parameters UEPTRANID Address of the 4-byte transaction ID. This is the transaction ID under which the exit, or task, is running. UEPUSER Address of the 8-byte user ID. The user ID will be the one associated with the transaction ID. UEPTERM Address of the 4-byte terminal ID. The value will be null for a Web service provider. UEPPROG Address of the 8-byte application program name. The application program name is that of the application handler DFHPITP. UEPCHANN Address of a 16-byte field that contains the name of the current channel. You can identify the channel explicitly using this parameter. UEPCONTR Address of a 16-byte field that contains the name of the data container on the channel named by UEPCHANN. This container holds the application data structure. UEPAPAB A 1-byte field indicating if the Web service provider application completed its processing successfully. Valid values are as follows: UEPAPABY (X'80') The Web service provider application abended. UEPAPABN (X'40') The Web service provider application completed its processing successfully. UEPAPSF A 1-byte field indicating if the Web service provider application set a SOAP fault. Valid values are as follows: UEPAPSFY (X'80') The Web service provider application is returning a SOAP fault. UEPAPSFN (X'40') The Web service provider application is not returning a SOAP fault. Return codes UERCNORM Continue processing. API and SPI commands The following commands are supported: . EXEC CICS ABEND . EXEC CICS ADDRESS . EXEC CICS ASKTIME . EXEC CICS ASSIGN . EXEC CICS FORMATTIME . EXEC CICS GET CONTAINER . EXEC CICS HANDLE ABEND . EXEC CICS INQUIRE WEBSERVICE . EXEC CICS WRITE FILE . EXEC CICS WRITEQ TD . EXEC CICS WRITEQ TS" ...and after 'The MRO and APPC session queue management sample exit program' to add a new section called 'The pipeline sample exit program' as follows:- "The pipeline sample exit program The DFH$PIEX sample global user exit program provides sample processing for the XWSPRROO global user exit. If you enable this sample program, it is invoked in a Web service provider pipeline after the Web service provider application has finished processing and returned to CICS, but before CICS creates the response message SOAP body. The sample program retrieves the name of the Web service, the name of the transaction, and all of the attributes of the Web service." The CICS Transaction Server for z/OS Web Services Guide Version 3 Release 2 SC34-6838-00 has been changed to add a new section after 'Message handlers' called 'Customizing pipeline processing' as follows:- "In addition to providing your own message handlers, you can also use a global user exit point to customize the processing of provider mode pipelines. You must understand the best practices for writing global user exit programs before customizing the pipeline. You must be using the DFHPITP application handler in your pipeline to use the global user exit point. 1. Use the DFH$PIEX sample exit program to write your own global user exit program. DFH$PIEX is in the SDFHSAMP library. You are recommended to make the program threadsafe. 2. Enable the global user exit program. 3. Test your global user exit program to ensure it works correctly. Use the XWSPRROO exit to access containers on the current channel after the Web services provider application issues the Web service response message and before CICS creates the body of the response message." The CICS Transaction Server for z/OS Trace Entries Version 3 Release 2 SC34-6828-01 manual has been changed to add a new entry after 'PI 1012' as follows:- "PI 1013 DFHPITL PI Exc XWSPRROO GLUE error 1 PITL parameter list" The CICS Transaction Server for z/OS Application Programming Reference Version 3 Release 2 SC34-6819-00 has been changed to add a new RESP2 value of 3 associated with CHANNELERR condition for these commands as follows:- MOVE CONTAINER (CHANNEL): "CHANNELERR 3 Either the current channel or the channel specified on the CHANNEL option is read-only" PUT CONTAINER (CHANNEL): "CHANNELERR 3 Either the current channel or the channel specified on the CHANNEL option is read-only" SOAPFAULT DELETE: "CHANNELERR 3 The channel where this SOAPFAULT object is being deleted is read-only." SOAPFAULT ADD: "CHANNELERR 3 The channel where this SOAPFAULT object is being added is read-only." SOAPFAULT CREATE: "CHANNELERR 3 The channel where this SOAPFAULT object is being created is read-only." The CICS Transaction Server for z/OS Version 3 Release 2 Supplementary Data Areas manual, GC34-6864-00, section 'PIDCC Pipeline Manager Control Blocks' has been altered. Fields have been added to the end of the PI Domain anchor block (the PIA), after field PIA_PITCR_COUNT, as follows: (4E0) FULLWORD 4 PIA_PITCR_COUNT use count dfhpitcr (4E4) CHARACTER 1 PIA_USER_EXIT_STATUS Global user exits 1... .... PIA_XWSPRROO_ACTIVE XWSPRROO is active .1.. .... PIA_XRSINDI_ACTIVE XRSINDI is active ..11 1111 * reserved (4E5) CHARACTER 3 * filler (4E8) CHARACTER 0 *
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
**** PE08/01/30 FIX IN ERROR. SEE APAR PK60040 FOR DESCRIPTION
APAR Information
APAR number
PK56097
Reported component name
CICSTS V3 Z/OS
Reported component ID
5655M1500
Reported release
500
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2007-11-07
Closed date
2008-01-17
Last modified date
2008-04-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
PK56098 UK33060
Modules/Macros
DESABAB DESAPRC DESBRFM DESEIPI DESEITBA DESLI1 DESPGCH DESPGCOX DESPGCP DESPGCR DESPGDC DESPGDUF DESPGEX DESPICC DESPIDC DESPIDM DESPIDUF DESPIII DESPIIS DESPIPM DESPIRE DESPIRM DESPIRS DESPISF DESPISN DESPITL DESPITQ DESPITRI DESPIUE DESWSATH DESWSATX DFH$PIEX DFH$STTB DFHABAB DFHABABA DFHABABM DFHABABT DFHAITM DFHAPEX DFHAPLI1 DFHAPLJ1 DFHAPLX1 DFHAPPG DFHAPRC DFHAPTRC DFHBRBFB DFHBRBSB DFHBRFM DFHBRFMA DFHBRFMM DFHBRFMT DFHEIBAM DFHEIPI DFHERM DFHEXITP DFHPGCH DFHPGCHA DFHPGCHI DFHPGCHM DFHPGCHT DFHPGCON DFHPGCP DFHPGCPA DFHPGCPI DFHPGCPM DFHPGCPT DFHPGCR DFHPGCRA DFHPGCRI DFHPGCRM DFHPGCRT DFHPGDCC DFHPGDCD DFHPGDUF DFHPGEX DFHPGEXA DFHPGEXI DFHPGEXM DFHPGEXT DFHPIAP DFHPICC DFHPICCA DFHPICCM DFHPICCT DFHPIDCC DFHPIDCD DFHPIDM DFHPIDUF DFHPIII DFHPIIIA DFHPIIIM DFHPIIIT DFHPIISC DFHPIISI DFHPIPM DFHPIPMA DFHPIPMM DFHPIPMT DFHPIRE DFHPIREA DFHPIREM DFHPIRET DFHPIRM DFHPIRS DFHPISF DFHPISFA DFHPISFC DFHPISFD DFHPISFM DFHPISFT DFHPISN DFHPISNA DFHPISNC DFHPISND DFHPISNM DFHPISNT DFHPISN1 DFHPISN2 DFHPITL DFHPITLA DFHPITLM DFHPITLT DFHPITP DFHPITQ DFHPITQ1 DFHPITRI DFHPIUCC DFHPIUCD DFHPIUE DFHSIC1 DFHSUEX DFHUEH DFHUEHC DFHUEIQ DFHUEM DFHUEXIT DFHWSATH DFHWSATX HCI6500J
SC34681401 | SC34683800 | SC34682801 | SC34681900 | GC34686400 |
Fix information
Fixed component name
CICSTS V3 Z/OS
Fixed component ID
5655M1500
Applicable component levels
R500 PSY UK33060
UP08/01/29 P F801
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"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"3.2","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"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":"3.2","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
02 April 2008