Starting the Program Online
The RBDLS2LS program converts a logical system name, which has already been defined in the system, to a new name. This program converts a logical system name, which has already been defined in the system, to a new name. The program determines all relevant tables for the conversion, and converts the corresponding entries.
Note the following:
- It is not possible to convert logical system names in a productive system.
- While the conversion program is running, no other activities can be executed in the system, including communication with other systems.
- All IDocs in the system must be processed, because the logical system name could be contained in the IDoc data record. Logical system names within IDoc data records are not taken into account in conversion.
- The conversion takes place in the current client. In some circumstances, the logical system name may also need to be converted in all partner systems. The tables for the definition of logical system names (TBDLS, TBDLST) receive special treatment. After you have entered the system names, the system checks whether they have already been defined. The old system name is not changed in conversion. Instead, you add the new system name and, when the conversion process is complete, including in all partner systems, manually delete the old system name from the tables.
- Do not manually change the logical system names in the relevant tables. If you do, the application documents will not be found, or will only partly be found.
You have the following options for converting logical system names:
- Convert Client-Specific and Cross-Client Tables
- Typical applications:
- Renaming the logical system, and therefore changing the logical system name in all application tables of all partner systems.
- Creating a new system by database copy. In this case, call the new system a different name to the original system.
- Typical applications:
- Convert Client-Specific Tables
- An example application is converting the logical system name after client copy.
Choose the appropriate option for your application.
On the initial screen, enter the logical system name that you want to convert in the Old Logical System Name field, and enter the new name in the New Logical System Name field.
It is advisable to carry out the conversion first in test mode. If you select the Test Run radio button, the system first analyzes all the relevant tables, and determines the number of entries to be converted. This information is displayed as a list. If the radio button Check Whether New Names Exist in Tables is selected, the system checks whether the new logical system name already exists in application tables. If it does, you are asked whether you want to continue with the conversion or not. Check the table in which the logical system name is found, and determine whether these entries need to be converted. If you do not want to convert these entries, cancel the conversion.
The conversion also applies to tables for communication partners, which are identified by partner number and partner type. If the partner number and the logical system name are the same, the relevant table entries are also converted.
The value in the Number of Entries per Commit field is only relevant for conversion. To improve performance, this value should be as large as possible, depending on the size of the database roll area.
In the selection screen Tables for Conversion, you can select and exclude the tables to be converted, so that you only select and convert certain data. Table T000, for assigning the client to the logical system, receives special treatment and cannot be excluded. This table is converted last. Note that if only one table is converted, the definition of the client for the logical system is also converted, if this assignment is defined in the current client. This means that the application documents in converted tables are found, because they refer to the new system names, while application documents in tables that have not yet been converted are not found, because they still refer to the old logical system names. It is therefore advisable to convert all the tables in one step.
Check the results of the conversion, for example, a * character at the end of the table indicates a cross-client table. If you use Convert Client-Dependent and Cross-Client Tables, the existing entries in these tables are replaced by the new logical system names. If you do not want to replace these entries, choose Convert Client-Specific Tables, so the old entries in cross client tables are retained.
After the program has been successfully executed, the system creates a list of which tables and fields have been determined for the conversion, and how many entries are relevant or have been converted. This is displayed in the application log. To display the logs, call transaction SLG1, with the object CALE and the subobject LOGSYSNAME.
Note: Starting the conversion in background processing
- Starting the program RBDLS2LS dynamically generates another program RBDLSXYZ (XYZ identifies the client in which the program RBDLS2LS was started) from the template IBDLSCLS, which is started by program RBDLS2LS.
- The program RBDLSXYZ for the actual conversion can also be executed by background processing, if you assign values to the appropriate entry fields. In this case, all the security questions during the run are confirmed with Yes.
Note: Performance
- The value in the Number of Entries per Commit field is only relevant for the actual conversion (not for the test run). To improve performance, this value should be as large as possible, depending on the size of the database roll area.
- Depending on the size of the dataset in the system, the conversion process can last a long time.
- To improve performance, you can execute the program for the actual conversion at the same time. This parallel processing can take place in a different client, or in the same client for different tables.
- If you are sure that the new logical system name has not been used previously, you can deactivate the existence check in a test run.
Note: Restart capability
- If the conversion process is terminated for any reason, it can be restarted, because the converted data is committed as a table or in sections within a table.
Note: Checking and changing the communication settings
- Asynchronous communication: Partner profile
- When a logical system name is converted, the partner name is also converted in the corresponding partner profile. The partner status in the partner profile is also set to inactive.
- After conversion, check the partner profile (port and RFC destination). Change these if necessary, and activate the changed partner profile.
- Synchronous communication: RFC destination
- After conversion of the logical system name, check the RFC destination for synchronous communication, and change it if necessary.
Starting the Program During Client Copy
During client copy, this program can be called in the phase Generating and checking, in which another program is generated from the template IBDLSCLS. This generated program can be used to convert the logical system name, which has already been defined in the source client, to the name that has been defined in the new client. The program determines all relevant tables for the conversion, and converts the corresponding entries.
Note: Authorization
- No authorization check.
Note: Scope of data
- The conversion takes place in the current client, which means that all client-specific table entries are converted. If the entries in a table have not been converted, or are not completely converted, an error message is produced in the transport log. The reason for this could be that this table already contains the old logical system name, or errors occur in the database change during conversion. In this case, you may need to subsequently process the table manually.
- For cross-client table entries, a warning is displayed in the transport log. which warns that the conversion of these table entries is not carried out in client copy. This means that the old table entries remain unchanged in the client copy. Depending on the applications of the new client, subsequent processing of these tables may be necessary. The new entries for the new logical system name can be manually extended.
- The conversion also applies to tables for communication partners, which are identified by partner number and partner type. If the partner number and the logical system name are the same, the relevant table entries are also converted.
Note: Results
- After the program has been successfully converted, the results of the conversion are displayed in the transport log. Only the tables are displayed that are relevant for the conversion, or in which data has been converted. The level numbers 2, 3 and 4 in the logs identify error messages and warnings, as well as normal messages.
Note: Checking and changing the communication settings
- Asynchronous communication: Partner profile
- When a logical system name is converted, the partner name is also converted in the corresponding partner profile. The partner status in the partner profile is also set to inactive.
- After conversion, check the partner profile (port and RFC destination). Change these if necessary, and activate the changed partner profile.
- Synchronous communication: RFC destination
- After conversion of the logical system name, check the RFC destination for synchronous communication, and change it if necessary.
