condorq

Condor_q, sometimes written condor_q or condorq, is a command-line utility in the HTCondor workload management system. It is used to query and display information about the job queue in a Condor pool, enabling users and administrators to monitor the status and metadata of submitted jobs.

Functionality and scope

Condor_q connects to the HTCondor central manager to retrieve queue information for a specific user, group, or the entire pool. It presents a concise overview of active and pending jobs, including basic details such as the executable, owner, submission time, and resource requirements. The tool supports options to tailor the output, make queries across multiple pools, and filter results to match particular criteria.

Typical usage and options

Common options include specifying the collector or pool with -name or -pool, requesting a global view with -global, and expanding output with -long. Users can customize which fields are shown using -format or limit results with -n. Filtering by attributes is possible through -constraint, allowing focused views of jobs that match certain conditions. The command is frequently used in scripting and automation to integrate with other Condor tools or monitoring systems.

Output and integration

The default output is a tabular list of jobs, typically showing a JobID, Owner, JobStatus, and the command to be executed. Condor_q works alongside other HTCondor utilities such as condor_submit for submitting jobs and condor_status for resource and daemon status inquiries, forming part of the standard workflow for managing a Condor-enabled cluster.

Naming and context

HTCondor’s suite of commands often prefixes actions with condor_, and condor_q specifically refers to querying the job queue. The tool is widely documented in HTCondor manuals and is central to day-to-day cluster operation and monitoring.