Job IDs and Job Status

class ornithology.JobID(cluster, proc)[source]

A class that encapsulates a (cluster ID, proc ID) pair.

Parameters:
  • cluster – The cluster ID for the job.

  • proc – The process ID for the job.

classmethod from_job_ad(job_ad)[source]

Get the JobID of a job ad.

Return type:

JobID

classmethod from_job_event(job_event)[source]

Get the JobID of a htcondor.JobEvent.

Return type:

JobID

id_for_cluster_ad()[source]

Return the JobID for the cluster ad of the cluster this JobID belongs to.

Return type:

JobID

class ornithology.JobStatus(value, names=None, *, module=None, qualname=None, type=None, start=1, boundary=None)[source]

An enumeration of the HTCondor job states.

Warning

UNMATERIALIZED is not a real job state! It is used as the initial state for jobs in some places, but will never show up in (for example) the job queue log.

IDLE = '1'
RUNNING = '2'
REMOVED = '3'
COMPLETED = '4'
HELD = '5'
TRANSFERRING_OUTPUT = '6'
SUSPENDED = '7'
UNMATERIALIZED = '100'