Create and execute a Message

1. In Qntrl, navigate to(Settings) >> Advanced >> Bridge, and click Messages.
2. Click New Message.
3. In the New Message window, enter the following details.
• Name: Enter a unique name for the message, so that it can be reused by different bridges when required.
• Bridge ID/Cluster ID: The dropdown lists all available bridges and load balancing clusters.
• Bridge: Executes the message on a specific bridge.
• Cluster: System automatically chooses an active bridge within the cluster. Learn more about Clusters.
• Module: Select a module from the dropdown. Modules are listed service-wise, and the related tasks appear automatically. When a new bridge is created, the Core service and modules under it are associated by default.

• Task Engine –  Executes API tasks in third-party or internal applications.
• DB Engine – Performs SQL queries in databases within a private network.
• SSH Engine – Executes commands on remote Linux/Unix systems.
• PowerShell Engine– Executes commands on remote Windows systems.
  
• AD Engine– Performs secure operations in Active Directory.
  

• Type: Defines how the task runs:
  
• Synchronous - Executes immediately and displays the response in real.
  
• Asynchronous - Executes in the background without waiting for the response.
  

• Task: If the selected module includes subtasks, choose the relevant task.
• Request Data: Enter task instructions in JSON format.
• Click Sample JSON at the bottom of the editor to load a predefined structure (meta data) for the selected module and task.
• If needed, modify the resource_name and other key parameters manually.

• Response: Displays the output for Synchronous messages once execution completes.

4. Once all the details are filled, click Execute to run the message. 

View / Modify / Execute Message properties        

1. Navigate to(Settings) >> Advanced >> Bridge, and click Messages.
2. The messages will be listed.
3. You can filter messages based on service and modules by clicking the filter icon in the respective columns.

4. On the Message list page, click on the Message ID to view its properties.
5. The details of the selected Message will be displayed. You can view/edit the properties of the fields (Bridge, Type, Request Data, etc.) of the message here.  
6. If you wish to execute the message, Click Execute.  
7. The response of the last execution will be available in the Response Data tab.   

To view the full response (for synchronous message types) or verify the server call from your Bridge Agent:

1. Navigate to (Settings) >> Advanced >> Bridge and select Bridge.
2. Hover over the bridge name, click the action menu, and select Open Agent.
3. This will direct you to the Bridge Agent login page. Log in with your Username and Password. Learn more about Bridge Agent.
4. Navigate to the Messages section in the Header bar.
5. Use the dropdown menu to view message logs and responses.

Message Retention Policy

Cloud Retention

1. Up to 500,000 messages or 6 months of data (whichever comes first) are stored.
2. Older messages beyond this limit are permanently deleted from Qntrl’s cloud database.
   

Bridge Agent Retention

1. Default visibility: 30 days or 50,000 messages
   
2. Maximum visibility: 100,000 messages
   

1. Default retention: 90 days or 250,000 messages
   
2. Maximum retention: 500,000 messages
   

Modifying Bridge Agent Retention Limits

You can customize message retention limits on the Bridge Agent:

1. Open the configuration file: conf/config.xml
2. Update the message retention settings as required.
3. Restart the Bridge Agent for the changes to take effect.
   

Restarting the Bridge Agent is mandatory after modifying retention settings.

Delete a Message        

1. Navigate to(Settings) >> Advanced >> Bridge >> select Messages.

2. Hover next to the ID of the message you want to delete, click the mouse over action menu, and select Delete.

3. The configured bridge message will be deleted.