https://sillysky.net/docs/nyssr/job-engine/ Recent content in Job/Batch engine on sillysky.net Hugo -- gohugo.io en Wed, 15 Oct 2025 00:00:00 +0000 https://sillysky.net/docs/nyssr/job-engine/cabstractjob/ Wed, 15 Oct 2025 00:00:00 +0000 https://sillysky.net/docs/nyssr/job-engine/cabstractjob/ This abstract class handles the implementation of the IJob interface. Of course you can override methods. The work starts with registering your job target in the target registry, and ends with deregistering from the target registry. The entry point is the message handler for the message CRecordStartTarget, which is the first message that the target receives from the system, see "How to start a simple target". A possible procedure for the implementation of your job target can be found in the tutorial "How to use the job engine for bulk tasks". https://sillysky.net/docs/nyssr/job-engine/ijob/ Wed, 15 Oct 2025 00:00:00 +0000 https://sillysky.net/docs/nyssr/job-engine/ijob/ A job is a target that implements this interface. This is usually not done by yourself: there is an abstract class CAbstractJob, which takes over this task. You can then focus on implementing your task. The work starts with registering your job target in the target registry, and ends with deregistering from the target registry. The entry point is the message handler for the message CRecordStartTarget, which is the first message that the target receives from the system, see "How to start a simple target". https://sillysky.net/docs/nyssr/job-engine/ijobengine/ Wed, 15 Oct 2025 00:00:00 +0000 https://sillysky.net/docs/nyssr/job-engine/ijobengine/ The Job Engine executes jobs in multiple threads simultaneously. It is created by the Job Engine factory. Get a job engine The job engine is available via the job engine factory. This in turn is a singleton, which is obtained via the service registry. final IJobEngineFactory factory = CServiceRegistry.getInstance() .getService(IJobEngineFactory.class); final IJobEngine engine = factory.createEngine("MyEngine"); As always, the package starter should have a dependency on the job engine factory to make sure it is already initialized. https://sillysky.net/docs/nyssr/job-engine/ijobenginefactory/ Wed, 15 Oct 2025 00:00:00 +0000 https://sillysky.net/docs/nyssr/job-engine/ijobenginefactory/ The job engine factory is a local service of the kernel. It creates job engines that are responsible for executing jobs. Get the job engine factory The factory is fetched as a singleton from the service registry: final IJobEngineFactory factory = CServiceRegistry.getInstance() .getService(IJobEngineFactory.class); As always, make sure that the service starter of your package has a dependency on the IJobEngineFactory to ensure that the factory already exists. Creating a job engine The job engine factory has a single method for generating job engines. https://sillysky.net/docs/nyssr/job-engine/ijobthread/ Wed, 15 Oct 2025 00:00:00 +0000 https://sillysky.net/docs/nyssr/job-engine/ijobthread/ IJobThread is an internal class of the job engine. It provides information about the jobs currently working in its thread. Jobs can also signal the end of their work here. Getter Returns the name of the thread. String getName(); Returns the priority of the thread. EThreadPriority getPriority(); Returns the maximum number of jobs working simultaneously in this thread. int getMaxConcurrentJobs(); Returns the number of jobs currently working in this thread. https://sillysky.net/docs/nyssr/job-engine/ejobstatus/ Mon, 17 Apr 2023 00:00:00 +0000 https://sillysky.net/docs/nyssr/job-engine/ejobstatus/ The status of a job describes its current processing state. DETACHED (Not yet registered in the job engine) WAITING (Registered in the job engine, but still in the queue) RUNNING (The job is executed) STOPPED (The job is canceled or finished)