Searching queues

Edit online

Use the Queue Manager to search for UOWs or approval tickets using default filters, or by creating your own filters.

Before you begin

To search within the Queue Manager, select Queue Manager, or a Queue Manager sub-set from the navigation tree. Then select the search icon. Your search options are displayed in the left pane.

About this task

You can search by using the following options: Search by state, date, association, failure categories, and attributes.
  • Search by state: As units of work (UOWs) and approval tickets move through the system, their states change. It is sometimes useful to filter the data shown in the Queue Manager based on one or more of these states.
  • Search by date: This drop-down enables you to search queue manager for UOWs by explicitly set dates, or relative to current time.
  • Search by association: Using the Search by Association form, the user can choose to view work submitted by them, or work for which they are the approver. Note if the user is a member of a group with the “View All Work” activity assigned to them, they have the ability to view all results for ALL groups - regardless of whether they are a member of the group.
  • Search by failure categories: You can search by failure category. This can help you search for UOWs based on why they may have failed.
  • Search by attribute: You can search by the following UOW attributes: priority, type, ID, submitter, and description.
  • Search by recurring sequence: You can display all UOWs in a recurring sequence.

Procedure

  1. SEARCHING BY STATE (UOW)
    1. Select Search by State. The Search by State menu expands.
    2. Select Units of Work. The Units of Work selections display. Select from the following:
      Table 1. Units of Work elements
      Element Definition
      Pending Approval Shows a list of tickets waiting for approval and for which your group(s) have approval rights. From this list, you can view or remove an approval ticket, as long as you have the appropriate permissions.
      Ready to Execute Shows a scrollable list of work that has been approved and is waiting to execute.
      Locked This returns all work that is locked.
      Executing This returns all work that is in an executing state.
      Finished This returns a list of work that has been completed. Each completed work item includes a column showing the type of request. Each completed UOW also includes information specifying its status. Clicking any UOW will populate the associated Queue Manager information
      Cancelled This returns all work that has been cancelled.
      Expired This returns all work that expired before it was completed.
    3. Click Search. Your results display in the main window.
  2. SEARCHING BY STATE (APPROVAL TICKETS)
    1. Select Search by State. The Search by State menu expands.
    2. Select Approval Tickets. The approval ticket selections display. Select from the following.
      Table 2. Select Approval Tickets elements
      Element Definition
      Pending This returns all tickets pending.
      Approved This returns all tickets approved.
      Rejected This returns all rejected tickets.
      Expired This returns all expired tickets.
      This returns all historical tickets.
    3. Click Search. Your results display in the main window.
  3. SHOW ALL DATES SEARCH
    1. This search returns all results.
  4. SEARCHING BY EXPLICITLY SET DATES
    1. You can filter the data shown in the Queue Manager by using the Date Range search. The significance of the date and time you select varies, depending on the type of data you are searching for. For completed UOWs (finished, cancelled, or expired) the work stop time is used. For all other UOWs (pending, waiting for execution, locked, and executing) the scheduled start time is used. For work scheduled to execute immediately, the submission time is used. For recurring UOWs, the next execution time is used. For approval tickets, the UOW associated with the approval ticket is used, so the same rules apply.
    2. Select Search by Date from the menu. The Search by Date menu expands.
    3. Select Explicitly Set Dates. Type a from and to date and time for the tickets or work you are searching.
    4. Click Search. Your results are displayed in the main window.
  5. SEARCHING RELATIVE TO THE CURRENT TIME
    1. You can filter the data shown in the Queue Manager by using the Date Range search. The significance of the date and time you select varies depending on the type of data you are searching for. For completed UOWs (finished, cancelled, or expired) the work stop time is used. For all other UOWs (pending, waiting for execution, locked, and executing) the scheduled start time is used. For work scheduled to execute immediately, the submission time is used. For recurring UOWs, the next execution time is used. For approval tickets, the UOW associated with the approval ticket is used, so the same rules apply. The following process enables you to search Queue Manager Relative to the Current Time. This process enables you to search for information generated during as well as before and after the time selected.
    2. Select Search by Date from the menu. The Search by Date menu expands.
    3. Select Relative to Current Time.
    4. Select from the drop-down the time value for which you want to search Before your work was generated. Your choices are as follows: Hours, Days, Weeks, Months, Years. Select a number for the value you selected.
    5. Repeat step 3 and 4 for the After value.
    6. Click Search. Your results are displayed in the main window.
  6. SEARCHING BY ASSOCIATION
    1. Using the Search by Association form, you can choose to view work submitted by you, or work for which you are the approver. The following process enables you to search Queue Manager by Association.
    2. Select Search by Association. The Search by Association menu expands. Select from the following.
      Table 3. Search by association descriptions
      Association Description
      Submitter Shows work you submitted, or approval tickets for work you submitted.
      Group Shows work submitted by any user in any group in which you have membership, or approval tickets for such work.
      Approver Shows work, or approval tickets, for which you are an approver. When searching for approval tickets, this search also shows the tickets generated for other groups for the work that you can approve.
      Please note if the user is a member of a group with the “View All Work” activity assigned to them, they have the ability to view all results for ALL groups - regardless of whether they are a member of the group.
    3. Click Search. Your selections are displayed in the main window.
  7. SEARCHING BY FAILURE CATEGORIES
    1. This process enables you to search by one or more error categories. This can help you search for UOWs based on why they may have failed.
    2. Select Search by Failure Categories. The Search by Failure Categories menu expands. Select from the following.
      Table 4. Search by Failure Categories elements
      Element Definition
      Authentication This displays results based on Authentication errors.
      Commands Out of Sequence This displays results based on commands being out of sequence.
      Connection refused
      Connection Timed Out
      Device Error This displays results based on device errors.
      Device out of Sync This displays results based on failures due to devices being out of sync.
      Device Revised
      Discovery This displays results based on discovery errors.
      Host Unreachable This displays results based on IP hosts being unreachable.
      Import Failed This displays results based on failed imports.p
      Internal Error
      Invalid VTMOS This displays results based on an invalid VTMOS given.
      Locked Resource This displays results based on failures because resources were in a locked state.
      Name Not Unique This displays results based on names for servers not being unique.`
      Not Attempted - Previous Error This displays results based on work not attempted because they previously failed.
      Rollback Failed This displays results based on rollbacks that failed.
      Staged Device This displays results based on staged devices.
      Uncategorized This displays results based on uncategorized changes.
      Unknown Host This displays results based on unknown hosts.
    3. Click Search. Your results are displayed in the main window.
  8. SEARCHING BY ATTRIBUTE
    1. Select Search by Attribute. The Search by Attribute menu expands.
    2. Select from the following attributes:
      Table 5. Select attribute
      Attribute Definition
      UOW ID Use this attribute to search for a specific UOW for which you know the ID.
      Priority Use this attribute to search for only the UOWs of a certain priority, such as 'high', 'medium' or 'low'.
      Type Use this attribute to search for only the UOWs of a specific type. For a list of UOW types, see Table 2.
      Submitter Use this attribute to search for UOWs that were submitted by a specific user.
      Description Use this attribute to search for UOW for which you know the description. This field is wild-carded, so you can enter only part of the description.
    3. Click Search. Your results display in the main window.
  9. DISPLAYING RELATED UOWS
    1. Right-click a recurring UOW and select Show Recurring Sequence from the drop-down menu.
      All the UOWs in the recurring sequence are displayed.