Reference > System URLs > Scheduler URLs
EditJob URL
This command modifies an existing job currently being run by the scheduler.
URL structure
- http:// host_name/path/
- The fully qualified name of the WebSphere Commerce Server and the configuration path.
name-value pair with the &
character. For a detailed description of the parameters and their values, see the list entitled Parameter values." />
Parameter values
- langId
- Sets or resets the preferred language for the duration of the session; the supported languages for a store are found in the STORELANG table.
- URL
- Required: The URL to be called when the command completes successfully.
- name
- The user on whose behalf the scheduler runs the job. This parameter is pulled from the LOGONID column in the USERREG table.
- pathInfo
- The WebSphere Commerce command that executes for this job, for example: SendTransactedMsg
- queryString
- The parameters of the command that is to be run. All special characters, such as &, =, /, and ?, must be encoded.
- start
- Required: The time at which the first running of this job should occur, in the format: YYYY:MM:DD:HH:MM:SS; only the values HH:MM:SS are mandatory.
- host
- The name of the host allowed to run this job. If this parameter is omitted, the job can be run by any host. This parameter is only needed if the scheduler is running on multiple hosts and if a job needs to be restricted to one of them. The host name should be in the following form: name
- interval
- The number of seconds between successive runs of this job. If this parameter is omitted, the job is only run once.
- attempts
- The number of times that the scheduler retries the job, if it fails. This parameter should be used together with the delay parameter. Both parameters must be present to re-try the job.
- delay
- The number of seconds before a failed job is retried. This parameter should be used together with the attempts parameter. Both parameters must be present to re-try the job.
- schedulePolicy
- Specifies the policy to be used by the scheduler when the job has failed
to run more than once. Two possible values are defined:
- 0 - The job is run only once and the next
run is scheduled for the future; this is the default.
- 1 - The job is run as many times as necessary to recover all missed runs.
- 0 - The job is run only once and the next
run is scheduled for the future; this is the default.
- priority
- The number associated with the priority of this job. This value will be inserted into the SCCPRIORITY column of the SCHCONFIG table. A greater number indicates a higher priority job.
- applicationType
- The type of application used to run the job being added. The purpose of this parameter is to constrain resource-intensive jobs to a limited number of threads. The application types, and the rules governing their access to resources, are defined by the user in the XML server configuration file. The default application type is null.
- JobId
- Required: The reference number of the scheduled job.
- checkCmdId
- The task command that implements the CheckForWorkCmd interface used to determine whether the command needs to be executed.
- storeId
- The store that owns the scheduled job.
Example
The following example edits a job with a reference number of 10001 and with a specified start time:
http://myhostname/webapp/wcs/stores/servlet/EditJob?start=2000:07:15:14:15:20:00:00 &pathInfo=InterestItemDisplay&URL=basemall.jsp&name=login999&queryString=listId%3D &jobId=10001
Behavior
- Verifies that all required given input exists.
- Retrieves configuration values from the SCHCONFIG table, if any values are not specified in the request.
- Calls the RemoveJob command passing
the request properties.
- Calls the AddJob command passing the
request properties.
- Returns the URL result.
Exception conditions
Missing required parameters, invalid parameter values.
Related concepts
Related tasks
Edit the configuration for a scheduled job
Edit the configuration for a scheduled store-level job
Related reference