2.5.1 Notes on version upgrading
In version 10-51, the RFC library, which is used to communicate with the SAP system, has been changed from the classic RFC library to SAP NetWeaver RFC Library. In SAP NetWeaver RFC Library, the name of the saprfc.ini file and the parameter specifications have been changed from those provided by the classic RFC library. If you were using the saprfc.ini file in version 10-00 or earlier, you need to perform migration operations by noting the specification changes described below.
- Organization of this subsection
(1) Changing file names
The name of the saprfc.ini file, which has been used so far, has been changed to sapnwrfc.ini. Change the name of the saprfc.ini file for version 10-00 or earlier to sapnwrfc.ini.
In addition, the file name sapnwrfc.ini is now fixed for SAP NetWeaver RFC Library. If multiple saprfc.ini files with a name of your choice were stored in the same folder in version 10-00 or earlier, you need to take action such as storing those files in separate folders.
(2) Changing parameter definitions
The parameter definitions in the file have been changed. The SAP connection type parameter (TYPE) was removed from the range supported by JP1. If the TYPE parameter was set in the saprfc.ini file, remove the parameter from the sapnwrfc.ini file.
The following table lists the parameters supported by JP1 version 10-51 and later.
Parameter |
Description |
---|---|
DEST |
Specifies destinations. |
ASHOST |
Specifies the host name for the SAP system. |
SYSNR |
Specifies the system number that is used to identify the SAP system. |
MSHOST |
Specifies the host name for the message server. |
R3NAME |
Specifies the system ID of the SAP system. |
GROUP |
Specifies the logon group. |
CLIENT |
Specifies the client number that is valid in the logon destination SAP system. |
USER |
Specifies the user name that is valid in the logon destination SAP system. |
PASSWD |
Specifies a password for the SAP user specified in the USER parameter. |
LANG |
Specifies the language type to be used for logon. |
CODEPAGE |
Specifies the code page number. |
(3) Changing the definition of the environment parameter RFC_INI
If the path for the saprfc.ini file has been specified for the environment parameter RFC_INI, in line with the definition change made in (1), change the file path to that of the sapnwrfc.ini file.
The following compatibility function is available to make it easy for you to change the definition of the environment parameter RFC_INI:
- Compatibility function:
-
If a file name that does not end with "sapnwrfc.ini" is specified for the environment parameter RFC_INI, the function regards the path up until the folder name as valid, and then references the sapnwrfc.ini file in that folder.
By using this function, you can reference the sapnwrfc.ini file without changing the value of the environment parameter RFC_INI, even if the sapnwrfc.ini file and saprfc.ini file are created in the same folder.