Skip to content

Commit

Permalink
fixup! rfc43: add new RFC for job list service
Browse files Browse the repository at this point in the history
  • Loading branch information
chu11 committed Jan 11, 2024
1 parent 6acf208 commit af5304d
Showing 1 changed file with 28 additions and 46 deletions.
74 changes: 28 additions & 46 deletions spec_43.rst
Original file line number Diff line number Diff line change
Expand Up @@ -197,53 +197,35 @@ Constraint Operators
Using the constraint syntax described by RFC31, jobs can be filtered
based on the following constraint operators.

.. list-table::
:header-rows: 1
- ``userid``: Designate one or more userids (*integer) and match jobs
submitted by those userids.
* - Operator
- Values
- Value Encoding
- Description
* - userid
- one or more userids
- integer
- match jobs submitted by userids
* - name
- one or more job names
- string
- match jobs with job names
* - queue
- one or more queues
- string
- match jobs submitted to job queues
* - states
- one or more job states (bitmask of multiple states also allowed)
- string or integer
- match jobs in job states
* - results
- one or more job results (bitmask of multiple results also allowed)
- string or integer
- match jobs with job results
* - | t_submit
| t_depend
| t_run
| t_cleanup
| t_inactive
- one timestamp prefixed with ">", "<", ">=", or "<="
- string
- match jobs if the respective timestamp is greater than, less than, greater than or equal, or less than or equal to specified value
* - not
- one constraint object
- constraint object
- Logical negation of constraint object
* - or
- one or more constraint objects
- constraint object
- Logical or of constraint object(s)
* - and
- one or more constraint objects
- constraint object
- Logical and of constraint object(s)
- ``name``: Designate one or more job names (*string) and match jobs
with those job names.
- ``queue``: Designate one or more queues (*string*) and match jobs
with those job queues.

- ``states``: Designate one or more job states (*string* or *integer*)
and match jobs in those job states. Both bitmasks (including
multiple states) and string names of the states SHALL be accepted.

- ``results``: Designate one or more job results (*string* or *integer*)
and match jobs with those results. Both bitmasks (including
multiple results) and string names of the results SHALL be accepted.

- ``t_submit``, ``t_depend``, ``t_run``, ``t_cleanup``,
``t_inactive``: Designate one *string* to compare the respective
timestamp with. The string SHALL be prefixed with ">", "<", ">=",
or "<=" and followed with a timestamp value. Jobs will be matched
if the respective timestamp is greater than, less than, greater
than or equal, or less than or equal to specified value.

- ``not``: Logical negation of one constraint object.

- ``or``: Logical or of one or more constraint objects.

- ``and``: Logical and of one or more constraint objects..

The following are several constraints examples.

Expand Down

0 comments on commit af5304d

Please sign in to comment.