Rational Developer for System z

Specification of Multiple Request Language Structures

If an enterprise applications' input interface is comprised of multiple language structures, it is necessary to include each of them in the request message that clients will transmit when the application is invoked as a Web service. To direct the Enterprise Service Tools (EST) Batch processor to incorporate multiple language structures into the XML Schema (XSD) for the request message—specify multiple, sibling, InputMessage elements. The order in which the InputMessage elements are specified determines the order that their equivalent XSD definitions appears in the composite request XSD.

To further customize the request XSD, attributes on the InputMessage element can be specified. These attributes are: See InputMessage for the complete description of the InputMessage attributes.

Figure 1 demonstrates how to direct the Enterprise Service Tools Batch processor to incorporate multiple language structures when generating the XSD for the request message of a Web service.

Note: Generation of XML Conversion artifacts is only supported for the IMS SOAP Gateway runtime when multiple language structures are specified.
Figure 1. Example of Specifying Multiple Language Structures for the Request Message
    <Operation name="PutOrderHistory">
      <InputMessage importFile="ORDRSECR.cpy" importDirectory="."
         nativeTypeName="ORDRSECR-PUT-HIST-HEAD"
         xmlEleName="OrderHistoryHeader" lowerBound="1" upperBound="1">
        <ItemSelectionArray>
          <ItemSelection itemName="ORDRSECR-PUT-HIST-HEAD.SECURITY-CODE"/>
          <ItemSelection itemName="ORDRSECR-PUT-HIST-HEAD.CUSTOMER-ID"/>
          <ItemSelection itemName="ORDRSECR-PUT-HIST-HEAD.CUSTOMER-FIRSTNAME"/>
          <ItemSelection itemName="ORDRSECR-PUT-HIST-HEAD.CUSTOMER-LASTNAME"/>
        </ItemSelectionArray>
      </InputMessage>


      <InputMessage importFile="ORDRRECS.cpy" importDirectory="." 
         nativeTypeName="ORDRRECS-HIST-RECORD"
         xmlEleName="OrderHistoryRecord" lowerBound="1" upperBound="255">
        <ItemSelectionArray>
          <ItemSelection itemName="ORDRRECS-HIST-RECORD.ORDER-DATE"/>
          <ItemSelection itemName="ORDRRECS-HIST-RECORD.ORDER-ITEM-ID"/>
          <ItemSelection itemName="ORDRRECS-HIST-RECORD.ORDER-ITEM-PRICE"/>
          <ItemSelection itemName="ORDRRECS-HIST-RECORD.ORDER-ITEM-QTY"/>
          <ItemSelection itemName="ORDRRECS-HIST-RECORD.ORDER-ITEM-DESC"/>
        </ItemSelectionArray>
      </InputMessage>
      <OutputMessage ../>
      <XseSpec>
        <XsdSpecIn xsdEleName="PutOrderHistoryRequest"
                   targetNamespace="http://www.ibm.com/schemas/weborders"
                   fileName="PutOrderHistory.xsd"/>
        <XsdSpecOut  ../>
      </XseSpec>
    </Operation>

Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)