Start of changeIBM FileNet P8, Version 5.2.1            

Resolving problematic queue entries

There are two types of problematic queue entries: deferrals and failures.

A deferral occurs when the sweep subsystem determines that a queue entry is not eligible for processing for a problem that can be corrected. For example, when an advanced storage area is used, a content deletion request is deferred if the content is on a storage device that is offline. A deferred queue entry is given a status of RETRY-WAIT.

A failure occurs when a queue entry cannot be processed due to an unexpected error that might or might not be correctable. For example, a content deletion request fails if the content does not exist in the storage area. A failed queue entry can have either a FAILED or RETRY-WAIT status, depending on how the MaximumFailures property is set on the queue sweep.

Finding problematic queue entries

You can find problematic queue entries by using the Queue Entries tab of a sweep. You can define a filter to view queue entries that meet specific criteria. For example, you can define a filter to view queue entries that have a status of Retry wait and a deferral count greater than or equal to 50.

In some cases, to properly troubleshoot the issue, you might need to filter the queue entries according to other properties that are not shown on the Queue Entries tab. To use more properties to filter the queue entries, perform an object store search. For example, to view deferred content deletion requests for documents that were created during the first week of September 2014, set the following criteria on the New Object Store Search > Simple View tab.

Search criteria Value
Class Content Deletion Queue Entry
Date Created Greater Or Equal to 9/1/2014
Date Created Less Or Equal to 9/7/2014
Queue Entry Status Equal to 0
Deferral Count Greater Or Equal to 50
Tip: To search for a specific queue entry status, use the following integer values:
Value Status
0 Waiting
1 In progress
2 Retry wait
3 Failed

Resolving problematic queue entries

To resolve deferred queue entries, check that all required resources are available. After the queue entries become eligible for processing, the queue sweep automatically starts to process them.

The reason for a failed queue entry is stated in the entry's LastFailureReason property. If you can fix the problem for a queue entry with a RETRY-WAIT status, the queue entry will be successfully processed when it is scheduled for a retry. If you can fix the problem for a queue entry with a FAILED status, you must also reset the entry's FailureCount property to zero before processing restarts. For a few failed queue entries, you can select the queue entries on the Queue Entries tab of the sweep and click Actions > Reset Failure Count. To reset many failed queue entries, you can set up a custom sweep job.

If a queue entry failed and there is no way to fix the underlying problem, you can delete the queue entry. You can manually delete a queue entry from the Queue Entries tab of the sweep. To delete many queue entries, you can set up a disposal policy. When you create this policy, ensure that the filter expression includes the expression QueueEntryStatus=3 to identify the failed queue entries.
Tip: After the disposal policy finishes deleting the failed queue entries, delete or disable the policy. Alternatively, set an end date on the policy to prevent it from continuing to delete queue entries.


Last updated: October 2015
p8pcc460.htm

© Copyright IBM Corporation 2015.
End of change