C-LANG Statements › RETURNNAMESPACE Statement—Specify an XML Namespace

RETURNNAMESPACE Statement—Specify an XML Namespace

The RETURNNAMESPACE statement specifies the XML namespace for the RETURNXML statement in a Web Service job. If you omit this statement, the return namespace defaults to the target namespace specified by the TARGETNAMESPACE statement.

Supported Job Type

This statement is optional for the Web Service job type.

Syntax

This statement has the following format:

RETURNNAMESPACE return_namespace

return_namespace

Specifies the XML namespace for the XML type that maps to the Java class name of the return value.

Limits: Up to 256 characters; case-sensitive

Note: Enclose values that contain delimiters (such as spaces) in double quotation marks.

Example: Specify Return Namespace for the XML Type of Stock Quote

Suppose that you want to invoke a web service that returns a company stock quote. The URL for the WSDL that describes the web service and its location is http://www.webservicex.com/stockquote.asmx?WSDL. The WSDL port name within the target namespace http://www.webserviceX.NET is StockQuoteSoap. The target endpoint address URL is http://www.webservicex.com/stockquote.asmx. The job calls the operation GetQuote within the StockQuote web service. When the job invokes the web service, the company's stock symbol is passed to the operation. The GetQuote operation returns a java.lang.String object, which maps to the XML type string in the return namespace http://www.webserviceX.NET/. When the job completes, the stock quote for CA is stored as a serialized Java object in the job's spool directory.

AGENT WSAGENT
TARGETNAMESPACE http://www.webserviceX.NET/
SERVICENAME StockQuote
PORTNAME StockQuoteSoap
OPERATION GetQuote
WSDL_URL http://www.webservicex.com/stockquote.asmx?WSDL
ENDPOINT_URL http://www.webservicex.com/stockquote.asmx  
PARAMETER TYPE(xsd:string) VALUE(CA)
RETURNCLASS java.lang.String
RETURNXML string
RETURNNAMESPACE http://www.webserviceX.NET/