PoCAT Documentation Get Started

When a step stops

There is no debug configuration file. Read the message and the channel it landed on.

Last updated: 2026-10-20 Section: Troubleshooting
Two outcomes A decline, mismatch, or anomaly is a normal message on an outbound channel. A step that cannot finish throws ServitException and follows <dead-letter-channel>.

What to read

  1. messageId on ServitMessage.
  2. Routing parameters. A missing ${param:name} stops the messagebus URI from expanding.
  3. The byte[] payload. Headers are read-only.
  4. The deploy dead-letter destination: messagebus://error/.../deadletter/${ctx:service_id}.
  5. ErrorCode on the exception. A business subcode is a UserErrorCode from 1 to 999.