SET-ROLE( ) method

(SOAP 1.2 only)

Sets the ROLES 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.