showjobs

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

Overview

You can run the showjobs command alone or with parameters to filter the results. If you run the command without add 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 jobs 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 ;[keys | info | logon | keys retcod] [;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 job to display.

jobnumber

Specify the job number for the job.

hhmm

The start time of the job.

deps
The jobs used in follows dependencies are displayed followed by the dependent jobs and job streams. The jobs and jobstreams are listed in the standard showjobs and standard showschedules 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 jobs used in the follows dependencies are displayed with only the job ID per line.

  • deps;info

    If you use the info option with deps parameter, the jobs are displayed in showjobs;info format. The job streams are displayed in standard showschedules format.

  • deps;logon

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

keys
When you add the option, job names are displayed one on each line. It is displayed as follows:
18b90478-324e-47e5-94c8-53d05742ac96.JOBTRALIAS
45f7f20a-8adb-449e-8a56-819b365113e8.JOB_ALIAS153031420
c3c996a4-63a3-428e-acef-4b3fe8a714af.JOB_FOLL122403044
a770ebfa-42a3-4425-886c-1c492c53dd37.JOB_FOLL122455927
2e6d6cef-46f2-4887-bad7-52167fedf356.JOB_DEFINITION_074537663
115c2e7c-0c9a-4877-9c31-3ed595f99073.JOB_DEFINITION_074537663
9fc84c91-da10-4016-9af2-29974bf33092.JOB_DEFINITION_084437252
57b4fb84-0ad1-4004-8bb2-a59343b1747d.JOB_DEFINITION_085328934
Info

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

logon

If you add this option, the job 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 job.
Example:
%sj @; keys retcod
stdlist
If you add this option the job log of each selected job 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 job name, the workstation on which the jobs are running, job 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 job.
Note: Information related to archived jobs is not recoverable by using the stdlist option.
Stdlist;keys

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

workstation

The name of the workstation on which the job runs. You can filter the jobs with wildcard characters.

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

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

showid

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

props

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

General information
  • job
  • Workstation Folder
  • Workstation
  • Task
  • Task Type
  • Job Stream Folder
  • Job Stream Workstation Folder
  • Job Stream
  • Job Stream Workstation
  • Scheduled Time
  • Priority
  • Login
  • Monitored
  • Requires Confirmation
  • Critical

Runtime Information

  • Status
  • Internal Status
  • Not Satisfied Dependencies
  • Job 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
  • Job Definition
  • Workstation Folder
  • Workstation

Additional information

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

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