Skip to content

IBMMQ#8114

Open
ramonsmits wants to merge 15 commits intomasterfrom
ibmmq-transport-docs
Open

IBMMQ#8114
ramonsmits wants to merge 15 commits intomasterfrom
ibmmq-transport-docs

Conversation

@ramonsmits
Copy link
Member

No description provided.

Adds comprehensive transport guidance for the IBM MQ transport,
following existing patterns from RabbitMQ, PostgreSQL, and other
transport documentation.

New pages:
- Transport overview with features, advantages, and configuration
- Connection settings (basic, HA, SSL/TLS, message processing)
- Publish/subscribe topology (topic-per-event, polymorphism, naming)
- Transaction support (SendsAtomicWithReceive, ReceiveOnly, None)
- Native integration (MQMD/MQRFH2 message structure)
- Operations scripting (CLI tool and runmqsc commands)

Infrastructure:
- Registered IbmMq component in components.yaml
- Added NuGet alias mapping in nugetAlias.txt
- Added core-dependencies version mapping
- Added IBM MQ section to navigation menu
- Added IBM MQ to supported transports index
- Added IBM MQ to transport selection guide
- index.md: Remove implementation details (ResourceNameSanitizer code,
  MQPER_PERSISTENT constants, character set lists). Keep as user-facing
  overview with links to detail pages.
- transactions.md: Remove MQ-specific internals (MQPMO_SYNCPOINT,
  MQQueueManager connection sharing). Keep conceptual descriptions.
- topology.md: Remove detailed implementation steps and topic naming
  customization code. Keep diagrams and user-facing concepts. Link to
  connection-settings for configuration details.
- native-integration.md: Tone down MQ internals while keeping the
  essential interop information.
- connection-settings.md: Absorb topic naming configuration, resource
  name sanitization, and message persistence from other pages.
Add mermaid diagram showing how receive, send, and publish operations
are committed or rolled back as a single unit. Clarify that database
operations are not part of the transport transaction and link to the
Outbox feature.
@ramonsmits ramonsmits force-pushed the ibmmq-transport-docs branch from 9d886c2 to d1ffa96 Compare March 6, 2026 09:48
- component frontmatter used `IbmMq` but components.yaml key is `IBMMQ`
- GitHubOwner was `ParticularLabs` but repo lives under `Particular`
- IBM MQ was missing from the transaction support matrix
Wildcard version (1.0.0-*) is not allowed for prerelease components
by the integrity tests. Pin to 1.0.0-alpha.1.
@irinascurtu irinascurtu marked this pull request as ready for review March 10, 2026 09:26
@irinascurtu irinascurtu self-requested a review March 10, 2026 09:26
@irinascurtu irinascurtu marked this pull request as draft March 10, 2026 09:27
@irinascurtu irinascurtu marked this pull request as ready for review March 10, 2026 12:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants