Legacy platform

Managing Queues for the Sterling Order Management System

Use the IBM® UrbanCode® Deploy Selfserv tool to perform queue operations.

  • Display the queue details.
  • Clear the messages in an existing queue for your Sterling™ Order Management System application.
  • List all the queues created in the MQ Server.
  • 19.1Put a test message to a queue.
  • 19.1Browse messages in a queue.
  • 19.1Find the oldest message in a queue.
Note: Users with the Production Developer role for Production environment can clear the queues. You must enter a reason while clearing a queue.
The queue should be present in the IBM MQ server.
Note: You must stop all agents or services that are connected to a queue and then clear the queue.

About this task

You can use the process to retrieve the queue details, list all queues or clear the messages, put a test message, browse for messages or find the oldest message in an existing queue.

The Manage Queue process shows the results in the Display MQ Operation Result process step and also uploads the details to the drop-box.

Note: In lower environments, once a queue has been created there is no self serve process to delete the queue. It is recommended that you create a different queue using self serve process instead of using the delete option. If you want to delete a queue in Production environment, log a ticket with IBM Support.
19.1Restriction: Put message, browse message and find oldest message options are not supported in PROD environment due to the sensitivity of the production environment. Browse message displays message details only if the depth of queue is less than 100.

Procedure

  1. Access the IBM UrbanCode Deploy Selfserv tool dashboard
  2. From the Dashboard tab, click the main Applications tab.
  3. Within the Applications tab, select your IBM Sterling Order Management System application. Then, click the Environments tab for that application.
    The Environments tab is the entry point for running processes for an application and displays all of the environments for which you have access for the application.
  4. Request that a process is to run for the target environment by clicking the Image that shows the Request Process button. Request Process icon for the environment.
    The IBM UrbanCode Deploy Selfserv tool displays a window with options for you to specify and configure the process that you want to run.
  5. On the Run Process window, select Manage Queue from the Process menu.
    image
  6. Select or specify values for the following mandatory fields to configure the process:
    • Enter the name of the queue as the value for the Queue Name field. To list all queues, enter ‘*’. For more information on input values, you can use the help icon next to the field.
    • From the Allowed Operations list, select the operation to perform. For example, if the displayQueue process retrieves the details of the queue name provided, view the Display MQ Operation Result process step to get the result displayed on the UCD screen. The process also uploads results with name in the <queueName>-DETAILS.txt format to the queueDetails folder in the drop-box home directory.
    • 19.1If you select putMessage option, you must enter the message to push to the queue in the Message field. Otherwise, process fails. Other options do not require input in the Message field.
    Note: Some options that display in the Run Process window might not be used for completing the process that you selected. For instance, when you choose to run a manage queue process, the following options are not used. Do not select, change, or specify a value for these options:
    • Only Changed Versions
    • Snapshot
    • Schedule Deployment
    • Description
  7. Click Submit to run the process with your selected options to manage queue within the IBM MQ component. The process begins and the Progress Execution log screen displays for you to view the progress and status of the process and of any sub processes. You can use this view to see all of the sub processes that are running to complete the overall process. You can also view the logs for the processes when you need to complete any troubleshooting.

    The IBM UrbanCode Deploy Selfserv tool logs every action that you complete at all levels of an application to assist with troubleshooting.

What to do next

Once the details are fetched, you can check all the queue related information.