Reference > Shop flow URLs > Messaging system URLs
SendTransactedMsg URL
This URL sends all outstanding messages using the Send Transacted Sending services.
URL structure
- http://host_name/path/
- The fully qualified name of the WebSphere Commerce Server and the configuration path
name-value pair with the &
character. For a detailed description of the parameters and their values, see the list entitled Parameter values." />
Parameter values
- msgId
- (Optional) Specifies the number of messages to send when the command is invoked by using the value in the MSGID column of the MSGSTORE table. Specify either msgId or numOfMessages. If numOfMessages is used with the msgId parameter; then the numOfMessages is ignored.
- numOfMessages
- (Optional) Specifies the number of messages in the MSGSTORE table that have a RETRIES value larger than 0. Specify either numOfMessages or msgId.
- batchSize
- (Optional) Specifies the maximum number of messages to send in one transaction; the default value is 1. If one message in the batch cannot be sent, then all other messages in the batch will be requeued for the next URL execution. Use this parameter with the numOfMessages parameter, or on its own.
Example 1
This example shows sending a maximum of 99 messages with a batch size of 3.
https://myhostname/webapp/wcs/stores/servlet/SendTransactedMsg?numOfMessages=99&batchSize=3
Example 2
This example shows sending a message with the ID 123456.
https://myhostname/webapp/wcs/stores/servlet/SendTransactedMsg?msgId=123456
Behavior
- Calls the SendTransactedMsgCmd controller command to send message queued
to be sent using sendTransacted() sending service.
- In performExecute() method, it will call assembleMsg() method. Optional
parameters will be extracted in assembleMsg() method.
- It attempts to locate any outstanding messages messages to be sent. Once
it found any in MSGSTORE, it will attempt to send each one under individual
transaction (when batchSize is 1). If exception is encountered during message
sending, the MSGSTORE.RETRIES will be decremented by 1 and next message found
will be attempted. The failure one will be re-attempted during the next URL
execution as long as the RETRIES value is larger than 0. Messages with RETRIES
values equal to zero will be left in the MSGSTORE until Site Administrator
increments the RETRIES value or deletes them from MSGSTORE.
If batchSize is larger than one, say 3, it will attempt to send 3 messages before completing a transaction. After the transaction is completed, the rest of outstanding messages will be attempted. If there are less than 3 messages, transaction will be completed after the last message is attempted.
- If Retry Duration (in hours) of a message type is assigned to Email Transport, RETRIES will not be decremented until the retries duration is expired. Retry Duration is evaluation since the first attempt of the message being sent.
Exception Conditions
- If a parameter is invalid it will be ignored.
Related concepts
Related tasks
Assign a message type to a transport method for a site or store
Related reference