A fix is available
APAR status
Closed as unreproducible in next release.
Error description
WSBind enhancements This APAR also corrects an error in the length field of the WSBIND file, as follows: SYMTPM: Unexpected Exception: Incorrect WSBind file length in readWSBindFile The length field that's embedded in the WSBIND file is incorrectly being processed as a string instead of a binary value.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICS Users. * **************************************************************** * PROBLEM DESCRIPTION: This APAR provides improvements to * * data mappings for CICS Web services. * **************************************************************** * RECOMMENDATION: * **************************************************************** This APAR provides the following enhancements to CICS Web Services: 1. Support for xsd:any and xds:anyType tags 2. A new XML-ONLY parameter for DFHWS2LS to provide support for Web service applications that process the XML themselves. 3. Provision a DFHWS-WSDL-CTX container to contain context information from the WSDL document. 4. New COLLAPSE and BINARY options on the CHAR-VARYING parameter of DFHLS2WS. 5. A new WSDL-NAMESPACE parameter for DFHLS2WS to specify the namespace for CICS to use in the generated WSDL document. 6. A new INLINE-MAXOCCURS-LIMIT parameter for DFHWS2LS, to specify whether variably repeating content is mapped inline or mapped to a separate container. 7. DFHLS2WS support for the 'Z' character in COBOL picture clauses (at any mapping level). 8. DFHLS2WS will suppress FILLER fields in COBOL and '*' fields in PL/I. A new runtime level of 2.1 is provided and must be used to take advantage of the new function. The runtime level is specified via the MINIMUM-RUNTIME-LEVEL parameter on both DFHWS2LS and DFHLS2WS.
Problem conclusion
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
Support for the enhancements to Web Services has been implemented. The CICS Transaction Server for z/OS Release Guide Version 3 Release 2, GC34-6811-01, has been updated as follows: Improved data mappings for Web services --------------------------------------- Improvements have been made to the Web services bind mappings which includes mapping level 2.1 and new parameters on the Web services assistant. Use mapping level 2.1 with a CICS TS 3.2 region that has APAR PK59794 applied, or any region above CICS TS 3.2 to take advantage of these improvements to the Web services assistant: - A new runtime level of 2.1 has been added to the MINIMUM-RUNTIME-LEVEL parameter on both DFHWS2LS and DFHLS2WS. DFHLS2WS includes new options on the CHAR-VARYING parameter. - The COLLAPSE option reduces the amount of white space in SOAP messages by omitting trailing white space at the end of text fields. The BINARY option causes character strings to be treated as binary data rather than text data. - DFHLS2WS includes new parameter WSDL-NAMESPACE. Use the WSDL-NAMESPACE parameter to specify the namespace for CICS to use in the generated WSDL document. - DFHLS2WS supports the 'Z' character in COBOL picture clauses. This support is included at all mapping levels. - DFHWS2LS includes the new parameter INLINE-MAXOCCURS-LIMIT. Use the INLINE-MAXOCCURS-LIMIT parameter to specify whether variably repeating content is mapped inline or mapped to a separate container. - DFHWS2LS includes the new parameter XML-ONLY. Use the XML-ONLY parameter to write Web service applications that process the XML themselves. - DFHWS2LS supports the <xsd:any> and xsd:anyType elements at mapping level 2.1 and above. - DFHLS2WS suppresses FILLER fields in COBOL and '*' fields in PL/I at mapping level 2.1 and above. The fields do not appear in the generated WSDL and an appropriate gap is left in the data structures at run time. - Container DFHWS-WSDL-CTX has been added to the pipeline. Use the DFHWS-WSDL-CTX container to query context information from the WSDL document. ---------------------------------------------------------- CICS Transaction Server for z/OS Messages and Codes Version 3 Release 2, GC34-6827-01 has been updated as follows: DFHPI1008 DATE TIME APPLID TRANNUM SOAP message generation failed because of incorrect input ( {ARRAY_CONTAINER_TOO_SMALL | INPUT_STRUCTURE_TOO_SMALL | INPUT_ARRAY_TOO_LARGE | INPUT_ARRAY_TOO_SMALL | CONTAINER_NOT_FOUND | CONTAINER_NOT_BIT | CONTAINER_NOT_CHAR} ERROR_QUALIFIER ). EXPLANATION: CICS has failed to generate a SOAP message due to a problem with the data received from the CICS application. An error_qualifier may be provided to help identify the source of the problem. In some cases the error_qualifier will be empty. The possible error codes and qualifiers associated with this message are: ARRAY_CONTAINER_TOO_SMALL ARRAY_NAME A CICS container does not hold sufficent data given the number of instances of the data expected and the length of one instance of the data. INPUT_STRUCTURE_TOO_SMALL The container passed to CICS does not hold sufficent data given the length of the language structure. INPUT_ARRAY_TOO_LARGE ARRAY_NAME Too many instances of a structure have been supplied in a container given the maximum value specified in the WSDL. INPUT_ARRAY_TOO_SMALL ARRAY_NAME Too few instances of a structure have been supplied in a container given the minimum value specified in the WSDL. CONTAINER_NOT_FOUND CONTAINER_NAME A container named in the input structure cannot be found. CONTAINER_NOT_BIT CONTAINER_NAME A container named in the input structure exists but is of the wrong type. The container must be created in BIT mode rather than CHAR mode. CONTAINER_NOT_CHAR CONTAINER_NAME A container named in the input structure exists but is of the wrong type. The container must be created in CHAR mode rather than BIT mode. SYSTEM ACTION: The XML conversion process halts. If CICS is acting as the Web service provider then the task is terminated with an APIG abend. If CICS is the Web service requester then a response code of INVREQ is returned to the caller of the INVOKE WEBSERVICE API with, in most cases, a resp2 code of 14. An exception entry is written to the trace table. USER RESPONSE: Examine the exception trace entry for further information. Correct the CICS application to ensure that the data presented to CICS is appropriate to be converted into a SOAP message. DESTINATION: CPIO MODULE: DFHPIII XMEOUT PARAMETERS: date, time, applid, trannum, {1=ARRAY_CONTAINER_TOO_SMALL, 2=INPUT_STRUCTURE_TOO_SMALL, 3=INPUT_ARRAY_TOO_LARGE, 4=INPUT_ARRAY_TOO_SMALL, 5=CONTAINER_NOT_FOUND, 6=CONTAINER_NOT_BIT, 7=CONTAINER_NOT_CHAR}, error_qualifieremv. Other messages have also been updated. Please see the latest version of the manual for details. ---------------------------------------------------------- CICS Transaction Server for z/OS Supplementary Data Areas Version 3 Release 2, GC34-6864-00, has been altered in section 'PIDCC Pipeline Manager Control Blocks' to add new fields pi_wsr_xml_only, pi_wsr_wsbind_ver_2_1, pi_wsr_op_namespace and pi_wsr_ns_and_port to the pi_wsresource control block as follows: (12B) CHARACTER 1 PI_WSR_FLAGS flags byte 1... .... PI_WSR_XOP_SUPPORTED direct mode XOP supported .1.. .... PI_WSR_IGNORED_BIT Unpredictable content ..1. .... PI_WSR_SYNCPOINT_SET Syncpoint allowed ...1 .... PI_WSR_XML_ONLY No conversions required .... 1111 * (570) CHARACTER 776 PI_WSR_WSBIND_VER_2_1 (570) FULLWORD 4 * CCSID (574) UNSIGNED 1 * WSDL and SOAP flags (575) CHARACTER 255 * WSBind file name (674) CHARACTER 255 PI_WSR_OP_NAMESPACE Operations namespace (773) CHARACTER 255 PI_WSR_NS_AND_PORT WSDL port name and ns ---------------------------------------------------------- The following manuals have also been updated. The updates will appear in the next refresh of the infocenter: CICS Transaction Server for z/OS Web Services Guide Version 3 Release 2, SC34-6838-00. The CICS Transaction Server for z/OS Application Programming Reference Version 3 Release 2, SC34-6819-01. CICS Transaction Server for z/OS System Programming Reference Version 3 Release 2, SC34-6820-01. CICS Transaction Server for z/OS Supplied Transactions Version 3 Release 2, SC34-6817-00.
APAR Information
APAR number
PK59794
Reported component name
CICSTS V3 Z/OS
Reported component ID
5655M1500
Reported release
500
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2008-01-24
Closed date
2008-03-20
Last modified date
2009-08-17
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
PK60661 UK34648 UK34671
Modules/Macros
DESEIPI DESPICC DESPIDC DESPIII DESPIIW DESPITL DESPITRI DESPIWR DFHEIPI DFHMEPIC DFHMEPIE DFHMEPIK DFHPICC DFHPICCA DFHPICCM DFHPICCT DFHPIDCC DFHPIDCD DFHPIII DFHPIIIA DFHPIIIM DFHPIIIT DFHPIIW DFHPIIWA DFHPIIWM DFHPIIWT DFHPISUP DFHPITL DFHPITLA DFHPITLM DFHPITLT DFHPITP DFHPITRI DFHPIWR DFHPIWRA DFHPIWRJ DFHPIWRM DFHPIWRT DFHPIWRV DFH59794 DFJ@H176 DFJ@H223
| SC34683800 | GC34682700 | SC34682001 | SC34681901 | GC34681101 |
| SC34681700 | GC34686400 |
Fix information
Fixed component name
CICSTS V3 Z/OS
Fixed component ID
5655M1500
Applicable component levels
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:
17 August 2009