stopjobmanager

R2026b

Stop job manager process

When you need to shut down a job manager, use the stopjobmanager script to stop it gracefully. By default, checkpoint information is preserved so the job manager can resume with its previous state when restarted.

The stopjobmanager executable resides in the folder matlabroot\toolbox\parallel\bin (Windows^® operating system) or matlabroot/toolbox/parallel/bin (Linux^® operating system). Enter the command at a Windows or Linux command-line prompt, respectively.

Syntax

stopjobmanager
stopjobmanager --options


Description

stopjobmanager stops a job manager that is running under the mjs service.

stopjobmanager --options accepts the following input options. You can use multiple options together in the same command. Precede each option with two dashes (--).

Before R2026b: To specify an option, use a single dash (-).

Option	Operation
--name <job_manager_name>	Specify the name of the job manager to stop. The default is the value of the DEFAULT_JOB_MANAGER_NAME parameter in the mjs_def file.
--clean	Delete all checkpoint information, job, and task data stored on disk for the current job manager instance after it stops.
--cleanPreserveJobs	Delete all checkpoint information stored on disk for the current job manager instance after it stops. This option preserves existing jobs and task data.
--remotehost <hostname>	Specify the host on which to stop the job manager and the associated lookup process. If you do not specify a host, the command stops both processes running on the local host.
--baseport <port_number>	Specify the base port used by the mjs service on the remote host. Use this option only when the remote host's base port differs from the local BASE_PORT value in the mjs_def file.
--secretfile <path_to_shared_secret_file>	Specify the path to the shared secret file to use to sign the command. This option is required when the mjs_def file of the mjs service has REQUIRE_SCRIPT_VERIFICATION=true. If you do not use this option and the mjs services requires script verification, the command attempts to use the secret file in the default location: $CHECKPOINTBASE/security/secret
--verbose, -v	Display detailed progress information about the command execution.

Examples

Stop the job manager named MyJobManager on the local host.

stopjobmanager --name MyJobManager

Stop the job manager named MyJobManager running on the remote host JMHost.

stopjobmanager --name MyJobManager --remotehost JMHost