Getting Started with the ABAP Test Cockpit for QMs and Admins
Administrators: Set Up, Running Checks
How do I set up the ABAP Test Cockpit for quality checking?
Here in brief is what you need to do to set up the ABAP Test Cockpit for central quality checking. You can find detailed instructions in the ATC documentation at the SAP Help Portal (help.sap.com) and also online in transaction ATC.
- Pick out an ABAP system to be the ATC master system, where you run central ATC checks and manage exemption requests. This is usually your transport consolidation or test/quality system.
- Set up ATC RFC destinations between the ATC master system and the development systems that transport code to the master system. SAP recommends using trusted RFC connections – a destination to each development system at the master system, and a destination to the master system at each development system. If you have these destinations already, then you can re-use them.
- Set up ATC users (or give existing users ATC authorizations). At the master system, you will need:
– ATC administrators, who have a derivative of role SAP_SATC_ADMIN.
– ATC QMs, who have a derivative of role SAP_SATC_QE.
– ATC developer-users with either S_DEVELOP, ACTVT 02 or 03 or, if developers should not have the right to change code on the master system, then a derivative of role SAP_SATC_XMPT_APPLICANT.
At each development system, you’ll need the same set of users. Developer users won’t need the SAP_SATC_XMPT_APPLICANT role, since they have an authorization for S_DEVELOP with AKTVT 02 and 03.
- Register your name spaces (e.g. /MY_COMPANY/) for the ATC master system. To do this, start ABAP program SATC_AC_INIT_NAMESPACE_REG on a development system. Then follow the online instructions in the program.
- Use transaction ATC to configure the master system, as shown. You can also schedule an e-mail job (for notifications about exemptions) and schedule regular ATC central check runs. See the online help for more information.
- Now configure your development systems. Log on to one of the development systems. Start transaction ATC and configure the system as shown.
- On the ATC Change Settings screen, choose Transfer data from the tool bar. SAP recommends setting up the ATC on one development system, and then replicating the configuration to the other development systems that have the same ATC master system. This is more efficient than logging on to each system in turn to do the configuration.
- The ATC has been set up on both the master system and development systems.
- You are running central ATC checks and distributing these as current active results to satellite development systems.
- The developers on your satellite systems can request exemptions against the active central ATC findings. The exemptions are managed on the master system, where they are persisted. There is no risk of exemptions being duplicated or lost.
How do I start a central run?
- Start transaction ATC on the ATC master system.
- Click on ATC Administration > Runs >Schedule Runs. Click on Create to schedule a new run series. Or mark an existing run series and click on Schedule to start a new run in the series.
- To create a run series, click Create and fill out the screen as suggested below:
- To schedule a check run in your series, mark the series in the Run Series: Browse Configurations screen and click Schedule. Then fill out the screen as suggested below:
- Press Execute to start the check run. The run is executed as a background job. To monitor the progress of the job, from the start screen of transaction ATC, choose ATC Administration > Runs > Monitor and Control Runs.
After the check run is done, the ATC distributes the result automatically to the RFC destinations that you specified. With the options shown in the screen shot, the check result is made the active result in the satellite systems. In this example we executed only one single ATC run. In a productive scenario you would schedule this run periodically as a background job.
How can I check the status of a check run? What should I do if a check run fails?
On the central system, start transaction ATC and choose ATC Administration > Runs > Monitor and Control Runs.
The display shows run status as running, finished, or failed. Usually, you can just restart a failed run. Check the log if want to see execution details and error findings.
How can I tell whether the results are complete?
If you see this icon in the ATC result, then at least one check could not be run or failed to run correctly and some findings[ZK3] may be missing:
Click on the button to see which checks and which objects were affected.
Here, a check module was interrupted by a runtime error. The ATC check run is not terminated by such a problem. You can find details about the error in the short dump in transaction ST22.
Error type Examination not Possible means that the check module shown in Check Title could not check the object shown in Object Name. The context menu Show Documentation for Check gives you more information. If you still have questions, contact the check author.
What do I do after a check run is finished?
- In transaction ATC, choose ATC Administration > Runs > Manage Results to select and display available results.
- Everything okay? If you did not distribute the results automatically to satellite development systems, then you can do so now.
Quality Managers: Analysis, Reporting, E-Mailing
How can I access the result of a check run?
In a satellite development system, start transaction SE80. If the ATC Results Browser is not shown in the browser selection, then choose Utilities > Settings. Mark ATC Result Browser on the Workbench (General) tab.
In the browser, the current result is marked with the lighted bulb.
Where do I review exemptions?
It’s best to review exemptions in the ATC master system, where they are maintained. Review and approve or disapprove exemptions by doing the following:
- In the ATC master system, start transaction ATC. Choose ATC Administration > Quality Governance > Exemption Browser.
- Select the exemption requests that have been assigned to you.
- In the list of exemption requests, double-click an exemption to open the details provided by the requestor, including the ATC finding that is to be exempted, the scope of the exemption, and explanation provided by the requestor.
- Enter your assessment of the requested exemption. Then choose from the following actions:
– Approve the request (grant the exemption, so that the ATC does not report findings covered by the exemption)
– Reject the request (the developer must correct the problem in order to clear the ATC finding)
– Return to applicant – send the exemption request back to the requestor, for example for additional information.
If you have set up your system to replicate exemptions automatically to satellite development system, then your work is done. If not, then you can replicate exemptions to the satellite systems so that they are visible there. One way to distribute exemptions is to choose ATC Administration > Configure ATC, and then choose Transfer Data. Enter the RFC destination of each satellite system, and be sure to switch Push or Pull Data to PUSH in the options screen. The admin should distribute exemptions regularly in any case.
Where are the statistics?
The ATC results display start with the list of findings. Turn the statistics display on by clicking Statistics View in the tool bar. The statistics display might look like this (for some temporary objects):
You can download statistics by selecting Print Preview (from the Print button options). Print Preview displays a list from which you can download.
How can I see the changes in findings after a re-check?
A cool new feature of the ATC results display is the delta display, which shows you what has changed after you have re-checked one or more findings in the ATC Browser in the developer transactions (SE80, SE24, SE38…).
Cleared findings are shown green, unchanged findings are yellow, new findings are red (remember, a re-check applies the relevant check to the entire object, not just the individual findings).
How about navigating back and forth in the results?
Have you done a lot of sorting and filtering in the results? Want to go back to earlier result?
A cool new feature of the ATC is that you don’t have to redo the sorts and selects. Just open the stack navigator with Display Navigation Window.
And choose the view that you want.