Managing batch instances

Each running batch process is referred to as a batch processor instance. Each time you start a batch job, a batch processor instance picks up the job and processes it.

Each batch processor instance has a name that is defined in the instanceName property of the Batch.properties file. To define the instance name to be batch01, edit the property as follows:

instanceName=batch01

The batch processor uses instance names to identify each runtime instance. If you attempt to run a batch processor instance when it is already running, the console provides the message Another copy of the bulk processing instance is running: <instance name>.

When a batch processor job begins, its batch processor instance is locked until the process is completed or terminated. A lock file (<instanceName>.lock)) is created in the $home folder. When the batch job is stopped or completed, the lock file is deleted. If the instance crashes, then the lock file remains in the $home folder, but it will not prevent the same batch instance from being started.

When a runtime instance of the batch processor is running:

  • You cannot start any other runtime instances of the batch processor using the same instance name.
  • You can only start a new batch job on a single batch processor instance after any running batch instances have ended.