pausejobmanager

R2026b

Pause job manager process

When you need to prevent a job manager from scheduling new jobs without losing its state, use the pausejobmanager script to temporarily suspend it. A paused job manager retains all existing job data and worker registrations. Use resumejobmanager to resume scheduling.

The pausejobmanager 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

pausejobmanager
pausejobmanager --options


Description

pausejobmanager pauses a job manager that is running under the mjs service.

pausejobmanager --options accepts the following input options. You can specify multiple options 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 pause. The default is the value of the DEFAULT_JOB_MANAGER_NAME parameter in the mjs_def file.
--remotehost <hostname>	Specify the host on which to pause the job manager. If you do not specify a host, the command pauses the job manager 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

Pause the job manager named MyJobManager on the local host.

pausejobmanager --name MyJobManager

Pause the job manager named MyJobManager on the host JMHost.

pausejobmanager --name MyJobManager --remotehost JMHost