| Previous | Next |
| MQ_ERROR_PROV_NAME_BUFFER_TOO_SMALL | MQ_ERROR_WRITE_NOT_ALLOWED |
MQ_ERROR_ILLEGAL_OPERATION
Operational meaning
Applications should keep MQ_ERROR_ILLEGAL_OPERATION attached to the exact MSMQ call that produced it. It applies to foreign queuing system does not implement the requested action. The connector boundary, not local queue state, determines support.
A foreign destination can support a smaller operation set than a native MSMQ queue. When diagnosing this result, capability should be discovered/configured at the connector boundary instead of inferred from local queue success.
Log the destination format-name form and connector identity while avoiding credentials and message payloads. This separates local serialization errors from foreign-system rejection.
Where the condition occurs
| Subsystem | connector applications and messages crossing into foreign queuing systems |
|---|---|
| Relevant condition | application-supplied routing, security, or acknowledgment fields require a connector identity and capabilities |
| Code-specific focus | foreign queuing system does not implement the requested action |
Native MSMQ semantics do not guarantee that a foreign queue supports the same operation, acknowledgment, authentication, or generated-property rules. The code-specific boundary is foreign queuing system does not implement the requested action.
Evidence to preserve
- Propid_m_connector_type and all application-supplied system properties.
- Destination format-name type and foreign-system connector configuration.
- Whether msmq or the connector is expected to generate each field.
Handling and recovery
Use a connector-supported operation or route the workflow through a native MSMQ queue.
Nearby failures
A locally valid MSMQ action can still be outside the capability model of the connector or foreign queuing system. Code-specific condition: foreign queuing system does not implement the requested action.
Worked example
A bridge to a foreign queuing system encounters it. It verifies the connector GUID and foreign-system capability before resubmitting the message.
References
Looking for a different code? Search another status or error code.