XML Converters tab

Edit online

The XML Converters tab allows you to specify identification attributes and character encodings.

This tab contains the following fields:

  • In the Specify identification attributes group:

    Converter program name prefix:
    Type the stem of the program name that is included in the IDENTIFICATION DIVISION of each generated COBOL program. If you type ACCT, for example, the wizard identifies the input converter program as ACCTI, the output converter program as ACCTO, and the driver as ACCTD.
    Author name:
    Type the value to be included in the AUTHOR paragraph of each generated COBOL program.
    Service program name:
    Type the name of the existing application that you want the Web service to invoke.
  • In the Specify Enterprise COBOL for z/OS properties group:
    Compiler Level:
    Type the value of a specific level of the Enterprise COBOL compiler.
    XMLPARSE option:
    Type the value of the XML parser that is selected for the COBOL XML PARSE statement.

    This option is valid only if Compiler Level is set to 4.1 or higher.

    Optimization
    Select whether the optimization option is enabled for the COBOL compiler. For COBOL compiler versions 4 and earlier, when the checkbox is selected, the COBOL compiler uses optimization in generating runtime code from COBOL source code.

    If you choose to generate COBOL conversion code for compiling with the Enterprise COBOL compiler v 5.2, the generated COBOL program has the following COBOL v 5.2 specific characteristics:

    • If you choose no optimization by clearing the Optimization selection box on the XML Converters tab, the OPTIMIZE (or OPT for short) compiler option is generated as “OPT(0)” unlike COBOL compiler versions 4 and earlier (the no optimization option was generated as NOOPT). You can achieve the same OPT option behavior by using the Batch processor with the code generation option by specifying 
      <CodegenPropertyname="com.ibm.etools.xmlent.ui.GEN_COMPILE_OPTIMIZE"value="false"/>
    • If you choose optimization by selecting the Optimization selection box on the XML Converters tab, the OPTIMIZE compiler option is generated as “OPT(2)” unlike COBOL compiler versions 4 and earlier (there was only one level of optimization and it was specified as OPT). You can achieve the same OPT option behavior by using the Batch processor with the code generation option by specifying 
      <CodegenPropertyname="com.ibm.etools.xmlent.ui.GEN_COMPILE_OPTIMIZE"value="true"/>
      Restriction: There are no options to select intermediate optimization levels that are provided by the COBOL v 5.2 compiler. COBOL v 5.2 compiler optimization levels other than OPT(0) and OPT(2) are not supported.

  • In the Specify character encodings group:

    Request code page
    Select the code page for encoding the XML input message.
    Note:
    • In the Web Services for CICS® runtime environment, when compiled conversion is selected, CICS performs the conversion of the text between the code page used by the Web service client and the code page used by the Web service.
    • In the other runtime environments, when compiled conversion is used, the Web service client is responsible for the conversion between its own code page and the code page used by the Web service.
    Host code page
    Select the code page for the z/OS® host system.
    Response code page
    Select the code page for encoding the XML output message. For One-way this is disabled.
    Note:
    • In the Web Services for CICS runtime environment, when compiled conversion is selected, CICS performs the conversion of the text between the code page used by the Web service client and the code page used by the Web service.
    • In the other runtime environments, when compiled conversion is used, the Web service client is responsible for the conversion between its own code page and the code page used by the Web service.
    Use the host code page as the intermediate encoding for XML
    Selecting this option can significantly improve Compiled XML Conversion performance on SBCS EBCDIC hosts. This option is enabled by default when the host code page is EBCDIC SBCS. Clear this checkbox only if the names of mapped XML elements or attributes contain characters that do not exist in the host code page.