DMT - Techno - SAP

Techno - SAP

Use this option ONLY if you are using the legacy CAST SAP Extractor (version 7.0.3 or earlier) to extract the SAP tables/programs.

If you are using the new generation CAST SAP Extractor (version 8.0.0 or higher), then you cannot use this option and you should use the Others > Files on your system option instead.

The SAP option is designed to connect to a SAP instance and extract and package SAP tables and programs for analysis.

However, you must first ensure that the CAST SAP extractors are already installed and configured on your SAP instance - otherwise the CAST Delivery Manager Tool cannot execute them and package the items you require. You can find out more information about installing and configuring the SAP extractors in the CAST SAP Extractor Admin Guide (see http://doc.castsoftware.com).

Note:
- the SAP instance does not need to be available during the analysis process in the CAST Management Studio because the CAST Delivery Manager Tool will extract the SAP tables and programs and package them before deployment to a specific location (defined in the CAST Management Studio).

Each section in this panel is explained separately:

Manage SAP Connection

This section enables you to configure the connection to your SAP instance:

SAP host name	Use this field to configure the host name of your SAP instance. You can also enter an IP address if required.
System number	Use this field to configure you SAP instance's system number.
Client number	Use this field to configure you SAP instance's client number.
SAP registered connection (TCP/IP) name	Use this field to enter the RFC Destination of your target SAP instance. By default, this is set to SAPJ2EE (which is the default in SAP itself), however, you can change this if your RFC Destination is named differently.
Credentials	User name	Use this field to configure the user name that has sufficient privileges to access the required data on the selected SAP instance for packaging purposes.
	Password	Used to configure the password that corresponds to your User name configured above.
	Remember password	This option enables you to force the CAST Delivery Manager Tool to save the SAP instance access credentials you have entered above. Choosing an option or not has no impact on the extraction (i.e. the CAST Delivery Manager Tool can still access the required resources). However, if you are creating subsequent Versions of data on the same SAP instance, you can choose to store the password in which case you will not need to re-enter it. There are two save options: Local > The credentials are saved in the user's local workspace on the current machine. Choose this option if you do not want the password to be available to other Delivery Managers. Server > The credentials are saved locally (as above) and are also synchronized back to the CAST AIC Portal (i.e. the Source Code Delivery Folder). Choose this option if you want the password to be available to other Delivery Managers.

ABAP programs extraction

This section enables you to configure the CAST Delivery Manager Tool to extract the SAP/ABAP packages you require:

Packages tab

Use this tab to specify the Packages you want to extract:

Package From	Use this option to specify the Packages you want to extract and package: If you want to extract a range of Packages, use this option in conjunction with the Package To option below. If you want to extract a specific Package, enter the package name in this field and leave the Package To option empty. You can then specify complete names (used in conjunction with the "equal" operator) or patterns (used in conjunction with the "contains" operator). For example: = : expected name must match exactly with the pattern x (contains) : expected names contain the pattern It is important to know that the custom code is differentiated from the built-in code by the standard naming convention: 'Y' and 'Z' programs will be extracted 'SAPY' and 'SAPZ' function pools will be extracted
Package To	Use this option in conjunction with the Package From option to specify a range of packages for extraction. You can specify complete names (used in conjunction with the "equal" operator) or patterns (used in conjunction with the "contains" operator).
Packages to exclude	Use this option to specify Packages you do not want to extract and package. You can specify complete names (used in conjunction with the "equal" operator) or patterns (used in conjunction with the "contains" operator).
Check existence of package	If you want the extractor to check the existence of packages associated to ABAP components, then activate this option. The default value is OFF and the extractor will not verify the existence of package in the TDEVC table.
Extract dependent includes	If you would like to automatically extract include files that are used by the programs referenced in extraction criteria (package, name, transport), then activate this option. This will ensure that the code is fully extracted even if some of the includes do not match the selection criteria.

Date Management

Use this tab to filter the Packages you have selected in the Packages tab based on creation and modification date:

Creation date from YYYYMMDD	Use these options to filter your selected Packages based on their creation and/or modification dates: If you want to extract Packages created and /or modified between specific dates, use this option in conjunction with the Creation/Modification date to option below. If you want to extract specific Packages from a specific creation and/or modification date, enter the date in this field and leave the Creation/Modification date to option empty. Enter the date in the format YYYYMMDD.
Creation date to YYYYMMDD
Modification date from YYYYMMDD
Modification date to YYYYMMDD

Transport options

Use this tab to manage specific Transport options for the extraction process:

Transport Request	Use this option to extract source code corresponding to Transport Requests. You can specify one or several transport requests directly in the field.
Transport Request File	Use this option to extract source code corresponding to Transport Requests - contrary to the Transport Request option, the Transport Requests can be listed in an external file located in the default SAP directory on the application server. This file must contain one transport request per line and each line must have two parts separated by a semicolon ( ; ) . The first part is the transport request name and the second part is the associated description.
Extract last Transport Request ID	Use this option to force the extractor to fetch and extract the last Transport Request ID that was used. Note that activating this option can significantly increase the required extraction time.

SAP tables extraction

This section enables you to configure the CAST Delivery Manager Tool to extract the SAP/ABAP tables you require:

Packages tab

Use this tab to specify the Packages you want to extract - package names can be used as criteria for extracting tables.

Package From

Use this option to specify the Packages you want to extract and package:

If you want to extract a range of Packages, use this option in conjunction with the Package To option below.
If you want to extract a specific Package, enter the Package name in this field and leave the Package To option empty.
If you want to extract multiple specific Packages in a list, enter the list of Package names separated by ";".

You can then specify complete names (used in conjunction with the "equal" operator) or patterns (used in conjunction with the "contains" operator). For example:

= : expected name must match exactly with the pattern
x (contains) : expected names contain the pattern

It is important to know that the custom code is differentiated from the built-in code by the standard naming convention:

'Y' and 'Z' programs will be extracted
'SAP*Y' and 'SAP*Z' function pools will be extracted

Package To

Use this option in conjunction with the Package From option to specify a range of Packages for extraction. You can specify complete names (used in conjunction with the "equal" operator) or patterns (used in conjunction with the "contains" operator).

Packages to exclude

Use this option to specify Packages you do not want to extract and package. You can specify complete names (used in conjunction with the "equal" operator) or patterns (used in conjunction with the "contains" operator).

Table names tab

Table Name From

Use this option to specify the Tables you want to extract and package:

If you want to extract a range of Tables, use this option in conjunction with the Package To option below.
If you want to extract a specific Table, enter the Table name in this field and leave the Package To option empty.
If you want to extract multiple specific Tables in a list, enter the list of Tables names separated by ";".

You can then specify complete names (used in conjunction with the "equal" operator) or patterns (used in conjunction with the "contains" operator).

Table Name To

Use this option in conjunction with the Package From option to specify a range of Tables for extraction. You can specify complete names (used in conjunction with the "equal" operator) or patterns (used in conjunction with the "contains" operator).

Options tab

Objects per packet	This option defines how many Tables are extracted into one output file. By default this option is set to 10000. This option should only be changed if you are suffering from out of memory issues in the SAP instance, or a particular Table is so enormous (in terms of the number of columns) that it causes the output files to become extremely large.
Tables	These options are selected by default. They ensure that both tables and views will be extracted and packaged. CAST recommends leaving these options activated unless you do not want to extract a specific type.
Views
Extract number of rows	The CAST table extractor can extract the number of rows for each extracted table if this option is activated. You can also choose to extract (default) or not the number of rows for client-dependent tables (Include client-dependent tables option). Results are saved into an XML file ("SAP_tables_volume.SQLTABLESIZE") in the same directory as other generated files. This file can then be used in the SAP Analysis Unit editor - Source Settings tab (in the CAST Management Studio) to insert Table Row information for further exploitation in the CAST Health Dashboard/CAST Engineering Dashboard.
Include client-dependent tables
Tables to exclude from counting file	This option enables you to define a text file (located on disk) that contains a list of Tables (one Table name on each line of the text file) that the extractor must include in the line count. This file is used for extreme cases of corrupted SAP databases where Tables are referenced in the SAP system whereas they no longer exist. If such a table exists, the extractor will error when counting the lines and will crash on old SAP systems that do not manage specific exceptions.

Extraction folders

SAP server extraction directory mapping	Enter the full path to extraction location on the SAP server. Usually this is a mapped Windows drive to the SAP directory.
SAP server extraction relative directory	Enter the relative path (from the SAP root working directory) to the SAP server where extraction will be done as a ZIP file (used for background or batch mode).