Home

 

6. Delete the local queue

 

When you are satisfied that there are no more messages to be delivered to the inventory application at TORONTO, we can delete the queue:

DELETE QLOCAL(INVENTQ)

The cluster set up by this task is similar to that set up by the previous task, except that the INVENTQ queue is no longer available at queue manager TORONTO.

When you take the queue out of service (step 1), the TORONTO queue manager sends a message to the two full repository queue managers notifying them of the change in status. The full repository queue managers pass on this information to other queue managers in the cluster that have requested updates to information concerning the INVENTQ.

Now when a queue manager wants to put a message to the INVENTQ, it sees, from its updated partial repository, that the INVENTQ is available only at NEWYORK, and so sends its message there.

We can now remove the inventory application from the system in Toronto, to avoid duplication and save space on the system.

In this task description there is only one queue to remove and only one cluster to remove it from.

Suppose that there were many queues referring to a namelist containing many cluster names. For example, the TORONTO queue manager might host not only the INVENTQ, but also the PAYROLLQ, SALESQ, and PURCHASESQ. TORONTO makes these queues available in all the appropriate clusters, INVENTORY, PAYROLL, SALES, and PURCHASES. To do this, TORONTO defines a namelist of the cluster names:

DEFINE NAMELIST(TOROLIST)
       DESCR('List of clusters TORONTO is in')
       NAMES(INVENTORY, PAYROLL, SALES, PURCHASES)
and specifies this namelist on each queue definition, like this:
DEFINE QLOCAL(INVENTQ) CLUSNL(TOROLIST)
DEFINE QLOCAL(PAYROLLQ) CLUSNL(TOROLIST)
DEFINE QLOCAL(SALESQ) CLUSNL(TOROLIST)
DEFINE QLOCAL(PURCHASESQ) CLUSNL(TOROLIST)

Now suppose that you want to remove all those queues from the SALES cluster, because the SALES operation is to be taken over by the PURCHASES operation. All we need to do is alter the TOROLIST namelist to remove the name of the SALES cluster from it.

If you want to remove a single queue from one of the clusters in the namelist, create a new namelist, containing the remaining list of cluster names, and then alter the queue definition to use the new namelist. To remove the PAYROLLQ from the INVENTORY cluster:

  1. Create a new namelist:
    DEFINE NAMELIST(TOROSHORTLIST)
           DESCR('List of clusters TORONTO is in other than INVENTORY')
           NAMES(PAYROLL, SALES, PURCHASES)

  2. Alter the PAYROLLQ queue definition:
    ALTER QLOCAL(PAYROLLQ) CLUSNL(TOROSHORTLIST)

 

Parent topic:

Procedure


qc11650_


 

Home