FAILMESSAGE

FAILMESSAGE [( tag )]

tagA string constant defining the name of XML tag containing the text to return, typically extra information returned by SOAPCALL. If omitted, the default is 'text.'

The FAILMESSAGE function returns the last failure message for use in the FAILURE workflow service or the TRANSFORM structure referenced in the ONFAIL option of SOAPCALL.

Example:

SPeople := SORT(Person,Person.per_first_name);
nUniques := COUNT(DEDUP(sPeople,Person.per_first_name ANDPerson.address))
:FAILURE(Email.simpleSend(SystemsPersonnel,
        SystemsPersonel.email,FAILMESSAGE));

See Also: RECOVERY, FAILCODE, SOAPCALL