(HTCONDOR-650) Documentation.

htcondor · Sep 22, 2021 · 81c44b0 · 81c44b0
1 parent 053c98f
commit 81c44b0
Show file tree

Hide file tree

Showing 2 changed files with 14 additions and 0 deletions.
diff --git a/docs/man-pages/condor_submit.rst b/docs/man-pages/condor_submit.rst
@@ -1462,6 +1462,14 @@ POLICY COMMANDS :index:`max_retries<single: max_retries; submit commands>`
     successfully taking a checkpoint.  The checkpoint will transferred
     and the executable restarted.  See
     :ref:`users-manual/self-checkpointing-applications:Self-Checkpointing Applications` for details.
+    :index:`max_checkpoint_interval<single: max_checkpoint_interval; submit commands>`
+
+ max_checkpoint_interval = <integer>
+    The number of seconds a self-checkpointing has to write out its
+    next checkpoint.  Exceeding this duration puts the job on hold.  To
+    be clear: a job has this amount of time to write out its first
+    checkpoint, each subsequent checkpoint, and to finish after its
+    last checkpoint.
     :index:`hold<single: hold; submit commands>`
 
  hold = <True | False>

diff --git a/docs/version-history/development-release-series-91.rst b/docs/version-history/development-release-series-91.rst
@@ -23,6 +23,12 @@ New Features:
   ``OpSysLongName`` is now ``"macOS 10.15"`` instead of ``"MacOSX 15.4"``.
   :jira:`627`
 
+- Added ``max_checkpoint_interval`` to the submit language.  It specifies
+  the largest permitted interval, in seconds, between checkpoints.  Exceeding
+  this interval puts the job on hold.  This command is intended to prevent
+  "stuck" self-checkponting jobs from wasting resources.
+  :jira:`650`
+
 - Improved and simplified how HTCondor locates the blahp software.
   Configuration parameter ``GLITE_LOCATION`` has been replaced by
   ``BLAHPD_LOCATION``.