Panaya

Code Extraction
Tool
Setup Guide

Version: 4.10
Panaya Code Extraction Tool Setup Guide February 2011

Table of Contents
Introduction.......................................................................................................................3
Getting Support .................................................................................................................3
Prerequisites ......................................................................................................................3
Setup Procedure ................................................................................................................3
Step 1 – Download and Install Panaya Code Extraction Tool ..............................4
Step 2 – Defining RFC Connection to Production System ...................................7
Step 3 – Extracting the Custom Code and Usage Data ......................................10
Step 4 – Uploading Results to Panaya Web site .................................................12
What Happens Now? ......................................................................................................14
Appendix A – How to Install ABAP program ................................................................15
Frequently Asked Questions…………………………………………………………...16

Important Notice

This document is subject to the following conditions and restrictions:

This functional description contains proprietary information belonging to Panaya Inc. No part
of its contents may be used for any other purpose, disclosed to any person or firm or reproduced
by any means, electronic or mechanical, without the explicit prior written permission of Panaya
Inc. The text and graphics are for the purpose of illustration and reference only.The
specifications on which they are based are subject to change without notice. Information in this
functional description is subject to change without notice. All Panaya and other company and
brand products and service names are trademarks or registered trademarks of their respective
holders.

Copyright ©2011 Panaya Inc. All rights reserved.

2
Panaya Code Extraction Tool Setup Guide February 2011

Introduction
Panaya solution requires an installation of software component on your SAP systems.
This software component performs the following tasks:
 Extraction of custom developed ABAP code.
 Identification and extraction of used transactions - finding out which
transactions are used in your production system.

Getting Support
The installation process was designed with simplicity and ease in mind. However if you
require assistance during the installation, please contact Panaya support at
[email protected]

Prerequisites
Before starting the installation process, make sure you have the following privileges:
1. Access to your SAP Development QA and Production system
2. User with development permissions allowed to:
o Display SAP standard program source code
o Creating and executing programs using RFC to Production system
(required RFC permissions described in Step 2)
o Running jobs
3. A Panaya user name and password.
4. Internet Explorer browser versions 6, 7 & 8.

Setup Procedure
The setup procedure consists of following steps:
1. Download and install Panaya code extraction tool from Panaya web site.
2. Execute the program on your SAP system.
3. Uploading the result (XML file) to Panaya web site.

3
Panaya Code Extraction Tool Setup Guide February 2011

Step 1 – Download and Install Panaya Code Extraction Tool

In this step you will download and install Panaya‟s ABAP code extraction tool on your
SAP system.

The code extraction tool reads the repository objects locally and extracts customer
developed objects from the system it runs on. The program also uses an RFC
connection to extract current usage statistics from the production system.

Choosing the right system to extract your custom objects

Panaya analysis is based on custom objects extracted from your system. Because we are
extracting the custom developed objects only from one instance. In most cases, there
are differences between objects in the development system and the production system.
Please choose the system that is best representing your needs for analysis.

Should you require assistance defining from which system in your landscape you
should extract the custom code, our support team will be happy to any questions you
may have. Please contact our support team at: [email protected]

Download Panaya Code extraction tool

1. Login to Panaya website at https://my.panayainc.com

2. Enter your login details. Make sure you use your registered e-mail address as a
user ame & the password you received from Panaya.
3. Click the System Setup tab.

4
Panaya Code Extraction Tool Setup Guide February 2011

4. From the Select System dropdown list, select the desired system.

5. Click on the Code Extraction Tool link.

5
Panaya Code Extraction Tool Setup Guide February 2011

6. Choose the appropriate source code by pressing on the radio button beside the
SAP version currently implemented. Notice it takes time for the ABAP code to
get populated before you copy it to your clipboard.
Use the busy mouse cursor as an indication to when the code had finished its
population.

