The Jobs tab contains all the functionalities related to the job queue server on this machine, as well as an administrator overview of all jobs submitted to it.

Server Status

The current Server Status is displayed at the top of the dialog:

• Not available: The server is not running or is not reachable (e.g., due to being blocked by a firewall).
• Ready: This means the server is running, but there are no jobs running or in the queue.
• Busy: The server is running, and one or more jobs are running.
• Paused: The server is paused due to the Pause Processing button being clicked.

Jobs Information

Below Server Status, you can find information on the current number of running, queued, and finished jobs. The maximum number of parallel jobs allowed is shown behind the number of running jobs. You can adjust this setting in Server Settings before starting the server.

Server Control Buttons

The buttons to control the server are located to the right of the Server Status.

When the server is not running, click the Start Server button to start it. Any user who has purchased a GeoDict server license can start a job queue server. Administrator privileges are not required. This terminal window displays a log of all invoked functions and who invoked them (e.g., GeoDict Job Queue Server running, CreateJob called by User, Running GeoDict, etc.). This log is also saved to the job system directory (\GeoDict2026\JobSystem\serverlogs\).

Click Pause Processing while the server is running to pause the processing of queued jobs. Any jobs that are already running will continue until they finish, are terminated, or fail, and the server status remains Busy during this time. When all running jobs have completed, the server status switches to Paused. Jobs that were queued when the Pause Processing button was clicked, or those submitted afterward, will not start until you click the button again to end the pause. This allows you to free up computational resources without stopping the Job Queue server completely.

To shut down the server, click Stop Server when the server is running. This will also close the terminal window. You can also stop the server by manually closing the terminal window.

If the job queue server is running when you close GeoDict, a message indicating that the server is still running will appear. There are two options here. You can Leave the server running and exit GeoDict. In this case, the terminal window will remain open, and as long as this window is not closed, the job queue server will run and jobs can be submitted. Alternatively, you can Stop the server and exit GeoDict, which will also close the terminal window.

Filter

You can Filter the jobs shown by entering text or numbers in the Filter field at the top left of the dialog. This allows you to quickly find specific jobs in the list by entering Job, Project or Host names, a certain Status, or dates/times.

Jobs Table

In the Jobs tab, the server administrator sees the same list of jobs that clients see in the Job Queue Projects dialog. However, the administrator can see all jobs submitted by all clients on the server, while clients can only see their own jobs. The server administrator can perform the same actions as the clients, such as downloading results, terminating simulations, deleting jobs, and changing the queue order.

Status

The Status column provides information about the current processing stage of your job. The Status can be one of the following:

• Queued: This job is currently in the queue. The position in the queue is given in brackets after the Queued status.
• Simulation Running: This job is currently running on a job queue server.
• Completed: This job has been successfully completed and the results can now be downloaded.
• Downloaded: This job has run successfully and the results have been downloaded. You can download the results again if necessary.
• Error: There are multiple possible causes of this status:
  • The computation failed, and the error message can be found in the log file.
  • You terminated this job.
  • The job has reached the defined timeout limit.

User

The User column shows the name of the person who submitted this job.

Project

The Project column displays the project name you defined.

Job

The Job column displays the job name you defined. If the job name is duplicated, it is followed by a number.

Created

The Created column shows you the date and time the job was created and submitted to the queue.

Started

The Started column shows when the job was started on the server. For jobs in the queue, this field is empty.

Running

The Running column shows the time that the job has been running, or is currently running.

Buttons

After selecting one or more jobs from the list, you can perform multiple actions using the buttons located at the bottom of the dialog:

Download Results

Select one or more jobs and click Download Results to access their results. This will open the Select Files to Download dialog, where you can view all the files in the job folder for each selected job. Click the checkbox to activate (check) or deactivate (uncheck) the download for a file. At the top right all the file extensions contained in the job results are listed. Here, you can include or exclude all files of a certain format.

The job results contain the GeoDict result file (*.gdr) and the result folder created by the executed command or macro. The GeoDict log (geodict_log.txt), the macro created from the executed command (macro.py), the Python script that ran the command (runme.py), the standard error (stderr.txt), and the standard output (stdout.txt) are also available for download.

After clicking OK, the file browser will open automatically, allowing you to choose where to store the downloaded files on your machine. During the download, a folder for every Project Name is created within the selected location. Within each folder, a folder with the name JobNamePrefix@Hostname is created for all jobs belonging to this project. All chosen files and the result folder from this job are stored in this folder.

Show Log

Click Show Log to view the current GeoDict log output for this job. This information can help you observe the progress of the computation and identify potential errors. The dialog box displays the last 50 lines of the log output. For running jobs, you can refresh the log by closing the dialog and clicking Show Log again.

Terminate Simulation(s)

To cancel the simulation, select one or more running jobs and click Terminate Simulation(s). Only running or queued jobs can be terminated. Before a job is terminated, a warning message will appear asking you to confirm termination of all listed jobs. In some cases, partial results may be available if the job has already run for some time.

Delete Job(s)

Click the Delete Job(s) button to delete the currently selected job(s) and all of its/their corresponding results. This will remove all generated files for the selected job(s) from the job server project folder, freeing up disk space on the server machine. Before deleting a job, a warning message will appear asking you to confirm that you want to delete all listed jobs.

Up & Down Buttons

You can change the order of jobs in the queue to prioritize more urgent tasks or optimize the use of system resources. Use the Up and Down buttons to change the order of one or more jobs in the queue. Sort by Processing Order to obtain the desired queue order. Select a job and move it to the desired position in the queue by clicking the Up or Down button until you reach that position. The queue position number in the Status column will change accordingly. Moving a job into a position before the currently running simulation will not cause the job to start immediately. The currently running job must first be completed or terminated.