The Job Queue Projects dialog provides an overview over all your jobs currently located on all accessible and running job queue servers. This dialog only shows your jobs and does not show any jobs submitted by other clients. The overview updates automatically every few seconds.
At the top left of the dialog you can Filter the jobs that are shown by entering text. This allows you to quickly find specific jobs in the list by entering Job, Project, or Host names, a certain Status, or dates / times.
At the top right, you can select the Sorting of the currently shown jobs. The default sorts the list by Host first and then Processing Order second. You can also sort By project and job name, or by Newest / Oldest.
The information shown in the list of all your jobs contains:
Status: This column gives you information on the current status of you job. The possible values are:
Queued: This job is currently in queue. The queue position is given in the brackets following the Queued status.
Simulation Running: This job is currently running on a job queue server.
Completed: This job has run successfully and the results can 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 for this status. The computation has failed and the error message can be seen in the log file. You have terminated this job. The job has reached the defined timeout limit. If the job ran before failing, terminating or timeout, partial results might still be available for download.
Host: This column shows you the name of the job queue server that the job was submitted to.
Project: This column shows you the project name that you have defined.
Job: This column shows you the job name that you have defined. The job name is followed by a number if the job name is duplicated.
Created: This column shows you when the job was created and submitted to the queue.
Started: This column shows you when the computation of the job was started on the server. For jobs in the queue this entry is empty.
Running: This column shows you the time that the job ran or is still running for. For jobs in the queue this entry is empty.
At the bottom left of the dialog, you can raise the main GeoDict window without closing this dialog. Clicking Close at the bottom right of the dialog closes the dialog.
When you select one (or more) job(s) in the list, you can perform multiple actions using the buttons at the bottom of the dialog:
Know how! Multiple jobs can be selected either by holding the Ctrl button and left-clicking on multiple jobs, or by left-clicking on a job and then holding the Shift button and left-clicking on another job to select these jobs and any in between.
Select one (or more) job(s) and click Download Results to access the results of the job(s). This opens the Select Files to Download dialog, where you can see all files contained in the job folder for each of the selected jobs. Click in the checkbox to activate (checked) or deactivate (unchecked) the download for this file. At the top right, all file extensions that are contained in the job results are listed. Here you can in- or exclude all files of a certain file format.
The job results contain the GeoDict result file (*.gdr) and result folder that is created by the executed command or macro. Additionally, the GeoDict log (geodict_log.txt), the macro created from the executed command (macro.py), the python script running the command (runme.py), the standard error (stderr.txt), and the standardoutput (stdout.txt) are available for downloading.
After clicking OK a file browser opens automatically and you can 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. In each of the folders a folder with the name JobNamePrefix@Hostname for all jobs belonging to this project is created. All chosen files and the result folder from this job are stored within this folder.
Click Show Log to see the current GeoDict log output for this job. This information can help you the observe the progress of the computation or identify potential errors. The dialog shows the last 50 lines of the log output. For running jobs, you can update the log by closing the dialog and clicking the Show Log button again.
Select one (or more) running job(s) and click Terminate Simulation(s) to cancel the simulation. Only running or queued jobs can be terminated. Before a job is terminated, a warning message is shown asking you to confirm that you want to terminate all listed jobs. In some cases, partial results might be available if the job ran for some time already.
Click the Delete Job(s) button to delete the currently selected job(s) and all corresponding results. This will remove all generated files for this job from the job server project folder and free disk space on the server machine. Before a job is deleted, a warning message is shown asking you to confirm that you want to delete all listed jobs.
Changing the order of jobs in the queue allows you to prioritize more urgent tasks or optimize the use of system resources. Use the Up & Down Buttons to change order of one (or more) job(s) in the queue. Make sure to sort by Processing Order to obtain the desired ordering of the queue. Select a job and move it to the desired queue position by clicking the up or down button until you reach that position. The number for the queue position in the Status column is changed accordingly. Moving a job into a position before the currently running simulation does not cause this job to immediately start. The currently running job needs to be completed or terminated first.