7. Select the source code presented in the screen to your SAP system and press the
Copy to Clipboard button.
8. Save it under a new program name ZPANAYA_EXTRACT_PROG_LIB as
executable program.
9. Save the program in a change request, should you need to execute it on other
systems like QA or Production.

Detailed instruction on how to create executable program in SAP system can be

found in Appendix A.

6
Panaya Code Extraction Tool Setup Guide February 2011

Step 2 – Defining RFC Connection to Production System

In this step you will define RFC connection to your Production system. This connection
is needed to extract usage statistics information.

You should always use RFC connection when running Panay‟s code extraction tool,
even if you choose to execute the program directly on your Production system.

Defining RFC Connection

1. Start transaction SM59 (configuration of RFC connection).

2. Press the create button in the upper tool bar.
3. In the new window fill the following values:

Field Value
RFC Destination PANAYA_PRD
Connection Type 3 (ABAP connection)
Description 1 PANAYA_PRD

4. Under the Technical Setting tab, fill the following values:

Field Value
Target Host Type your PRD system host
name or number
System Number Your PRD system number

7
Panaya Code Extraction Tool Setup Guide February 2011

5. Under the Logon & Security setting tab, fill the following values:

Field Value
Language English (EN)
Client PRD client number
User & Password System user name and
password

6. Test you‟re connection by pressing the „Connection Test‟ button.

7. Test the validity of the user you defined by pressing the „Remote Logon‟ button.

Important Note: When running Panaya‟s code extraction tool, there may be cases
in which the user you choose for the RFC connection will not have all the required
permissions to extract the necessary data.

8
Panaya Code Extraction Tool Setup Guide February 2011

The authorizations required for the RFC user

Object S_RFC (Authorization Check for RFC Access):

• RFC_TYPE (type of RFC object to be protected) – „FUGR‟
• RFC_NAME (name of RFC to be protected) – „SDTX‟, „STUW‟,
'BDCH', „SRTT‟, „SRFC‟, „THFB‟,‟SIFP‟
• ACTVT (Activity) – „16‟

Object S_TABU_DIS (Table Maintenance via standard tools such as SM30):

• DICBERCLS (Authorization Group) = ‟PC‟, ‟SS‟, ‟SC‟, „SA‟,‟&NC&‟
• ACTVT (Activity) = „3‟

Object S_DEVELOP (ABAP Workbench):

• ACTVT (Activity) = „3‟
• DEVCLASS (Development class for Transport) =‟*‟
• OBJNAME (Object name) = „*‟
• OBJTYPE (Object type) =‟*‟
• P_GROUP (Authorization group ABAP/4 program) = „*‟

9
Panaya Code Extraction Tool Setup Guide February 2011

Step 3 – Extracting the Custom Code and Usage Data

In this step you will use the program ZPANAYA_EXTRACT_PROG_LIB to extract
the custom developed objects from your SAP system and usage statistics information.

Extracting Custom Objects

1. Login to the system you choose to run Panaya‟s code extraction tool.
2. Start transaction SE38.
3. Type the program name ZPANAYA_EXTRACT_PROG_LIB and press the
execute button (F8).
4. In the selection screen, choose the Foreground option (automatically marked).

5. Open the file path screen and select the destination on the client
machine in which the custom code file will be saved.
6. The suffix of the file needs to be „.xml‟.
7. Choose the RFC ‘PANAYA_PRD’ that was defined in step 2.
8. The period for extracting the usage transaction data is automatically defined
inside the program and will extract one year back (if the data exist in the
production system).
9. Leave the “Usage Only” check box unchecked.
10. Run the program by pressing the execute button (F8).

Please note:
1. The program normally runs between 45 minutes to two hours, depending
on the extent of custom objects developed in your system.

2. If running in foreground mode is not possible (e.g. receive a timeout

message), you can choose the background mode. This will save the file
on the SAP application server in the designated path.

01
Panaya Code Extraction Tool Setup Guide February 2011

To Run the Process in Background Mode Choose

