Defining Tasks

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.

Automated, configuration, and library jobs contain tasks that perform the work of the job. The procedure for adding tasks is the same for each type of job. See Basic Task Concepts for more information about tasks.

To define a task

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. Create or edit a job.

  2. In the bottom pane of the New Job window, select the Tasks tab.

  3. Select the Setup, Regular, or Cleanup tab to define tasks that run in the setup, regular, or cleanup phases, respectively. The procedure for adding tasks is the same for all of these phases.

  4. Select one of the following orders that the tasks should run in:

    • Execute these tasks sequentially, in the order given below: Only one task in the job will run at a time. The tasks will run in the order in which they are listed in the job.

      Note   If you run the job on more than one client computer, multiple tasks might execute simultaneously on different computers, but only one task will execute at a time on any individual client computer.

    • Execute these tasks in parallel: All of the tasks are executed simultaneously.

    • Execute these tasks according to custom dependencies: The tasks are executed based on an order that you define. For more information about creating custom dependencies, see Executing Tasks in a Custom Order.

  5. Click Add.

  6. In the Task Type dialog box, select the type of task that you want to create:

    • Execute: This task will execute any valid command that you could type at a command prompt.

    • Copy File: This task will copy files from a source location to a location on the client computer.

    • Copy Result: This task will copy files from a location on the client computer to a destination location.

    • Run Job: This task will run a library job.

    • Manual Prompt: This task will display a message to the user on a client computer and wait for the user to respond.

  7. Click OK.

  8. In the Add Task Details dialog box on the General tab, type a name for the task.

  9. In the Failure Action box, select one of the following actions that you want to happen if the task fails:

    • FailAndContinue: If this task fails, other tasks will continue to run, but the job itself will fail.

    • FailAndStop: If this task fails, then any remaining setup and regular tasks will be canceled, any cleanup tasks will run, and the job will fail.

    • FailStopFreeze: If this task fails, any task within this job that is currently running will be stopped and no new tasks will be started. The client computer's status will be set to Debug.

    • IgnoreFailAndContinue: If this task fails, the rest of the tasks in the job will still run. The failure of this task will not affect the success or failure of the job itself.

  10. Use the appropriate procedure to finish creating the task.

    If this is an execute task, continue creating the task by using the procedure in the topic Creating an Execute Task.

    If this is a copy file task, continue creating the job by using the procedure in the topic Creating a Copy File Task.

    If this is a copy result task, continue creating the job by using the procedure in the topic Creating a Copy Result Task.

    If this is a run job task, continue creating the job by using the procedure in the topic Creating a Run Job Task.

    If this is a manual prompt task, continue creating the job by using the procedure in the topic Creating a Manual Prompt Task.

  11. Repeat this procedure beginning at step 5 to define the other tasks in this phase.

  12. Repeat this procedure beginning at step 3 to add tasks to the other job phases.

 

 

Build date: 9/14/2012