rerun
You must have rerun access to the job.
To
use streamlogon|logon, docommand, or script arguments, you must have
submit access to the job.
To use the
from argument, you must have submitdb access to the job.
Syntax
{rerun | rr} jobselect
[;from=[wkstat#]job
[;at=time]
[;pri=pri]]
[;sameworkstation=]
[;step=step]
[;streamlogon|logon=new_logon]
[;docommand="new_command"|;script="new_script"]
[;noask]
Arguments
- jobselect
- See Selecting jobs in commands. Wildcards are supported.
- from=[wkstat#]job
- Specifies the name of a job defined in the database whose job file or command will be run in
place of the job specified by jobselect.
You can rerun jobs also in the SUPPR state, as long as they do not belong to job streams that are in the cancelled or suppressed state
.
- wkstat#
- Specifies the name of the workstation on which the from job runs. The default is the workstation on which conman is running.
- job
- Specifies the name of the from job definition The following types of job names are not
permitted:
- The names of jobs submitted using the submit file and submit docommand commands.
- The alias names of jobs submitted using the submit job command.
The recovery options, if any, are partly inherited from the original job definition and partly retrieved from the from job. Table 1 describes the criteria by which recovery options in the original and from job definition are retrieved.
Table 1. Recovery options retrieval criteria recovery option Inherited from original job Retrieved from "from" job stop No Yes continue No Yes rerun Yes No repeatevery Yes No for Yes No after Yes No abendprompt Yes No To use the from argument, you must have access to the database from the computer on which you are running conman
- at=time
- Specifies the rerun job's start time, expressed as follows:
hhmm [timezone|tz tzname] [+n days | date]
where:
- hhmm
- The hour and minute.
- +n days
- The next occurrence of hhmm in n number of days.
- date
- The next occurrence of hhmm on date, expressed as mm/dd[/yy].
- timezone|tz tzname
- The name of the time zone of the job. See Managing time zones for valid names.
- pri=pri
- Specifies the priority to be assigned to the rerun job. If you do not specify a priority, the job is given the same priority as the original job.
sameworkstation
If the parent job ran on a workstation that is part of a pool or a dynamic pool, you can decide whether it must rerun on the same workstation or on a different one. This is because the workload on pools and dynamic pools is assigned dynamically based on a number of criteria and the job might be rerun on a different workstation.
When you rerun the job manually, the sameworkstation setting you define with the rerun command is applied only to the instance you rerun, and is ignored in any subsequent reruns of that instance. For example, also if the job you rerun already contains rerun information (defined with the rerun, repeatevery, and for arguments in the job definition) the sameworkstation setting you define with the rerun command applies only to the specific instance you rerun. For the subsequent reruns, the setting defined in the job definition is used. For more information about arguments in the job definition, see Job definition.
- step=step
- Specifies that the job is rerun using this name in place of the original job name. See Comments for more information.
streamlogon|logon=new_logon
Specifies that the job is rerun under a new user name in place of the original user name. This argument applies only to completed jobs.
docommand="new_command"
Specifies the new command that the rerun job runs in place of the original command. This argument is mutually exclusive with the script argument. This argument applies only to completed jobs.
script="new_script"
Specifies the new script that the rerun job runs in place of the original script. This argument is mutually exclusive with the docommand argument. This argument applies only to completed jobs.
- noask
- Specifies not to prompt for confirmation before taking action on each qualifying job.
Comments
You can rerun jobs that are in the SUCC, FAIL, or ABEND state. A rerun job is placed in the same job stream as the original job, and inherits the original job's dependencies. If you rerun a repetitive (every) job, the rerun job is scheduled to run at the same rate as the original job.
![Start of change](../../delta.gif)
![End of change](../../deltaend.gif)
When ;from is used, the name of the rerun job depends on the value of the Global Option enRetainNameOnRerunFrom. If the option is set to Y, rerun jobs retain the original job names. If the option is set to N, rerun jobs are given the from job names. For more information, refer to the IBM Workload Scheduler Administration Guide.
In conman displays, rerun jobs are displayed with the notation >>rerun as. To refer to a rerun job in another command, such as altpri, you must use the original job name.
...
MPATH=ˋmaestroˋ
STEP=ˋ$MPATH/bin/jobinfo job_nameˋ
if [$STEP = JOB3]
then
...
STEP=JSTEP1
fi
if [$STEP = JSTEP1]
then
...
STEP=JSTEP2
fi
if [$STEP = JSTEP2]
then
...
fi
...
In conman displays, jobs rerun with the ;step option are displayed with the notation >>rerun step.
For information about jobinfo, see jobinfo.
Examples
rr main#sked1.job4
rr sked2.job5;from=jobx;at=1830;pri=25
rr sked4.job3;step=jstep2
See also
- In the Welcome page, select Monitor your workload, or in the navigation bar at the top of the page, click .
- Select an engine.
- In Object Type, select Job.
- From the Query drop-down list, select All Jobs in plan or another task to monitor jobs.
- Click Run to run the monitoring task.
- From the table containing the list of jobs, select a job and click Rerun....