createLMServiceEventPoint command

Use the createLMServiceEventPoint command to create an event point on a local mapping service in preparation for monitoring service requests.

Target object

None

Required parameters

lmService
The name of the associated local mapping service.
ConnectionFactory
the JNDI name of the JMS Connection Factory.

Optional parameters

mustSend
Indicates that the service request is canceled if event publishing fails. The default is set to true.

If this parameter value is set to true and the event cannot be sent, then the service request is canceled. If this parameter value is set to false and the event cannot be sent, then the service request continues, but no event is sent.

sendAtCommit
Controls whether the event is sent under a current global transaction, or outside the scope of any transaction. The default is set to false.

If this parameter value is set to true and global transaction applies then the event is sent at the time global transaction commits.

If this parameter value is set to true and global transaction does not apply, then the event is sent immediately.

If this parameter value is set to false then the event is sent immediately.

eventData
This parameter controls the data content of the generated event. The default is set to NONE.

Message data included in generated event are: NONE, ENVELOPE, BODY, and HEADERS.

If the parameter value is set to NONE then no message data is included in the event.

If the parameter value is set to ENVELOPE then the SOAP envelope from the message data is included in the event.

If the parameter value is set BODY then the body from the SOAP message data is included in the event.

If the parameter value is set HEADERS then the header data from the SOAP message is included in the event.

Note: Message data is included in the generated event only if permitted by the system policy. To include message data in events, set the WebSphere® variable SM_EVENT_POLICY_PERMIT_MESSAGE_DATA to true, and then restart the server.
topic
The JNDI name of the JMS Topic.
If the topic parameter is not specified, events are published using the default topic string:
$SYS/AppServer/<cell_name>/<node_name>.<server_name>|<cluster_name>/<client_application_name>/<LMS_name>/<operation_name>
Where either <node_name>.<server_name> must be specified, or <cluster_name> must be specified, depending on your configuration.
Note: After creation, event points are in the disabled state. No events are generated unless you enable the event point.

Example usage

The following example shows how you set an event point on a local mapping service.

Using Jython:

Input message:
AdminTask.createLMServiceEventPoint('-lmService DemoLM -mustSend false -sendAtCommit true -eventData envelope -connectionFactory myJmsCF -topic myJmsTopic')
Output message:
CWSMW0252I: The event point for local mapping service "DemoLM" was created successfully.

Using Jacl:

Input message:
$AdminTask createLMServiceEventPoint {-lmService DemoLM -mustSend false -sendAtCommit true -eventData envelope -connectionFactory myJmsCF -topic myJmsTopic}
Output message:
CWSMW0252I: The event point for local mapping service "DemoLM" was created successfully.

Icon that indicates the type of topic Reference topic

Terms and conditions for information centers | Feedback


Timestamp icon Last updated: Tuesday, 22 April 2014
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-express-iseries&topic=rsm_createlmserviceeventpointcmd
File name: rsm_createlmserviceeventpointcmd.html