Creating schedules
When a process is associated with a schedule on a grid, the process runs automatically in accordance with that schedule. You use BMC Atrium Orchestrator Development Studio to create the schedule.
To create a new job
- In the BMC Atrium Orchestrator Development Studio Project Navigator, expand the module that contains the process that will use the schedule.
- Double-click schedule.
- In the Schedule tab, click Add.
- In the Create a new job wizard, type a description of the job in the Description field, and then click Next.
This description is displayed in the job scheduler in BMC Atrium Orchestrator Development Studio and in the Grid Manager schedule.
The job schedule has a Start, a Frequency, and a Stop component. - In the Job Schedule window, enter the Start value:
A 24-hour time format is used for scheduling. There are two start time options.- The job starts as soon as the module is activated on the grid.
You enter the time for the module to start in 24-hour format.
Note
If you enter a time in the past, the module starts the schedule based on that time and executes at the next appropriate time according to the other schedule parameters.
Select a Frequency option:
Run every sets the frequency in minutes and seconds. You can use this option with either Start option (from the previous step).
Run once every sets the frequency in hours, days, weeks, or months. You can use this option only with a designated Start time.
Select a Stop option:
Run forever sets the job to run without a defined termination point.
Stop on sets a specific date and time at which to stop the job. Use the MM/DD/YYYY format to set the value.
After N runs sets a fixed number of occurrences for the job.
Click Next.
On the Job Configuration page, enter the information as indicated in the following table:
Field
Description
Job Name
Specifies the name of the job. The name must be unique within the module. Job names can consist of alphanumeric characters, spaces, parentheses, and underscores.
Peer Location
Specifies the peer on which the process should run. If the value is different from the value specified in the process properties, the value in the schedule takes precedence.
any: specifies that the process can run on any peer in the grid. The master job processor will distribute the process to the next available peer.
this: specifies that the process runs on the peer that has the master job processor
best: specifies that the grid must determine on the best peer to run the process
peer: you specify the peer on which the process will run
Peer Name
Specifies the name of the peer. This field is required when you select peer in the peer location option. The peer name must match a peer on the grid on which the module is activated.
Process ID
Required. Specifies the process executed by this job. Use the Select button to browse the processes in this module and select the process to be scheduled.
A process is listed in the process browser only if the Expose Process in Rules property was selected for that process in the Process Properties dialog box or in the New Process dialog box.
Input Parameters
If there are any input parameters assigned to the selected process, these fields specify the input parameters. Select a type and a value for the parameters. The type can be string, numeric, date, or XML. Input parameters with a red check mark are required. To save the job, you must provide a value for each required parameter.
You must press Enter after each input parameter.
If you change the input parameters in the Start activity of the process after you create the schedule job, you must open the job and edit it to reflect the changes.
Click Finish.
Job scheduling options and expected results
Start | Frequency | Stop | Results |
---|---|---|---|
at module activation | Run every XX minutes XX seconds | Run forever | Job starts immediately when the module or adapter activates and runs at selected frequency forever. |
at module activation | Run every XX minutes XX seconds | Stop on MM/DD/YYYY HH:MM:SS | Job starts immediately when the module or adapter activates and runs at selected frequency until designated stop time. |
at module activation | Run every XX minutes XX seconds | After N runs | Job starts immediately when the module or adapter activates and runs N times at the frequency selected. |
at module activation | n/a | After 1 run | Job starts immediately when the module activates or adapter and runs once. The frequency options are not available. |
Start on MM/DD/YYYY HH:MM:SS | Run every XX minutes XX seconds | Run forever | Job starts at designated time and runs at selected frequency forever. |
Start on MM/DD/YYYY HH:MM:SS | Run once every | After N runs | Job starts at designated time and runs N times at the frequency selected. |
Start on MM/DD/YYYY HH:MM:SS | n/a | After 1 run | Job starts at designated time and runs once. The frequency options are not available. |
Note
You can use Grid Manager to edit existing jobs and to add new jobs. However, those changes are not visible in BMC Atrium Orchestrator Development Studio.
After a job finishes because of the specified Stop option, it is no longer available in Grid Manager. If you created the job in BMC Atrium Orchestrator Development Studio, you can review and edit it in BMC Atrium Orchestrator Development Studio even after it has finished.
Comments
Log in or register to comment.