Skip navigation FileNet logo
Glossary  |  Help Directory  
  Help for vwtool
  Search
Process Reference  
vwtool
Getting Started
Commands
  !<shell_cmd>
  =
  assertbehavior
  attachtran
  config
  convert
  count
  createDBviews
  dbconfig
  deletewob
  dispatchwob
  dump
  echo
  emptyqueue
  environment
  hardcopy
  help
  listdbconfig
  listobjects
  listobjects
  loadstatus
  lockwob
  logconfig
  logquery
  memory
  pagebreak
  queueconfig
  readcdl
  recover
  region
  regions
  resetloadstatus
  rosterconfig
  schemastatus
  statistics
  stepprocessors
  storedquery
  terminatewob
  trace
  unlockwob
  version
  views
  wobquery
  workstation
  writetrace

 

   

deletewob

This command deletes a specified work item. Optionally, you can force deletion of corrupted work items.

CAUTION You should only delete a work item when doing so is absolutely necessary. Never delete a work item under the following circumstances.

  • The work item is currently locked by a user-defined application (including step processors or work performers).

    The only exception to this rule is if, while manually recovering a work item that is locked by a failed work performer or step processor, you have determined that deleting the work item is the best course of action.

  • The work item is locked by Visual WorkFlo/Conductor, Process Administrator, or vwtool.
  • In Visual WorkFlo/Composer-based workflows, the work item is a child work item created via a StaticSplit system instruction, and the work item has not yet reached the Rendezvous or Release system instruction in its workflow.
  • In Process Designer-based workflows, the work item is a child work item created via an AND-Split system instruction, and the work item has not yet reached the Collector step in its workflow.
  • In Visual WorkFlo/Composer-based workflows, the work item is a parent work item (that is, it contains a StaticSplit system instruction) that is pending a Rendezvous with one or more of its child work items.
  • In Process Designer-based workflows, the work item is a parent work item (that is, it contains an AND-Split system instruction) that is pending an AND-Join with one or more of its child work items. A work item in this state lists "Rendezvous" as its current instruction.
  • The work item is the waited-for work item that satisfies a WaitForCondition system function or Visual WorkFlo/WaitForEvent system instruction.

Syntax

deletewob <workobjectnumber> <queuename> <forcedelete>

Parameters

workobjectnumber

Work object number of the work item to delete. Use the wobquery command to find the workobjectnumber.

queuename

Name of queue the work item is in. Use the wobquery command to find the queuename.

If you specify a system or user queue, you must also indicate the server to view.

forcedelete

Force deletion of work item. The force delete option causes the Process Engine to bypass inspection of the work item before deleting it.

Enter "y" to force deletion of the work item or "n" to delete the work item only if no errors occur.

Use the force delete option when the work item is corrupted, or when directed by your FileNet support representative. Actions that indicate corruption are:

  • using wobquery to display this work item results in an error.

  • using deletewob, without the forcedelete parameter, to delete this work item results in an error.

   

NOTE If necessary, change to the desired isolated region prior to executing this command.

TIP In vwtool, you can enter parameters on the command line (following the command name) or let vwtool prompt you for the information by entering just the command name. Generally, we recommend prompt mode for all but the simplest commands. Entering the parameters on the command line is intended primarily for script-driven input.