1. Define the directory, in which the file will be saved. Prepare 3GB
of free space.
2. Press the Background option in the selection screen.
3. Enter the directory path.
4. Choose from the menu: Program  execute in background…and create
immediate job (you can review the job processed in SM37)

Extracting Only Usage Statistics Data

By using the “Usage only” mode, the program enables to extract ONLY usage statistics
data without extracting other custom developed objects. For extracting only usage date,
the program can be executed on any of the existing SAP systems in the landscape but
always require an RFC connection to the system were the require data exists (Normally
the Production system).

This process should be performed by special request and not as regular code extraction
process. For any questions you may have, please contact Panaya support at:
[email protected]

1. Set the program to be executed in foreground or background mode.

2. Define RFC connection to the production system (or other system).
3. Mark the “Usage Only” check box.
4. Execute the program.

00
Panaya Code Extraction Tool Setup Guide February 2011

Step 4 – Uploading Results to Panaya Web site

In this step you will upload the output file created in step 3 to Panaya web site.

Important note: all information you upload to Panaya via its web site is encrypted
using SSL technology. More information about Panaya security can found at
http://www.panayainc.com/Products-Technology/Security-Privacy.html

1. Compress the file that you saved from step 3 into a Zip archive file (please use
standard ZIP format and not any other formats).
2. Enter your account at Panaya web site at https://my.panayainc.com
3. Click on the System Setup tab.

4. From the Select System dropdown list, select the desired system.

02
Panaya Code Extraction Tool Setup Guide February 2011

5. Press the „Upload custom code‟ link.

6. The Upload Custom Code File screen displays table with lists of projects.

03
Panaya Code Extraction Tool Setup Guide February 2011

The left column displays the currently active projects that will be affected by the
custom code to be uploaded. The right column displays the projects that will not
be affected.
Make sure to consult the project managers that their projects are potentially
affected before you upload the code extraction results.
7. In the upload page, press the „Browse’ button and select the Zipped file that you
created for the custom code.
8. Click the „Continue’ button.
The upload process takes time to complete and is transferred to Panaya through
FTP.

9. After the file is uploaded successfully to Panaya, you should receive a

confirmation message with a ticket number.

What Happens Now?

After performing steps 1-4, Panaya start analyzing your company custom code and
inform you when the results are ready to be used.
The results should be available to you in 48 hours or less.

For any questions or problems please contact our support team at:
[email protected]

Panaya Support Team

04
Panaya Code Extraction Tool Setup Guide February 2011

Appendix A – How to Install ABAP program

To install the above program, login to your SAP development system and perform the
following steps:

Creating new development class

Create a new Development class for Panaya ABAP program:

1. Start Transaction SE80
2. Choose in the drop-down menu window the object type Development class/
Package.
3. Type the Development class/package name ZPANAYA and press Enter.
4. Press “Yes” to create a new development class/package.
5. Choose a transport layer and press “Save”.

To create Executable ABAP program, follow the procedure below:

1. Start transaction SE38.

2. Type the program name in the "Program" field and press "Create".
3. Enter the program name as "Title", set the "Type" as "Executable program" and
press Enter or "Save".
4. When prompted for Development class/package, choose the Development
class/package ZPANAYA and press “Save”.
5. If prompted for change request enter a workbench change request or create one.
6. Press the button above the editor or choose from the menu:
Utilities More UtilitiesUpload/DownloadUpload…
7. Choose the appropriate text file that you saved and press "Open".
8. Activate the program by pressing the button or choose from the menu
ProgramActivate.

05
Panaya Code Extraction Tool Setup Guide February 2011

Frequently Asked Questions

