cancel sched

Cancels a job stream.

You must have cancel access to the job stream.

Syntax

{cancel sched | cs} jstreamselect
     [;pend]
     [;noask]

Arguments

jstreamselect
See Selecting job streams in commands.
pend
Cancels the job stream only after its dependencies are resolved.
noask
Specifies not to prompt for confirmation before taking action on each qualifying job stream.

Comments

If you cancel a job stream before it is launched, it does not launch. If you cancel a job stream after it is launched, the jobs that have started complete, but no other jobs are launched.

If you do not use the ;pend option, jobs and job streams that are dependent on the cancelled job stream are released immediately from the dependency.

If you use the ;pend option and the job stream has not been launched, cancellation is deferred until all of its dependencies, including an at time, are resolved. Once all dependencies are resolved, the job stream is cancelled and any dependent jobs or job streams are released from the dependency. During the period the cancel is deferred, the notation [Cancel Pend] is listed in the Dependencies column of a showschedules display.

If you include the ;pend option and the job stream has already been launched, any remaining jobs in the job stream are cancelled, and any dependent jobs and job streams are released from the dependency.

To immediately cancel a job stream marked [Cancel Pend], either enter a release command for the job stream or enter another cancel command without the ;pend option.

To stop evaluating dependencies, set the job stream's priority to zero with the altpri command. To resume dependency evaluation, set the priority to a value greater than zero.

If the cancelled job stream contains jobs defined with the every option, only the last instance of such jobs is listed as canceled in a showjobs display.

Examples

To cancel job stream sked1(1200 02/17/06) on workstation site2, run the following command:
cs=site2#sked1(1200 02/17)
To cancel job stream mis2(0900 02/19/06) if it is in the STUCK state, run the following command:
cs mis2(0900 02/19)+state=stuck

See also

From the Dynamic Workload Console you can perform the same task as follows:
  1. In the navigation bar at the top, click Monitoring and Reporting > Workload Monitoring > Monitor Workload.
  2. Select an engine.
  3. In Object Type, select Job Stream.
  4. From the Query drop-down list, select All Job Streams in plan or another task to monitor job streams.
  5. Click Run to run the monitoring task.
  6. Select a job stream and click More Actions > Cancel.