Unsubscribe-Queue
Unregisters an event handler that is called by the MOM implementation when a message arrives in a specified queue.
|
|
This webject can be used only after your environment has been set up for queuing tasks.
|
SYNTAX
<ie:webject name=Unsubscribe-Queue type="MSG">
<ie:param name="QUEUE" data="managed_queue_name"/>
<ie:param name="WHERE" data="jms_message_selector"/>
</ie:webject>
PARAMETERS
|
Required
|
Select
|
Optional
|
|
|
GROUP_OUT
|
|
|
QUEUE
|
|
|
WHERE
|
|
|
SERVICE
|
GROUP_OUT
The name of the status group to create upon success. The default behavior for this parameter is to create a group named “unsubscribe-results”. This parameter is optional.
QUEUE
The LDAP distinguished name of an administered queue. The value is an LDAP distinguished name relative to a configured base URI. If relative, the cn= (common name attribute) is implicit if not explicitly specified. The default for this parameter is to use the value specified in the com.infoengine.msg.defaultExecutionQueue property. If there is no such value, then the QUEUE parameter must be specified. This parameter is optional.
WHERE
A properly formatted JMS message selector, as defined in the Sun Java Message Service specification, used to select the queue listener to unsubscribe from the specified queue. The default for this parameter is to unsubscribe the queue listener associated with no message selector. This parameter is optional.
SERVICE
The name of the Info*Engine property set that is configured for connectivity to a specific JMS service. This allows you to configure more than one JMS service per Info*Engine Virtual Machine (VM). This parameter is optional.
EXAMPLE
The following example cancels a subscription listening to the specified queue:
<%@page language="java" session="false"%>
<%@taglib uri="http://www.ptc.com/infoengine/taglib/core"
prefix="ie"%>
<ie:webject name="Unsubscribe-Queue" type="MSG">
<ie:param name="QUEUE" data="$(@FORM[]queue[0])"/>
</ie:webject>
To actually run this example you would need to provide a form where the queue variable is identified.
