Delete a subcontext

When you delete a subcontext in IBM MQ Explorer, the subcontext no longer exists in the JNDI namespace.


About this task

We cannot delete a subcontext that contains administered objects; we must first delete from the subcontext all of the connection factories, destinations, and subcontexts in the subcontext.

Important: Before you delete a subcontext, make sure that none of our JMS client applications need any of the administered objects in subcontext. After you delete the subcontext, any JMS client applications that do still need these administered objects that were previously in the subcontext will no longer work properly.

To delete a subcontext, complete the following steps.


Procedure

  1. Delete from the subcontext any objects that are stored in the subcontext, including IBM MQ classes for JMS connection factories and destinations, other subcontexts, and any other objects that are shown in the Content view of the initial context.
  2. Refresh the Content view of the subcontext so that IBM MQ Explorer has up-to-date information about the content of the JNDI namespace.
  3. In the Navigator view, right-click the subcontext, then click Delete... If the Delete... menu item is not available, there are still objects in the subcontext; the objects might not be displayed in IBM MQ Explorer; refresh the Content view to ensure that IBM MQ Explorer has up-to-date information about the content of the JNDI namespace.
  4. When we are prompted, click Delete to confirm that we want to delete the subcontext.


Results

The subcontext is deleted from the JNDI namespace as well as from IBM MQ Explorer.

Parent topic: Create and configure JMS administered objects


Related concepts


Related tasks