> For the complete documentation index, see [llms.txt](https://docs.virtual-flow.org/documentation-vf1/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.virtual-flow.org/documentation-vf1/principles-and-theory/job-organization.md). # Job Organization ### General To run computations on computer clusters which are managed by a batch system (resource manager), one generally needs to submit jobs into batch system. This is also the case with VirtualFlow. VirtualFlow uses batchsystem job to run the workflow, and can use any number of them. Each of these batchsystem jobs has a hierarchy of subjobs. Overview of the hierarchical job structure/organization: * Batchsystem jobs: Any number * Job steps: Usually one per node * Queues: Usually one per CPU core * Mutlithreading: Can be used if the external programs which process the ligands are multithreading enabled ### Batchsystem Jobs Each batchsystem job has a name of the form `-.` where * `` is a single letter which depends on the workflow, and can be specified in the control file. The workflow-letter is useful to distinguish multiple different workflows if they are running in parallel. * `` is the ID of the job, which is a positive integer. * `` is the number of how many times this particular jobline was already running since the beginning of the workflow. After a job has finished and restarts a successive job to continue to the work, the `` is increased (see also the figure below). For example, the jobname "a-1123.3" would be a job of the workflow with workflow ID "a", with jobline ID 1123, and with iteration number 3. ![Figure 1: Joblines in VirtualFlow are successive jobs with the same jobline ID. Once a job is completed, normally the next successor job is started by the job which just finishes its work. The jobline iteration number is increased by 1 with each new successor job.](/files/-L_4LVeeemQOw2OgBPv5) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.virtual-flow.org/documentation-vf1/principles-and-theory/job-organization.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.