Read the Routing tab
Lesson 9 of 25 7 min read
The columns of the Routing tab, what each status means, and how to trace an Off status back to the switch that caused it.
The Routing tab tells you, at a glance, whether messages of each type reach a service. Reading it correctly is the first step of almost every troubleshooting job. By the end of this lesson you'll be able to read every status and know where to go to change it.
The table
| Message type | The name and id of the message type. |
|---|---|
| Supported | Ticked if the type does this message type. |
| Handled by | The service that gets these messages. Not routed shows if there is no service. |
| Enabled | On if the route is on. You can only use it when a service is assigned. |
| Status | Whether messages get to a service. |
The statuses
- LiveMessages get to the service. The route, the service, the message type and the link between the service and the message type are all on. Nothing to do.
- OffA service is assigned, but a switch is off. The text below gives the reason. Turn on the switch that is off, if that is correct.
- Not routedThe type supports the message type but has no service. Messages are lost. Choose a service, or untick Supported.
A row with an empty status means the type doesn't support that message type. That's fine: nothing to do.
What "Live" needs
A row is Live only when four things are all on:
If any one of them is off, the row shows Off and names the reason.
Reasons for Off
An Off status gives one or more of these reasons:
| Reason | Where to change it |
|---|---|
| the route is switched off | The Enabled switch on this row. |
| Name is disabled, for example AS2 Service is disabled | The service Enabled switch on the Routing Switches page. |
| Name does not handle Type, or its link to Type is switched off | The message type cell for that service on the Routing Switches page. |
| the Type message type is disabled | The message type Enabled switch on the Routing Switches page. |
Only the first reason is fixed on this tab. The other three are on the platform-wide Routing Switches page, which affects every integration type. Before you switch one of those back on, find out who switched it off and why: it may have been an emergency stop.
The Not routed warning
If one or more rows are Not routed, a warning shows above the table. It names the message types that are lost. The message reads like this:
Messages of Type are being discarded: the type supports them, but no service picks them up.
Watch out
Don't ignore this warning, even briefly. Every message of that type is being discarded with no error until you choose a service or untick Supported.
Reading the Acme SFTP Routing tab
You open the Routing tab for Acme SFTP and see:
| Message type | Status |
|---|---|
| Create | Live |
| Parse | Live |
| Receive | Off: the route is switched off |
| Send | Not routed |
- Create and Parse are fine.
- Receive was paused on purpose by a colleague last week (the reason is on this row). Check with them before switching it back on.
- Send is the emergency: Hilltop Coffee's outbound order files are being discarded. Choose a service in Handled by now.
Recap
- The Routing tab shows, for each message type, whether it's supported, which service handles it, whether it's enabled, and its status.
- Live means all four switches are on: route, service, message type and the service's link to the message type.
- Off names its reason. Only "the route is switched off" is fixed on this tab; the others are on Routing Switches.
- Not routed means messages are lost. Act on it straight away.
Your progress is saved in this browser. Create a free account to keep it everywhere, take quizzes and earn certificates.