JobRun

Overview

Associated with a Job is JobRun. Job Run is used to monitor and assign status, and take actions (e.g. cancel, rerun) based on the current status.

JobRun Type

Currently supported job run types include:

  • FTPJobRun
  • JobGroupRun
  • MPEJobRun
  • OS400JobRun
  • OSJobRun
  • OVMSBatchRun
  • OVMSCommandRun
  • OVMSJobRun
  • ServiceJobRun

JobRun is the base of TES 6.2 job run types. The FTPJobRun, JobRunGroup, MPEJobRun, OS400JobRun, OSJobRun, OVMSCommandJobRun, OVMSJobRun and ServiceJobRun objects are derived from JobRunand and share a common base structure.

Typical Operations

  • Assign status
  • Cancel
  • Cancel all
  • Hold
  • Override a JobRun instance
  • Override a JobDependency instance
  • Release
  • Remove
  • Rerun

REST API Examples

From the browser, issue and then click Manual Commands (Post) to take you to the API post screen of the Client Manager. You can test the REST API examples from that screen. For valid parameters and successful execution of a request, you will get a response/result. For invalid parameters and unsuccessful execution of a request, you will get error messages and/or exceptions.

Example JOBRUN–1: Override JobRun instance

The JobRun object provides a method called override. The parameter called id (e.g. 120) specifies the JobRun instance to be overridden. The following REST API call will override JobRun 120.

<?xml version="1.0" encoding="UTF-8"?>
<entry xmlns="http://purl.org/atom/ns#">
<id>xxx</id>
<tes:JobRun.override xmlns:tes="http://www.tidalsoftware.com/client/teservlet">
<tes:id>120</tes:id>
</tes:JobRun.override>
</entry>

Example JOBRUN–2: Override JobDependency instance of a JobRun

The JobRun object provides a method called overrideDependency . The method has two parameters. The first parameter called id (e.g. 124) specifies the JobRun instance. The second parameter called jobrundepid (e.g. 40)specifies the JobDep (Job dependency) instance. The following REST API call will override JobDependency 40 of JobRun 124.

<?xml version="1.0" encoding="UTF-8"?>
<entry xmlns="http://purl.org/atom/ns#">
<id>1</id>
<tes:JobRun.overrideDependency xmlns:tes="http://www.tidalsoftware.com/client/teservlet">
<tes:id>124</tes:id>
<tes:jobrundepid>40</tes:jobrundepid>
</tes:JobRun.overrideDependency>
</entry>

Example JOBRUN–3: Cancel a job run

The JobRun object provides a method called cancel .

<?xml version="1.0" encoding="UTF-8"?>
<entry xmlns="http://purl.org/atom/ns#">
<id>1</id>
<tes:JobRun.cancel xmlns:tes="http://www.tidalsoftware.com/client/teservlet">
<tes:id>xxx</tes:id>
</tes:JobRun.cancel>
</entry>

Example JOBRUN–4: Set status of a job run

The JobRun object provides a method called assignStatus .

<?xml version="1.0" encoding="UTF-8"?>
<entry xmlns="http://purl.org/atom/ns#">
<id>1</id>
<tes:JobRun.assignStatus xmlns:tes="http://www.tidalsoftware.com/client/teservlet">
<tes:id>xxx</tes:id>
<tes:status>status_value</tes:status>
</tes:JobRun.assignStatus>
</entry>