queuestatus

R2026b

Display job information in each job manager queue

expand all in page

When your MATLAB® Job Scheduler is running and processing jobs, use the queuestatus function to learn about the status of the jobs in the queue of each job manager the mjs service maintains.

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

For each job manager, queuestatus displays the job manager's name, host name, and job queue. The jobs in the queue are grouped by:

  • Queued jobs: Jobs waiting to be scheduled.

  • Running jobs: Jobs currently executing.

  • Pending jobs: Jobs that are submitted but not yet started.

  • Finished jobs: Jobs that are completed.

Syntax

queuestatus
queuestatus --options

Description

queuestatus displays information about the jobs in the queue of each job manager the mjs service maintains on the local host in JSON format. The mjs service must already be running on the computer before you run the queuestatus command.

queuestatus --options accepts the following input options. Precede each option with two dashes (--).

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

OptionOperation
--remotehost <hostname>

Display information about the jobs on each job manager process maintained by the mjs service on the specified 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.

Examples

expand all

Display information about the jobs in the queue of the job managers running on the mjs service on the local host.

queuestatus
[{"name":"default-job-manager-MJS",
"host":"localhost",
"queuedJobs":[],
"runningJobs":[{"id":1,"type":"pool","username":"userA",
               "submitTime":"Fri Oct 24 13:16:59 BST 2025",
               "startTime":"Fri Oct 24 13:16:59 BST 2025",
               "numThreads":1,"minWorkers":1,"maxWorkers":1,"numPendingTasks":0,
               "numRunningTasks":1,"numFinishedTasks":0}],
"pendingJobs":[],
"finishedJobs":[{"id":2,"type":"independent","username":"userB",
               "submitTime":"Fri Oct 24 13:21:21 BST 2025",
               "startTime":"Fri Oct 24 13:21:21 BST 2025",
               "numThreads":1,"minWorkers":1,"maxWorkers":2147483647,"numPendingTasks":0,
               "numRunningTasks":0,"numFinishedTasks":1}]}]

Display information about the jobs in the queue of the job managers running on the mjs service on the remote host with the host name node27.

queuestatus --remotehost node27

See Also

| | | |