1. Question: I have security concerns about what the Panaya program might extract
from my system.
Answer: The Panaya extraction tool extracts only technical objects; it does not
extract any customer or transactional data (orders, accounts, financial, records. etc.).
The objects that the program extracts are: development class, function groups,
transactions, custom developed programs, data elements, table types, user exits and
modifications. In addition, Panaya uses an RFC connection to your production
system to extract usage statistics information (transactions, RFC) that is only
available in the production system. This information is extracted from the
performance workload monitor reports (Transaction ST03N).
This process is NOT a system copy; it is only an extraction of technical objects that
allows Panaya to simulate your system structure, without the need to have a direct
connection to any of your SAP systems, in order to perform our analysis and
present our findings.
The output of the extraction process is a large XML file that you can review before
you upload it to Panaya.

2. Question: I am unable to log in to Panaya. I always bounce back to the login

screen. No error message appears.
Answer: When logging in to Panaya, make sure that your “user name” is the valid
e-mail address that you used when you registered at Panaya. Some users enter their
SAP user name by mistake, and that causes the login to fail.

3. Question: I am unable to log in to Panaya. I receive the error message “Failed to

Login user.”
Answer: When logging in to Panaya, make sure that you manually enter your
password instead of copying it to the clipboard and pasting it into the password
field.
If you do not remember your password, and to avoid having your account locked,
you can reset it by clicking on the link on the login page: “Account Locked/Reset
Password.” Alternatively, you can ask your account manager to reset it for you.

4. Question: Due to security restrictions, I cannot point the RFC to my real

production system, only to a copy of it. I get the following error message: “RFC
destination PANAYA_PRD doesn‟t point to Production System. Please choose
another RFC destination that points to Production.” (message no. CONV000)
Answer: When directing the RFC destination to a copy of your production system,
put this line in comment: “DONT_SHOW_ERROR_ON_RFC TYPE C VALUE
SPACE.” It appears in the code extraction program as presented below:
* Show error for not Production RFC. To turn off the error
* please set the SPACE to 'X' as follows:
* DONT_SHOW_ERROR_ON_RFC TYPE C VALUE 'X'. Enable this line – remove the comment
DONT_SHOW_ERROR_ON_RFC TYPE C VALUE SPACE. Disable the line – add a comment *

06
Panaya Code Extraction Tool Setup Guide February 2011

5. Question: When logging in to Panaya, I receive the error message “Your account is
locked.” How do I unlock it?
Answer: You can unlock your account and reset the password by clicking on the
link on the login page: “Account Locked/Reset Password.”
This should open a new screen. Insert your valid e-mail address (that you used
when registering at Panaya) and confirm. Within a few minutes you should receive
an e-mail with instructions. Follow them carefully.

6. Question: I am unable to connect the RFC to production. As a result, the code

extraction program does not include the necessary usage. What should I do?
Answer: To connect to production through RFC, you need to have authorizations
that are detailed in the setup guide (see page 9). If you do not have the sufficient
authorizations, you could ask your SAP Basis (or admin) to run the Panaya program
in “Usage Only” mode (see explanation on page 11) and upload both output files to
Panaya.

7. Question: When should I extract the code in “Usage Only” mode?

Answer: The “Usage Only” mode is used for extracting the usage statistics from
the production server it connected to through RFC. It could be used in several
situations, for example:
 When the development system is connected to more than one production
system. In that case, extract the usage in “Usage Only” mode from each
production system and upload all to Panaya.
 When the development system and production system are not connected
through RFC, and the code extraction has to run once on each system as
“Usage Only” mode on the production system.
 If Panaya requested that you upload an additional “Usage Only” file to
aggregate it into the existing analysis to improve its results.

8. Question: What should I check before uploading the code extraction results to
Panaya?
Answer: Open the generated XML file and verify that:
 The file has a header, starting with:
<?xml version="1.0" encoding="UTF-8"?>
<ROOT_ELEMENT>
 That the file has a suffix:
</ETL_MESSAGES>
</ROOT_ELEMENT>
Zip the file using a standard zip program (make sure this is not RAR or
7-zip). Do not protect the zipped file with a password and do not zip it
more than once.
Be sure to wait for the upload to finish and indicate an upload ID.

07