Returns the next header key in a SOAP request header.

Syntax

NEXT_SOAP_HEADER( header-key )

Parameters

header-key   The XML local name of the top level XML element for the given header entry.

Returns

LONG VARCHAR

Remarks

If you specify NULL for the header-key, the function returns the header key for the first header entry found in the SOAP header.

This function returns NULL if called with the last header-key.

See also

• -xs server option
• Working with SOAP headers
• SQL Anywhere web services
• SOAP_HEADER function [SOAP]
• Web services functions
• Web services system procedures

Standards and compatibility

Example

When used within a stored procedure that is called by an HTTP web service, the following statement returns the first header key found in the SOAP header.

SET header_key = NEXT_SOAP_HEADER( NULL );