showjobs

You can use the showjobs command to view the information about tasks.

Overview

You can run the showjobs command alone or with parameters to filter the results. If you run the command without any parameters the results are displayed in the standard format. For more information, see Standard format. The following parameters are used to view the results in six formats:
  • keys
  • info
  • logon
  • keys retcod
  • deps
  • stdlist
You can further filter the deps format by using the following options:
  • keys
  • info
  • logon
You can also use the wildcards to filter the tasks and the folders that contains their definitions. For more information, see Special characters as wildcards and delimiters.

Syntax and command line options

You can run the command as follows:
  • ocli plan showjobs | sj jobselect ;[deps[keys | info | logon]] ;[short | single] [;showid] [;props]
  • ocli plan showjobs | sj jobselect ;[info | logon | keys retcod] [;short | single] [;showid]
  • ocli plan showjobs | sj jobselect ;keys [;extended][;short | single][;showid]
  • ocli plan showjobs | sj jobselect |[[folder/]workstation#]jobnumber.hhmm] ;stdlist ;[short | single] [;showid] [;props]
The details that are required with each parameter is as follows:
jobselect
Specify the task to display.
jobnumber
Specify the task number for the task.
hhmm
The start time of the task.
deps
The tasks used in follows dependencies are displayed followed by the dependent tasks and workflows. The tasks and workflows are listed in the standard showjobs and standard showsched format. You can use the keys, info and logon options to further filter the results.
  • deps;keys

    If you use the keys option with deps parameter, the tasks used in the follows dependencies are displayed with only the task ID per line.

  • deps;info

    If you use the info option with deps parameter, the tasks are displayed in showjobs;info format. The workflows are displayed in standard showsched format.

  • deps;logon

    If you use the logon option with deps parameter, the jobs are listed in the showjobs;logon format. The workflows are listed in the standard showsched format.

keys
If you add this option, task names are displayed with the workflow ID. It is displayed as follows:
18b90478-324e-47e5-94c8-53d05742ac96.TASKTRALIAS
45f7f20a-8adb-449e-8a56-819b365113e8.TASK_ALIAS153031420
c3c996a4-63a3-428e-acef-4b3fe8a714af.TASK_FOLL122403044
a770ebfa-42a3-4425-886c-1c492c53dd37.TASK_FOLL122455927
2e6d6cef-46f2-4887-bad7-52167fedf356.TASK_DEFINITION_074537663
115c2e7c-0c9a-4877-9c31-3ed595f99073.TASK_DEFINITION_074537663
9fc84c91-da10-4016-9af2-29974bf33092.TASK_DEFINITION_084437252
57b4fb84-0ad1-4004-8bb2-a59343b1747d.TASK_DEFINITION_085328934
  • keys;extended
    If you add the extended option with keys, the following information is also displayed:
    • Workstation name
    • Workflow name
    • The scheduled date and time to run the task.
Info

If you add this option, the task details are displayed in the info format. For more information, see info format.

logon

If you add this option, the task details are displayed in the logon format. For more information, see Logon format.

retcod
You can use this option with keys parameter. The command displays the return code for the task.
Example: 
ocli plan %sj @; keys retcod
stdlist
If you add this option the task log of each selected task is displayed in the stdlist format. You can customize the contents displayed in the result, by adding the keys option. The following information is displayed:
  • Header and trailer banners: The header contains task name, the workstation on which the tasks are running, task number, date (mm/dd/yy or mm/dd format), and time. The trailer displays information such as Exit Status, Elapsed Time, date and time.
  • The output of the task.
Note: Information related to archived tasks is not recoverable by using the stdlist option.
Stdlist;keys

On each line, the names of the standard files for the selected tasks are listed.

workstation

The name of the workstation on which the task runs. You can filter the tasks with wildcard characters.

short
The display is reduced for every and rerun tasks to include the details described below:
  • The first iteration
  • Tasks in different states
  • Exactly matched tasks.
Note: The field displays specific properties, if the task is defined in JSDL.
single

You can add this option to view the specific instance of a task. You must identify the tasks by task number with a jobselect value.

showid

If you add this option, the result will show the task ID.

props

If you have display access to the props of the specified task and use this option with the command, then the following information is displayed.

General information
  • Task
  • Workstation Folder
  • Workstation
  • Task
  • Task Type
  • Workflow Folder
  • Workflow Workstation Folder
  • Workflow
  • Workflow Workstation
  • Scheduled Time
  • Priority
  • Login
  • Monitored
  • Requires Confirmation
  • Critical

Runtime Information

  • Status
  • Internal Status
  • Not Satisfied Dependencies
  • Task Number
  • Rerun Options
  • rerun on the same workstation
  • Information
  • Promoted
  • Return Code
  • Return Code Mapping Expression
  • Successful output conditions
  • Other output conditions

Time Information

  • Actual Start
  • Earliest Start
  • Latest Start
  • Latest Start Action
  • Maximum Duration
  • Maximum Duration Action
  • Minimum Duration
  • Minimum Duration Action
  • Critical Latest Start
  • Deadline
  • Deadline Action
  • Repeat Range
  • Actual Duration
  • Estimated Duration
  • Confidence Interval

Recovery information

  • Action
  • Message
  • Task Definition
  • Workstation Folder
  • Workstation

Additional information

The additional properties that are specific to tasks defined by JSDL are displayed in this section.

Restriction:
  • You cannot recover the information on archived tasks by using props option.
  • When the output of a task is displayed, the task definition and the output conditions are not displayed.