Searching queues

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

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.