SET-ROLE( ) method

(SOAP 1.2 only)

Sets the ROLE attribute for a SOAP header entry.

Return type:

LOGICAL

Applies to:

SOAP-header-entryref object handle

 

Syntax 

SET-ROLE ( character )

character

A character variable that specifies the URI of a SOAP role. The role can be used to indicate the recipient of a SOAP header element.

Call this method once you have associated the XML with a SOAP header entry using the SET-NODE( ) method.

Note:

In SOAP Version 1.2, the SET-ROLE method replaces the SOAP Version 1.1 SET-ACTOR method. A runtime error occurs if the AVM sends a ROLE attribute in a SOAP header to a SOAP Version 1.1 Web service.