Task qualifiers

You can use task qualifiers to select multiple tasks that fall under specific conditions which you can customize.

Task qualifiers are attributes of tasks and you can use the + or ~ symbol to include or exclude a specific set of tasks. If the task qualifier is prefixed with +, then all tasks with that specific attribute are selected and if the task qualifier is prefixed ~, then all tasks with that specific attribute are excluded. The attributes that you can use as a task qualifier are described below.

at

at [time | lowtime, | ,hightime | lowtime,hightime]

You can add this option to select or exclude the tasks that are defined with at keyword. You can specify the time as, hhmm[+n days | date] [timezone|tz tzname] where,
  • hhmm: Specifies the time in hours and minute.
  • +n days: Specifies the next occurrence of the task in terms of days.
  • date: Specifies the next occurrence of the task in terms of mm/dd/[yy].
  • timezone|tz tzname: Specifies the time zone. For more information, see Managing time zones.

lowtime,: You can specify the lower limit of a time range and in this scenario the upper limit is considered as 12:00 PM. All the tasks that are scheduled to start within this time range is selected. The time limit must be specified in hhmm format.

,hightime: You can specify the upper limit of a time range and in this scenario the lower limit is considered as 12:00 AM. All the tasks that are scheduled to start within this time range is selected. The time limit must be specified in hhmm format.

lowtime,hightime: You can specify both the upper and lower limits of a time range. If you add this limit with + symbol, all the tasks that are scheduled to start within this time range are selected. If you add this limit with ~ symbol, all the tasks that are not scheduled to start within this time range and all the tasks that do not have an at parameter are selected. The time limit must be specified in hhmm format.
Important: If you want to select tasks that will start at a specific time, add the time in hhmm format without the comma (,).

If you add at without any of these parameters, all the tasks that are defined with the at keyword are selected.

confirmed

confirmed: If you add this option, all the tasks that are scheduled with the confirm keyword are selected.

deadline

deadline [time | lowtime, | ,hightime | lowtime,hightime]

You can add this option to select or exclude tasks that are defined with deadline keyword. You can specify the time as, hhmm[+n days | date] [timezone|tz tzname] where,
  • hhmm: Specifies the time in hours and minute.
  • +n days: Specifies the next occurrence of the task in terms of days.
  • date: Specifies the next occurrence of the task in terms of mm/dd/[yy].
  • timezone|tz tzname: Specifies the time zone. For more information, see Managing time zones.

lowtime,: You can specify the lower limit of a time range and in this scenario the upper limit is considered as 12:00 PM. All the tasks with a deadline within this time range is selected. The time limit must be specified in hhmm format.

,hightime: You can specify the upper limit of a time range and in this scenario the lower limit is considered as 12:00 AM. All the tasks with a deadline within this time range is selected. The time limit must be specified in hhmm format.

lowtime,hightime: You can specify both the upper limit and lower limit of a time range. If you add this limit with + symbol, all the tasks that are completed within this time range are selected. If you add this limit with ~ symbol, all the tasks that are not completed within this time range and all the tasks that do not have a deadline parameter are selected. The time limit must be specified in hhmm format.
Important: If you want to select tasks that have a specific deadline, add the time in hhmm without the comma (,).

If you add deadline without any of these parameters, all the tasks that are defined with the deadline keyword are selected.

every

every [rate | lowrate, | ,highrate | lowrate,highrate]

You can add this option to select or exclude tasks that are defined with every keyword. The keyword is used to define the repetition rate for a task. You can specify the rate in hhmm format.

lowrate,: You can specify a value for the repetition rate in hhmm format. All the tasks with a repetition rate, equals to and above that specified rate are selected.

,highrate: You can specify a value for the repetition rate in hhmm format. All the tasks with a repetition rate, equals to and below that specified rate are selected.

lowrate,highrate: You can specify a value for the repetition rate in hhmm format. All the tasks with a repetition rate within this range are selected.

If you add every without any of these parameters, all the tasks that are defined with the every keyword are selected.

started

started [time | lowtime, | ,hightime | lowtime,hightime]

You can add this option to select or exclude tasks that have already started. You can specify the time as, hhmm[date] [timezone|tz tzname] where,
  • hhmm: Specifies the time in hours and minute.
  • date: Specifies the next occurrence of the task in terms of mm/dd/[yy].
  • timezone|tz tzname: Specifies the time zone. For more information, see Managing time zones.

lowtime,: You can specify the lower limit of a time range and in this scenario the upper limit is considered as 12:00 PM. All the tasks that have started within this time range is selected. The time limit must be specified in hhmm format.

,hightime: You can specify the upper limit of a time range and in this scenario the lower limit is considered as 12:00 AM. All the tasks that have started within this time range is selected. The time limit must be specified in hhmm format.

lowtime,hightime: You can specify both the upper limit and lower limit of a time range. If you add this limit with + symbol, all the tasks that are started within this time range are selected. If you add this limit with ~ symbol, all the tasks that are not started within this time range and all the tasks that do not have a started parameter are selected. The time limit must be specified in hhmm format.

If you add started without any of these parameters, all the tasks that have started are selected.

state

State state [,..]]

You can select or exclude tasks based on the status. The valid statuses are given below.
  • ABEND
    The task ended abnormally.
  • ABENP
    The ABEND confirmation is received but the task is not completed.
  • DONE
    The task is completed with an unknown status.
  • EXEC
    The selected task is running.
  • FAIL
    An error prevented the task from starting.
  • HOLD
    The workflow is waiting for the dependency to be resolved.
  • INTRO
    The task will launch at any moment.
  • PEND
    The task is completed and waiting for confirmation.
  • READY
    All dependencies are resolved, and the workflow is ready to start.
  • SUCC
    The task is completed successfully.
  • SUCCP
    The task is not completed, but the confirmation is received.
  • SUPPR
    The task is suppressed because the related conditional dependencies of the predecessors are unresolved.
  • WAIT
    The task is in waiting.

until

until [time | lowtime, | ,hightime | lowtime,hightime

You can add this option to select or exclude tasks that are defined with until keyword, which is the scheduled end time for a task. You can specify the until time as, hhmm[+n days | date] [timezone|tz tzname] where,
  • hhmm: Specifies the time in hours and minute.
  • +n days: Specifies the next occurrence of the task in terms of days.
  • date: Specifies the next occurrence of the task in terms of mm/dd/[yy].
  • timezone|tz tzname: Specifies the time zone. For more information, see Managing time zones.

lowtime,: You can specify the lower limit of a time range and in this scenario the upper limit is considered as 12:00 PM. All the tasks that are scheduled to end within this time range is selected. The time limit must be specified in hhmm format.

,hightime: You can specify the upper limit of a time range and in this scenario the lower limit is considered as 12:00 AM. All the tasks that are scheduled to end within this time range is selected. The time limit must be specified in hhmm format.

lowtime,hightime: You can specify both the upper limit and lower limit of a time range. If you add this limit with + symbol, all the tasks that are scheduled to end within this time range are selected. If you add this limit with ~ symbol, all the tasks that are not scheduled to end within this time range and all the tasks that do not have an until parameter are selected. The time limit must be specified in hhmm format.
Important: If you want to select tasks that are scheduled to end at a specific time, add the time in hhmmformat without the comma (,).

If you add until without any of these parameters, all the tasks that are defined with the until keyword are selected.