A fix is available
APAR status
Closed as program error.
Error description
The new z/VSE SOAP support, that was introduced in z/VSE 5.2 and now supports literal encoding style, does not correctly handle complex copybooks with REDEFINES and OCCURS clauses. The result is that fields are mapped to a wrong location in the commarea. This affects z/VSE as SOAP server as well as z/VSE as SOAP client.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All z/VSE SOAP Engine Users that are using * * the new SOAP support with literal support. * **************************************************************** * PROBLEM DESCRIPTION: The new z/VSE SOAP support, that was * * introduced in z/VSE 5.2 and now sup- * * ports literal encoding style, does not * * correctly handle complex copybooks * * with REDEFINES and OCCURS clauses. The * * result is that fields are mapped to a * * wrong location in the commarea. This * * affects z/VSE as SOAP server as well * * as z/VSE as SOAP client. * **************************************************************** * RECOMMENDATION: Install this PTF. * **************************************************************** The new z/VSE SOAP support, that was introduced in z/VSE 5.2 and now supports literal encoding style, does not correctly handle complex copybooks with REDEFINES and OCCURS clauses. The result is that fields are mapped to a wrong location in the commarea. This affects z/VSE as SOAP server as well as z/VSE as SOAP client.
Problem conclusion
The code has been corrected to now handle complex copybooks correctly. For users of the 'new' z/VSE SOAP support (with literal style support): After applying this PTF you MUST also update the CICS2WS tool to version 2.7.0 (or later). The latest CICS2WS tool version can be downloaded here: http://www-03.ibm.com/systems/z/os/zvse/downloads/#cics2ws You MUST then re-generate any existing RULES with the new CICS2WS tool version of 2.7.0 (or later), assemble them on z/VSE and perform a NEWCOPY on them in CICS. The z/VSE SOAP Engine will only accept RULES generated with a CICS2WS tool version of 2.7.0 (or later). Note: Users of the 'old' SOAP support using generated PROXY code are not affected and do not need to update the CICS2WS version. However the new CICS2WS version will also work with the 'old' SOAP support. You should also apply the PTF for APAR PI49304. This PTF will ensure that the affected programs are properly defined in CICS. Alternatively you can define the programs using DFHCSDUP as follows: Define Program(IESOACLN) Group(VSESPG) Language(C) Datalocation(ANY) Resident(NO) Execkey(CICS) Reload(NO) Description(SOAP V2 CLIENT) Define Program(IESOASRV) Group(VSESPG) Language(C) Datalocation(ANY) Resident(NO) Execkey(USER) Reload(NO) Description(SOAP V2 Server) Define Program(IESCNVRM) Group(VSESPG) Language(C) Datalocation(ANY) Resident(NO) Execkey(USER) Reload(NO) Description(SOAP V2 DATA TYPES CONVERTOR) Define Program(IESXPTHM) Group(VSESPG) Language(C) Datalocation(ANY) Resident(NO) Execkey(USER) Reload(NO) Description(XPATH SUPPORT)
Temporary fix
Comments
APAR Information
APAR number
PI49037
Reported component name
VSE CONNECTOR S
Reported component ID
5686CF935
Reported release
52N
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2015-09-18
Closed date
2015-10-08
Last modified date
2016-02-01
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
Modules/Macros
IESCNVRH IESCNVRI IESCNVRM IESCNVRT IESOACLN IESOASCH IESOASCP IESOASRV IESOAUTH IESOAUTI IESOAUTL IESXPATH IESXPTHH IESXPTHI IESXPTHM
Fix information
Fixed component name
VSE CONNECTOR S
Fixed component ID
5686CF935
Applicable component levels
R52N PSY UI31866
UP16/02/01 I 1000
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":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG32M","label":"APARs - VSE\/ESA environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"52N","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
01 February 2016