Creating a job template
When you create a job template, you can choose the job's characteristics. You need not recreate the job template criteria each time you want to create another job instance based on the template.
Once you create a job instance from a job template, the two are no longer tied together. You can modify the characteristics of a job instance without affecting the template on which the job is based, and you can update the template without affecting the characteristics of a job instance you have already created.
You choose the following characteristics for the job template: Menu group, Menu entry, and Menu description. Once you create the template, these characteristics enable you to identify it from among all other existing templates. For example, consider a scenario in which a user creates a Database Restore template for use on company databases related to inventory. The user makes the following choices regarding menus:
Menu group Database Maintenance Menu entry DB Restore Inventory Menu description DBrestore for all inventory dbs
Once the job template is created, the template appears, as shown in Figure 8–9.
Figure 8–9: New job template in Create Custom Job page
![]()
The new job template DBRestoreInventory menu entry appears in the Database Maintenance menu group with the DBrestore Inventory db only menu description.
You specify each Fathom job template's properties and characteristics on two pages. The first template page defines the properties of the job. On the second page, you provide default values for the job instance; however, you can change these values, such as the schedule, for each instance.
To create a job template:
- From the Fathom Jobs page, click Create Job Template. The first of two Job Template pages appears:
![]()
- In the Name field, enter the job template name. Note that the name must be unique among the job templates. Note also that spaces are not allowed in the name fields on this page.
The menu group is the heading under which the new template will appear (for example, Database Maintenance).- In the Menu group field, enter the name of the new menu group; or choose an existing menu group in the Existing field. (When you choose an existing group, the name automatically appears in the Menu group field.)
- In the Menu entry field, enter the template name you want to appear on the Custom Job page.
- In the Menu description field, enter a brief description of the job template. This description appears on the list of available job templates on the Create Custom Job page, under the template name you provide in Step 4.
- Under the Limit how many databases can be associated with the job field, select one, two, or no limit of databases. No limit is the default value.
- Click Save. The second of two Job Template pages appears, as shown below, with the Name field prefilled:
Entering the User name is optional; if you do not supply a user name, any job instance created based on this template is run under the account Fathom is running under. Entering a password is required only if you also enter a user name; otherwise, it is optional. For details about any other field, see the "Creating a job instance" section.- Provide the properties.
- Click Save. The job template summary appears:
You can now edit or copy the template's characteristics, delete the template, or schedule a job instance to run based on the template.
![]()
- After you specify the properties that you want to default to each instance created from this template, you can then:
- Click Edit at the bottom of the page directly to the right of the Completion Actions and Alerts field to continue entering values. The Job Completion Actions and Alerts page appears. This page allows you to define default action and alert occurrences for each job instance created from this template. See the "Setting up job completion actions and alerts" section for details.
If you want to set additional values for job actions and/or alerts, you can access the Job Completion Actions and Alerts page and perform these tasks at a later time by editing the Job page. You can also initiate the job immediately by clicking Run Now on the Job summary page.- Click Save at the top of the page to conclude entering values for the job template. The Job summary page appears.
Choosing the job template schedule
When you create a job template, you also determine the schedule you want job instances created from the template to use.
Setting up a schedule for a template is very similar to setting up a schedule for a job instance. However, you cannot enable a schedule at the template level. To create schedule data, complete the Job Schedule page, as shown in Figure 8–10. Then see the "Scheduling a job" section for more information.
Figure 8–10: Job template schedule
![]()
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |