Replaying data

When you have recorded data, you can replay it to a queue by using the web user interface or the administration REST API.

To replay data to an IBM® MQ queue, complete the following steps:

1. Ensure that your record and replay stores are configured to allow viewing. For more information, see Configuring data recording.
2. Stop the integration server. See Stopping an integration server.
3. Open the server.conf.yaml configuration file for your integration server by using a YAML editor.

   You can edit the file by using the built-in YAML editor that is provided in the IBM App Connect Enterprise Toolkit, either by double-clicking the file in the Application Development view or by right-clicking the file and selecting Open with > YAML editor. If you choose to edit the file by using a plain text editor, ensure that you do not include any tab characters (which are not valid in YAML) and use a YAML validation tool to validate the contents of your file.

4. Update the server.conf.yaml file to define the IBM MQ queues to which you can replay data.
   The properties that you need to set are in the RecordReplay section of the server.conf.yaml configuration file.
   
   Copy and customize the MQDestinationTemplate section for each Record and Replay destination that you want to create. For example:

   RecordReplay:
              ...
              Destinations:
                 MQDestination:
                 endpointType: 'WMQDestination'             # The type of the target destination to which messages will be replayed. The default is WMQDestination, which is the only valid value.
                 endpoint: 'wmq:/msg/queue/[QUEUE]@[QMGR]'  #  
   

   1. Change the heading MQDestinationTemplate to the name of your data destination, for example, MQDestination.
   2. Set the endpointType property to WMQDestination.
   3. Set the endpoint property to include the name of the queue and, optionally, the queue manager.

      If the queue manager is not specified ('wmq:/msg/queue/[QUEUE]'), the default local or remote queue manager for the integration server is used.

5. Start the integration server. See Starting an integration server.
6. Use one of the following methods to replay your data:
   • Use the IBM App Connect Enterprise web user interface:
     1. Configure the web user interface, as described in Configuring the IBM App Connect Enterprise web user interface.
     2. Log on to the web user interface. For more information, see Accessing the web user interface.
     3. Select the Data tab of the integration node or integration server. Selecting the Data tab displays all the record and replay stores in the integration node or integration server that have been configured for viewing.
     4. Select the record and replay store that contains the data that you want to replay. Each row that is displayed represents a recorded message.
     5. Select the messages that you want to replay. You can replay only messages that have data.
     6. Click Mark for replay. The selected messages are added to the replay list in the Replay tab; they are not replayed at this stage.
     7. Select the destination for your data. The list of available destinations corresponds to the destinations that you defined when you updated the server.conf.yaml file.
     8. You can now select the messages to replay.
     9. Click Replay. The selected messages are sent to the specified destination. Messages that are not delivered are highlighted. You can replay messages multiple times. To remove a message from the list, select the message and click Remove.
   • Use the administration REST API. For more information, see Managing resources by using the administration REST API.