Managing custom jobs

Custom jobs are jobs that you developed from a new or existing ETL (Extract, Transform, and Load) .ttl file.

For details on creating custom jobs, see Wiki page.

Predefined jobs, also referred to as out-of-box jobs, are jobs that are packaged with the product. You can use these predefined jobs as samples when you develop your own custom jobs. The predefined jobs are located inside the com.ibm.rational.datacollection.service.jar file in the following directory:

<installation directory>/server/conf/dcc/sites/dcc-updatesite/plugins/

For example:
C:\Program Files\ibm\JazzTeamServer\server\conf\dcc\sites\dcc-updatesite\plugins\com.ibm.rational.datacollection.service_<version>.jar

If you want to view the predefined jobs, copy the com.ibm.rational.datacollection.service.jar to a temporary location outside of the product, and use an extraction tool to decompress the .jar file. You can find the predefined jobs in the /mapping directory inside the .jar file.

Procedure

Loading jobs
To load all the predefined (out-of-box) jobs and any jobs in the Data Collection Component mapping directory:
1. If you want to run a job that you developed (custom job), you must add the custom .ttl job files in the Data Collection Component mapping directory. This directory is at <installation directory>/server/conf/dcc/mapping. For example, place your custom .ttl job files into the following directory: C:\Program Files\ibm\JazzTeamServer\server\conf\dcc\mapping.
2. In the Data Collection Jobs page, click Load Jobs.
3. Wait a few minutes for the jobs to load. You can refresh the web browser multiple times until all your jobs display in the Data Collection Jobs page.
Remember: Each time Load Jobs is clicked, by default all the predefined jobs gets loaded with its default settings. In addition, any jobs in the Data Collection Component mapping directory also gets loaded.
Removing jobs
1. In the Data Collection Jobs page, locate the job that you want to remove.
2. Under the Schedule column, hover and click the Delete data collection job icon ().
Remember: If you click Load Jobs, your job removal selection might not persist. The Load Jobs action causes by default all the predefined jobs to get loaded with its default settings. In addition, any jobs in the Data Collection Component mapping directory are also loaded. The mapping directory is located in the <installation directory>/server/conf/dcc/mapping directory, for example: C:\Program Files\ibm\JazzTeamServer\server\conf\dcc\mapping.
Selecting jobs
1. In the Data Collection Jobs page, select the checkbox for each data collection job that you want to run.
2. If you select a checkbox for a data collection job that is by default clear, a window pops up confirming if you are sure that you want to enable the job. The reason for the confirmation is because running this job can impact the performance of the corresponding applications and the overall time to collect data.
Remember: If you click Load Jobs, your job selection might not persist. The Load Jobs action causes by default all the predefined jobs to get loaded with its default settings. In addition, any jobs in the Data Collection Component mapping directory are also loaded. The mapping directory is located in the <installation directory>/server/conf/dcc/mapping directory, for example: C:\Program Files\ibm\JazzTeamServer\server\conf\dcc\mapping.