diff --git a/src/reference/docbook/jms.xml b/src/reference/docbook/jms.xml
index c2e196520d..0e9b2d0c05 100644
--- a/src/reference/docbook/jms.xml
+++ b/src/reference/docbook/jms.xml
@@ -324,7 +324,41 @@
connection-factory="customConnectionFactory"/>]]>
-
+
+ Using JMS Message Selectors
+
+ With JMS message selectors you can filter JMS Messages
+ based on JMS headers as well as JMS properties. For example,
+ if you want to listen to messages whose custom JMS header
+ property fooHeaderProperty equals
+ bar, you can specify the following expression:
+
+
+
+ Message selector expressions are a subset of the SQL-92
+ conditional expression syntax, and are defined as part of the
+ Java Message Service
+ specification (Version 1.1 April 12, 2002). Specifically, please see
+ chapter "3.8 Message Selection". It contains a detailed explanation of the
+ expressions syntax.
+
+
+ You can specify the JMS message selector attribute
+ using XML Namespace configuration for the following Spring Integration
+ JMS components:
+
+
+ JMS Channel
+ JMS Publish Subscribe Channel
+ JMS Inbound Channel Adapter
+ JMS Inbound Gateway
+ JMS Message-driven Channel Adapter
+
+
+ It is important to remember that you cannot reference message body values
+ using JMS Message selectors.
+
+