Managing Jobs

Objective

After completing this lesson, you will be able to work with jobs

Using the Job Browser

The Job Browser and the Action Log are job managing tools for the PIT tool.

In the job browser you have access to all jobs carried out in the PIT tool, whereas, in the action log, the jobs are already prefiltered either for the test system, the test case, or the test data set.

All potentially long running jobs, such as data extraction, test execution and test verification, are carried out by background jobs.

Up to version SAP NetWeaver 7.5 SP17, all PIT jobs were processed by a periodical run of a JobHandlerJob . The JobHandlerJob is a task scheduled in the NWA Java scheduler (it is scheduled as part of CTC Configuration Wizard PI Test Tool) and handles the following jobs:

Handled Jobs for SP17

  • Executer Job
  • Verification Job
  • Extractor Job
  • Execution Task
  • Verification Task
  • Test Suite Task

For SP17, the job handling was updated to offer more flexibility and better test automation support.

The tasks use the test case run configuration and the test suite run configuration as a configuration entity. The tasks are created as soon as a run configuration or a test suite run configuration is scheduled, or if a run configuration is executed directly. A task is directly scheduled in the NWA and bypasses the JobHandlerJob.

You access the job browser by selecting the Job Browser tab. It shows an overview of all jobs executed. You can access the job log for a particular job by modifying the filters accordingly. You can either enter a text in the input field or call the menu, and select a filter option.

In the figure above, you can see the filter options in the job browser.

You may want to execute specific operations. In this case, choose a job from the list, right-click on it to open the menu, and select the appropriate operation.

Job Operations

  • Show the job log details (choose from the Job Browser menu or from the context menu of a job). In this case, the job log details are retrieved from the NetWeaver Administrator as all jobs are managed by the NWA.

    Note

    The retention time for job log details is set to 23 days. After this period, the details are no longer available.
  • Trigger a verification run (choose from the context menu of a job).
  • Show the results of the verification run (choose from the context menu of a Verification job). Choosing this operation takes you to the overview page of the verification run.
  • Cancel a specific job (choose from the context menu of a job).

Action Log

The action log view shows jobs grouped by test runs or datasets. The filter options correspond to those of the job browser.

You open the action log view by right-clicking on a test case, a test system, or a data set in the test case editor, and select Show Action Log () from the context menu.

By default, the jobs are displayed grouped by test runs, but you can also group them by dataset. You can filter them as in the job browser.

Opening detailed views:

  • Double-clicking a test run opens an editor showing the basic information.
  • Double-clicking an extractor job takes you to the corresponding dataset in the test case editor.
  • Double-clicking a verification job opens the verification results editor.

You can also delete jobs. Even multi-selection is supported, but:

Restrictions for job deletion

  • Extractor jobs cannot be deleted and deleting a test run deletes all the corresponding verifications jobs as well.
  • If the server version is older then the client version, the Show Action Log menu item will appear disabled.

Log in to track your progress & complete quizzes