`xsl:message`

Writes a message to the log.

Syntax

<xsl:message terminate="terminate"
             dp:type="category"
             dp:priority="level"
             dp:id="{message_id}">
  <dp:with-param value="message_text"/>
</xsl:message>

Parameters

terminate="terminate"

Indicates whether to stop or to continue processing after the message is written to the log. The default value is no.

yes: Stops processing after the message is written to the log.
no: Continues processing after the message is written to the log.

dp:type="category"

Specifies the category to assign to the message. See dmLogClass in the store:///xml-mgmt.xsd schema.

dp:priority="level"

Specifies the level to assign to the message. Specify one of the following keywords.

alert
critic
error
warn
notice
info
debug

dp:id="{message_id}"

Specifies the name identifier for the message in the message catalog. For XSL stylesheets, the value is $DPLOG_XSLT_USER_CUSTOM and requires that your stylesheet includes the <xsl:include href="store:///dp/msgcat/xslt.xml.xsl"> declaration.

Example

Sample stylesheet to use the custom message that includes Time to quiesce handler as the message text in the log.

<xsl:stylesheet version="1.0"
    xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
    xmlns:dp="http://www.datapower.com/extensions"
    extension-element-prefixes="dp">
  <xsl:include href="store:///dp/msgcat/xslt.xml.xsl"/>
  <xsl:output omit-xml-declaration="yes" />

  <xsl:template match="/">
    <xsl:value-of select="$DPLOG_XSLT_USER_CUSTOM"/>
    <xsl:message dp:priority="error" dp:id="{$DPLOG_XSLT_USER_CUSTOM}">
      <dp:with-param value="Time to quiesce handler."/>
    </xsl:message>
  </xsl:template>

</xsl:stylesheet>