Additional Verbs for the Batch Scheduler

FlexNet Manager Suite 2023 R1 (On-Premises)

Other commands for the batch scheduler are useful for debugging and recovery work, in case of problems.

In normal operation, the batch scheduler almost exclusively makes use of the run verb, as described in Batch Scheduler Command Line. The additional verbs covered here are generally reserved for development, testing, and remediation.

Note: Executing these commands with shadow copying allows for each process to be executed in its own application domain, and allows real-time updates of a high-availability system (see Updating a Running System: Shadow Copy).

BatchProcessTaskConsole.exe help

Prints a text message to the console showing the command-line options.

BatchProcessTaskConsole.exe list-tasks

Creates a list of tasks that are currently executing, together with requests for tasks to execute in future.

BatchProcessTaskConsole.exe process-dispatch -p

Sends a pause message to the batch scheduler service through the express (or process control) queue. Once the message is received and saved to the database, the batch scheduler service stops the queue processing and message dispatch to the batch processor. It writes a 'paused' record to the log file, and repeats this logging every minute until processing is resumed.

BatchProcessTaskConsole.exe process-dispatch -r

Sends a resume message to the batch scheduler service through the express (or process control) queue. Once the message is received and saved to the database, the batch scheduler service restarts the queue processing and message dispatch to the batch processor. It also stops writing paused records in the log file.

BatchProcessTaskConsole.exe test taskName [options] [--taskArguments]

Use with the same task names and arguments as listed in Batch Scheduler Command Line. This causes the batch scheduler to treat the request as usual; but when the message reaches the batch processor, it does not execute the task, but instead pauses for a brief period. Together with a subsequent examination of the log files, this test can help to ensure that the system is running correctly.

BatchProcessTaskConsole.exe fail-task -m messageGUID

This is an important but dangerous command, and should only be used when a task has been lost and the system has failed to heal itself, resulting in a backlog of tasks. This will manifest as the 'lost task' sitting in the processing state for a significant (multi-day) period, while the pending tasks are not progressing, even though actual processing on the task has finished. Use the list-tasks command to check the queue and running tasks. It is bad practice to use the fail-task command to terminate a task that is still running normally, albeit for a long time. For further information, see Troubleshooting Batch Processing.