Skip to content

Commit 77396df

Browse files
authored
Directives: don't display bad practice (#746)
Don't display bad practice about using directives equivalent to ETL
1 parent 1989876 commit 77396df

File tree

1 file changed

+13
-2
lines changed

1 file changed

+13
-2
lines changed

src/user-guide/task-implementation/job-submission.rst

Lines changed: 13 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -47,6 +47,16 @@ For :term:`job runners <job runner>` that use job file directives (PBS, Loadleve
4747
etc.) default directives are provided to set the job name, stdout and stderr
4848
file paths, and the execution time limit (if specified).
4949

50+
.. tip::
51+
52+
Use :cylc:conf:`[runtime][<namespace>]execution time limit` to set
53+
time limits, rather than setting this as a directive yourself.
54+
55+
This allows Cylc to identify execution timeout even if the
56+
job runner cannot be contacted.
57+
58+
See :ref:`ExecutionTimeLimit`
59+
5060
Cylc constructs the job name string using a combination of the task ID and the
5161
workflow name. PBS fails a job submit if the job name in ``-N name`` is
5262
too long. For version 12 or below, this is 15 characters. For version 13, this
@@ -70,7 +80,7 @@ line:
7080

7181
.. code-block:: none
7282
73-
-l=select=28:ncpus=36:mpiprocs=18:ompthreads=2:walltime=12:00:00
83+
-l=select=28:ncpus=36:mpiprocs=18:ompthreads=2
7484
7585
(Left hand side is ``-l``. A second ``-l=...`` line will override the first.)
7686

@@ -82,7 +92,6 @@ Or separate the items:
8292
-l ncpus=36
8393
-l mpiprocs=18
8494
-l ompthreads=2
85-
-l walltime=12:00:00
8695
8796
.. note::
8897

@@ -247,6 +256,8 @@ according to its job runner.
247256
Tasks can be killed on demand by using the ``cylc kill`` command.
248257

249258

259+
.. _ExecutionTimeLimit:
260+
250261
Execution Time Limit
251262
--------------------
252263

0 commit comments

Comments
 (0)