Start of change

Mapping levels for the CICS Web services assistant

A mapping is the set of rules used to determine how information is converted between language structures and the Web service description (WSDL) document.

When you run the Web services assistant jobs DFHWS2LS and DFHLS2WS, you can use the MAPPING-LEVEL parameter to set a level of mapping that can map language structures and elements in WSDL documents with increasing levels of sophistication.

Mapping levels 1.0 and 1.1 are available when you apply APAR PK15904. Mapping level 1.2 is available when you apply APAR PK23547. Each level of mapping inherits the functionality of the previous mapping, with the highest level of mapping offering the best capabilities available. This includes providing you with more control over how data should be converted at run time, as well as lifting restrictions on support for certain data types and XML elements. These restrictions are explained in High level language and XML schema mapping for each supported high level language.

Mapping level 1.0

This is the default mapping level. This ensures that you can regenerate your older Web service binding files with a newer level of the Web services assistant without having to make application changes. It is provided for backwards compatibility and should not be used for new applications.

In the default mapping:

Mapping level 1.1

At this level of mapping there are improvements to DFHWS2LS when mapping XML character and binary data types, in particular when mapping data of variable length. This is where maxLength and minLength attributes are defined with different values in the XML schema. Data is handled in the following ways:

Mapping level 1.2

At this level of mapping you can use additional parameters in DFHWS2LS and DFHLS2WS to control how character and binary data is transformed at run time. If you decide to use the CHAR-MULTIPLIER parameter in DFHWS2LS, be aware that the rules below apply after the value of this parameter is used to calculate the amount of space required for character data. If you have character data types in the XML schema that do not have a length associated with them, you can assign a default length using the DEFAULT-CHAR-MAXLENGTH parameter in DFHWS2LS.
End of change