WSDL2ELSSpec

Edit online

Use this element of the ServiceSpecification.xml document to specify options for generating the artifacts that implement a service description in a top-down scenario.

Contained by

ServiceImplementationSpec

Contains

None

Attributes

Table 1 shows the attributes for WSDL2ELSSpec.

Table 1. Attribute specifications for WSDL2ELSSpec
Fields	Description
Attribute: defaultCharMaxLength Valid PL/I values: n where 1 <= n <= (2¹⁵ – 1) Valid COBOL values: n where 1 <= n <= (2²⁷ – 1) Required?: No Default PL/I value: n = 256 Default COBOL value: n = 256	Specifies a value that is applied when elementary language structure members are generated for XSD element and attribute declarations of the following types: xsd:string xsd:simpleType having xsd:string as its base type but omitting the length or maxLength constraining facets.
Attribute: defaultBase64BinaryLength Valid PL/I values: where 1 <= n <= (2³⁰ – 1) Valid COBOL values: None (not supported Required?: No Default PL/I value: n = 256 Default COBOL value: None (not supported)	Specifies a value that is applied when elementary language structure members are generated for XSD element and attribute declarations of the following types: * xsd:base64Binary * xsd:simpleType having xsd:base64Binary as its base type but omitting the length or maxLength constraining facets.
Attribute: defaultTotalDigits Valid PL/I values: n where 1 <= n <= 31 Valid COBOL values: n where 1 <= n <= 31 Required?: No Default PL/I value: n=31 Default COBOL value: n=31	Specifies a value that is applied when elementary language structure members are generated for XSD element and attribute declarations of the following types: xsd:decimal xsd:integer xsd:simpleType having either xsd:decimal or xsd:integer as its base type but omitting the totalDigits constraining facet.
Attribute: defaultFractionDigits Valid PL/I values: n where 0 <= n <= 31 Valid COBOL values: n where 0 <= n <= 31 Required?: No Default PL/I value: n = 6 Default COBOL value: n = 6	Specifies a value that is applied when elementary language structure members are generated for XSD element and attribute declarations of the following types: xsd:decimal xsd:simpleType having xsd:string as its base type but omitting the fractionDigits constraining facet.
Attribute: defaultDateTimeLength Valid PL/I values: n where 1 <= n <= (2¹⁵ – 1) Valid COBOL values: n where 1 <= n <= (2²⁷ – 1) Required?: No Default PL/I value: n = 64 Default COBOL value: n = 64	Specifies a value that is applied when elementary language structure members are generated for XSD element and attribute declarations of the following types: xsd:date, xsd:dateTime, xsd:duration, xsd:gDay, xsd:gMonth, xsd:gMonthDay, xsd:gYear, xsd:gYearMonth, and xsd:time. xsd:simpleType having one of the preceding types as its base type but omitting the length or maxLength constraining facets.
Attribute: suppressStructureComments Valid values: true \| false Required?: No Default value: False	Specify whether or not WSDL2ELS should suppress generation of leading and inline comments when generating language structures in the WSDL2PLI and WSDL2COBOL scenarios. This option does not affect the documentation that is generated at the beginning of the language file.
Attribute: suppressPresenceFields Valid PL/I values: None (not supported) Valid COBOL values: true \| false Required?: No Default PL/I value: None (not supported) Default COBOL value: False	Specify whether or not WSDL2ELS should suppress generation of @PRESENCE fields (suffixes -bit, _bit) for XML elements or XML attributes when generating language structures. Note: This option is not supported in the WSDL2PLI scenario.
Attribute: suppressCountFields Valid PL/I values: None (not supported) Valid COBOL values: true \| false Required?: No Default PL/I value: None (not supported) Default COBOL value: False	Specify whether or not WSDL2ELS should suppress generation of @COUNT fields (suffixes -cnt, _cnt) for XML element arrays when generating language structures. Note: This option is not supported in the WSDL2PLI scenario.
Attribute: fileContainer Valid values: See Description. Required?: Yes Default value: None	Specifies the relative path of the file container that contains the generated files. This path is relative to the project that is specified in EISProject/@name. For example, the fileContainer "generated", as used in the example below, specifies a directory at the top level of the project specified in EISProject/@name. If the directory does not exist it is created. If the directory exists its contents are overwritten.
Attribute: inlineStringLengthLimit Valid PL/I values: n where 0 <= n <= 32767 Valid COBOL values: None (not supported) Required?: No Default PL/I value: n = 32767 Default COBOL value: None (not supported)	Specifies a value that establishes a limit on the length of XSD element and attribute declarations of type “xsd:string” that are eligible to be mapped inline. XSD elements or attributes that exceed the limit will be mapped out-of-line using a language-specific mechanism if and only if an out-of-line mapping has the potential to occupy fewer bytes than an inline mapping. This attribute interacts with attribute defaultCharMaxLength, which provides the default length of XSD element or attribute declarations of type “xsd:string” that do not specify the length or maxLength facets. Note: The default PL/I value of 32767 effectively disables out-of-line mappings as this is the maximum length in bytes of PL/I CHAR or WCHAR variables. Note: This attribute is not supported in the WSDL2COBOL scenario.
Attribute: inlineMaxOccursLimit Valid PL/I values: n where 1 <= n <= (2³¹ – 1) Valid COBOL values: None (not supported) Required?: No Default PL/I value: n=20 Default COBOL value: None (not supported)	Specifies a value that is applied when language structure members are generated for XSD element declarations that specify the minOccurs and maxOccurs facets. If an XML element specifies a minOccurs or maxOccurs facet value that is greater than the value of this attribute, the array that is generated in the language structure will have a upper bound that is determined at execution time (for example, by using REFER in PL/I).
Attribute: defaultMaxOccursLimit Valid PL/I values: None (not applicable) Valid COBOL values: n where 1 <= n <= (2²⁷ – 1) Required?: No Default PL/I value: None (not applicable) Default COBOL value: n=20	Specifies a value that is applied when language structure members are generated for XSD element declarations that specify the maxOccurs facet. If an XML element specifies a maxOccurs facet value that is unbounded or exceeds the value of this attribute, the upper bound of the array that is generated in the language structure will be equal to the value of this attribute. Note: This option is not supported in the WSDL2PLI scenario.
Attribute: languageFileName Valid values: See Description. Required?: Yes Default value: None	Specifies the file name of the generated file into which language structures are written. If the file does not exist it is created. If the file exists it is overwritten.
Attribute: languageNameLimit Valid PL/I values: n where 1 <= n <= 100 Valid COBOL values: n where 1 <= n <= 30 Required?: No Default PL/I value: n=100 Default COBOL value: n=30	Specifies a value that is applied when names are derived for language structures and language structure members from the names of corresponding XSD element and attribute declarations. For PL/I, if the value of this attribute is greater than 31 then generated language structures must be compiled with the option “LIMITS(NAME(n))”, where 31 < n <= 100.
Attribute: logFileName Valid values: See Description. Required?: Yes Default value: None	Specifies the file name of the file into which log information is written. If the file does not exist it is created. If the file exists it is overwritten.
Attribute: mappingDirectory Valid values: See Description. Required?: Yes Default value: None	Specifies the relative path of the directory in which the metadata file is created. This path is relative to the path that is specified in @fileContainer. If the directory does not exist it is created. If the directory exists its contents are overwritten.
Attribute: metadataFileName Valid values: See Description. Required?: Yes Default value: None	Specifies the file name of the file into which WSDL2ELS metadata is written. If the file does not exist it is created. If the file exists it is overwritten.

Example

<WSDL2ELSSpec 
    defaultCharMaxLength="256"
    defaultBase64BinaryLength="256"
    defaultTotalDigits="31" 
    defaultFractionDigits="6"
    defaultDateTimeLength="64"
    inlineMaxOccursLimit="20"
    languageNameLimit="31"
    fileContainer="/generated"
    languageFileName="MYAPP.inc"
    logFileName="MYAPP.log"
    mappingDirectory="metadata/mapping"
    metadataFileName="MYAPP_metadata.xml" />