Managing queue name translations

When you create a queue manager alias definition or a remote queue definition, the name resolution is carried out for every message carrying that name. This situation must be managed.

This description is provided for application designers and channel planners concerned with an individual system that has message channels to adjacent systems. It takes a local view of channel planning and control.

When you create a queue manager alias definition or a remote queue definition, the name resolution is carried out for every message carrying that name, regardless of the source of the message. To oversee this situation, which might involve large numbers of queues in a queue manager network, you keep tables of:
  • The names of source queues and of source queue managers with respect to resolved queue names, resolved queue manager names, and resolved transmission queue names, with method of resolution
  • The names of source queues with respect to:
    • Resolved destination queue names
    • Resolved destination queue manager names
    • Transmission queues
    • Message channel names
    • Adjacent system names
    • Reply-to queue names
Note: The use of the term source in this context refers to the queue name or the queue manager name provided by the application, or a channel program when opening a queue for putting messages.

An example of each of these tables is shown in Table 1, Table 2, and Table 3.

The names in these tables are derived from the examples in this section, and this table is not intended as a practical example of queue name resolution in one node.

Table 1. Queue name resolution at queue manager QMA
Source queue specified when queue is opened Source queue manager specified when queue is opened Resolved queue name Resolved queue manager name Resolved transmission queue name Resolution type
QA_norm - QA_norm QMB QMB Remote queue
(any) QMB - - QMB (none)
QA_norm - QA_norm QMB TX1 Remote queue
QB QMC QB QMD QMB Queue manager alias
Table 2. Queue name resolution at queue manager QMB
Source queue specified when queue is opened Source queue manager specified when queue is opened Resolved queue name Resolved queue manager name Resolved transmission queue name Resolution type
QA_norm - QA_norm QMB - (none)
QA_norm QMB QA_norm QMB - (none)
QA_norm QMB_PRIORITY QA_norm QMB - Queue manager alias
(any) QMC (any) QMC QMC (none)
(any) QMD_norm (any) QMD_norm TX1 Queue manager alias
(any) QMD_PRIORITY (any) QMD_PRIORITY QMD_fast Queue manager alias
(any) QMC_small (any) QMC_small TX_small Queue manager alias
(any) QMC_large (any) QMC_large TX_external Queue manager alias
QB_small QMC QB_small QMC TX_small Remote queue
QB_large QMC QB_large QMC TX_large Remote queue
(any) QME (any) QME TX1 Queue manager alias
QA QMC QA QMC TX1 Remote queue
QB QMD QB QMD TX1 Remote queue
Table 3. Reply-to queue name translation at queue manager QMA
Application design Reply-to alias definition
Local QMGR Queue name for messages Reply-to queue alias name Redefined to
QMA QRR QR QRR at QMA_class1