code: def register_job(self, job_details):
          
          # check to see if the job already exists
          try:
              job_details_old = self.get_details(job_details.jobname,
                                                 job_details.jobkey)
              if job_details_old.status <= JobStatus.running:
                  job_details_old.status = job_details.status
                  job_details_old.update_table_row(
                      self._table, job_details_old.dbkey - 1)
              job_details = job_details_old
          except KeyError:
              job_details.dbkey = len(self._table) + 1
              job_details.get_file_ids(
                  self._file_archive, creator=job_details.dbkey)
              job_details.append_to_tables(self._table, self._table_ids)
          self._table_id_array = self._table_ids['file_id'].data
          self._cache[job_details.fullkey] = job_details
          return job_details
docs: Register a job in this `JobArchive`