Workflow qualifiers

You can use workflow qualifiers to select workflows that fall under specific categories which you can customize.

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

at

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

You can add this option to select or exclude the workflows 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 workflow in terms of days.
  • date: Specifies the next occurrence of the workflow 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 workflows 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 workflows 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 task 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 workflows 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 workflows that are defined with the at keyword are selected.

finished

finished [time | lowtime, | ,hightime | lowtime,hightime]

You can add this option to select or exclude workflows that are finished. You can specify the time as, hhmm[date] [timezone|tz tzname] where,
  • hhmm: Specifies the time in hours and minute.
  • date: Specifies the date 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 workflows that are finished 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 workflows that are finished 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 finished within this time range are selected. If you add this limit with ~ symbol, all the tasks that are not finished within this time range and all the tasks that do not have a finished parameter are selected. The time limit must be specified in hhmm format.

If you add finished without any of these parameters, all the workflows that are finished are selected.

follows

follows [[folder/]workstation#][folder/]{jobstreamname[hhmm [mm/dd[/yy]]][.job | @] | jobstream_id.job;schedid}| job[,...] [if 'condition_name[| condition_name][| ...]']

You can add this option to select or exclude the workflows that are defined with follows keyword. For more information about the syntax to be used, see follows. If you add this option without any of these parameters, all the workflows that are defined with the follows keyword are selected.

limit

limit [limit | lowlimit, | ,highlimit | lowlimit,highlimit]

You can use this option to select or exclude workflows based on the number of tasks available in a workflow.
  • limit: You can specify the number of tasks and all workflows with task equal to that specific value are displayed.
  • lowlimit,: You can specify the lower limit of a range and all workflows with tasks equal to and above that specific value are displayed.
  • highlimit,: You can specify the upper limit of a range and all workflows with tasks equal to and below that specific value are displayed.
  • lowlimit,highlimit,: You can specify both the upper limit and lower limit of a range and all workflows with tasks within that value are displayed.

started

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

You can add this option to select or exclude workflows 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 date 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 workflows 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 workflows 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 task that are started within this time range are selected. If you add this limit with ~ symbol, all the task that are not started within this time range and all the task 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 workflows that have started are selected.

state

State state [,..]]

You can select or exclude workflows based on the status. The valid statuses are given below.
  • ABEND

    A malfunction has ended the workflow.

  • CANCELP

    The workflow cancellation is pending. The workflow is cancelled when all the dependencies are resolved.

  • EXEC

    The workflow is in progress.

  • HOLD

    The workflow is waiting for dependencies to resolve.

  • READY

    All dependencies of the workflow are resolved and the tasks are ready to start.

  • STUCK

    The workflow run is interrupted. The tasks in the workflow cannot start without the user intervention.

  • SUCC

    The workflow finished successfully.

  • SUPPR

    The workflow is suppressed because the related conditional dependencies are not resolved.

until

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

You can add this option to select or exclude workflows that are defined with until keyword, which is the scheduled end time for a workflow. 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 workflow in terms of days.
  • date: Specifies the next occurrence of the workflow 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 workflows 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 workflows 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 task that are scheduled to end within this time range are selected. If you add this limit with ~ symbol, all the task that are not scheduled to end within this time range and all the task that do not have an until parameter are selected. The time limit must be specified in hhmm format.
Important: If you want to select workflows 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 job streams that are defined with the until keyword are selected.