Defining a Job

Note  This content applies to the Windows Logo Kit (WLK). For the latest information using the new Windows Hardware Certification Kit (HCK), see Windows HCK User's Guide on the Windows Hardware Dev Center.

Jobs can be complex, and the procedure for creating a job differs depending on the role of the job. This topic contains a procedure for creating the basic structure of a job. Within the procedure, links are provided to topics that explain how to create the parts of a job that differ depending on the job role.

Before you create a job, refer to the exploring the job information tabs topic to make sure you do not duplicate an existing job.

To create a job

Note  This content applies to the Windows Logo Kit (WLK). For the latest information using the new Windows Hardware Certification Kit (HCK), see Windows HCK User's Guide on the Windows Hardware Dev Center.

1. Switch to the Job Explorer window.

   You can also open a new Job Explorer window by clicking Explorers, and then clicking Job Explorer.

2. Select your DTM controller from the drop-down box in the upper left of the Job Explorer window.

3. Expand the nodes in the Feature pane until you locate the node you want to add the new job to.

   Note   If you want to create the job in a new feature node, first create the new feature node, and then create the job. See How Jobs Are Organized for instructions to create a new feature node.

4. Right-click the node you want to add the new job to, and then select New Job.

   The New Job window is displayed.

5. Enter a name for the job in the Job Name box.

6. In the Role box, select one of the following roles for the job that you are creating:

   • Automated if this job, or parts of this job, can be done by executing a command at the command prompt on the client computer.

   • Configuration if this job sets a value for a dimension.

   • Library if other jobs can use this job.

   • Manual if this job must be performed by a person.

   Note   An automated job can contain manual tasks. Select Automated if parts of the job can be accomplished without user intervention. Select Manual only if the entire job must be done by a person. Manual jobs are rare.

7. In the Is Active box, select True if you want users to be able to execute the job. If you select False, the job will be saved, but users will not be able to execute it.

8. To define parameters that you can pass to tasks within the job, see Job Parameters.

9. In the Description tab in the lower pane, type a description of the job. Since this job can be run by other users, it is helpful to provide a description so that others know what the job does.

10. To restrict the client computers that this job can run on, see Specifying Which Computers A Job Can Run On.

11. Use the appropriate procedure to finish creating the job.

    If this is an automated job, add tasks to the job by using the procedure in the topic Defining Tasks.

    If this is a configuration job, continue creating the job by using the procedure in the topic Creating a Configuration Job.

    If this is a library job, continue creating the job by using the procedure in the topic Creating a Library Job.

    If this is a manual job, continue creating the job by using the procedure in the topic Creating a Manual Job.

12. Click Save () to save the job.

Optional job information

In addition to the values that DTM uses, a job can also contain information that you can use either to document the job or to make it easier to search and filter all jobs. This information has no effect on how the job behaves; it is merely descriptive.

The optional values that you can set are:

• Assigned to : The DTM user name of the person that the job is assigned to. By default, this is the user name of the person who created the job.

• Priority : The level of importance of the job. Valid values are 0, 1, 2, or 3.

• Expected Runtime : The amount of time, expressed in days, hours, and minutes, that you expect the job to run.

• Keywords : Any string of text that you will use for grouping or documenting the job.

• Text1, Text2 : Any string of text that you will use for grouping or documenting the job.

• Int1, Int2 : Any integer that you will use for grouping or documenting the job.

• URL : The address of a Web site that is relevant to the job. If a URL is provided for the job, you can right-click the job in Job Explorer, and then click Go To Feature Site to open the Web page identified by the URL.

For more information about searching jobs, see How Jobs Are Organized.

Build date: 9/14/2012