2.3.6 Steps to be completed before using the InfoPackage or process chain control commands
The following describes the procedures that must be completed when you want to use the -d option of a command or you want to set the command common argument defaults. The procedures are not necessary if the -d option will not be used or command common argument defaults will not be set.
- Organization of this subsection
(1) Making sure that the -d option for SAP BW destination information is usable
When using the -d option for the SAP BW destination information on the command line of JP1/AJS3 for EAP, the sapnwrfc.ini file must be created.
- Note:
-
The sapnwrfc.ini file is a definition file provided by SAP NetWeaver RFC Library and a successor of the saprfc.ini file for versions 10 and earlier. For details about the specification changes and the migration method for the saprfc.ini and sapnwrfc.ini files, see 2.5.1 Notes on version upgrading.
Depending on the operation method, create the sapnwrfc.ini file in one of the following directories or folders:
-
The work directory specified by the WorkDir key in the command section of the environment settings file (conf file) for InfoPackage or process chain control
This is the directory used when the work directory of JP1/AJS3 for EAP is specified in the environment settings file (conf file) for InfoPackage or process chain control.
-
The current directory during execution of each command
This is the directory used when the work directory of JP1/AJS3 for EAP is not specified in the environment settings file (conf file) for InfoPackage or process chain control.
-
Arbitrary folder
You must specify the storage destination folder in the environment variable RFC_INI.
Note that a sapnwrfc.ini file search occurs in the following sequence:
-
When sapnwrfc.ini is specified by environment variable RFC_INI
Only the sapnwrfc.ini file specified in environment variable RFC_INI is searched for. The sapnwrfc.ini file in the work directory of JP1/AJS3 for EAP is not searched for.
-
When sapnwrfc.ini is not specified by environment variable RFC_INI
The sapnwrfc.ini file in the JP1/AJS3 for EAP work directory is searched for.
The sapnwrfc.ini file is usually created in the JP1/AJS3 for EAP work directory that is defined in the environment setup file. To specify the sapnwrfc.ini file for a specific user, create the sapnwrfc.ini file in the desired directory and specify the path for the sapnwrfc.ini file in environment variable RFC_INI.
After JP1/AJS3 for EAP is installed, a sample sapnwrfc.ini file is stored in the following directory:
-
For Windows:
RFC_INI=C:\home\user01\sapnwrfc.ini
-
For Linux:
RFC_INI=/home/user01/sapnwrfc.ini
Copy the sample sapnwrfc.ini file to the JP1/AJS3 for EAP working directory (or the directory specified by environment variable RFC_INI) and edit the copy sample sapnwrfc.ini file as required. If you intend to use environment variable RFC_INI, specify it in advance.
Use the full path for the sapnwrfc.ini file to be specified in environment variable RFC_INI.
-
Typical specification of environment variable RFC_INI (Windows)
RFC_INI=C:\home\user01\sapnwrfc.ini
-
Typical specification of environment variable RFC_INI (Linux)
RFC_INI=/home/user01/saprfc.ini
The following figure shows an example of the saprfc.ini file. For details about the saprfc.ini file entries, see the R/3 manual or online help.
Note that there are multiple ways to specify settings for the sapnwrfc.ini file. The figure above shows an example setup for connecting to a message server. You can also connect to a specific application. Edit the services file and hosts file as appropriate for the type. For the specification items of each type and whether the services file and hosts file must be edited, see the SAP BW manual or online help.
(2) Specifying the defaults for command common arguments (SAP BW destination information and SAP BW logon information)
If the common arguments (SAP BW destination information and SAP BW logon information) entry is omitted from the command line for JP1/AJS3 for EAP, an r3defcon file must be created. This r3defcon file must be created in the home directory that is specified for the user account.
- Note
-
To use the r3defcon file in the Windows version, you need to specify the HOMEDRIVE or HOMEPATH environment variable for job execution to identify the home directory. Since these environment variables are not defined by default in the execution environment of commands executed from JP1/AJS, you must define them using environment variable items for job definition.
The following is a specification example of an environment variable (when the r3defcon file is placed at C:\Documents and Settings\Administrator):
HOMEDRIVE=C:
HOMEPATH=\Documents and Settings\Administrator
In those situations where Windows is employed with the NTFS file system, to prevent leakage of r3defcon file information, you should specify a different home directory for each user. With the FAT file system, however, you cannot protect the r3defcon file information at the file level.
With Linux, to prevent leakage of r3defcon file information, we recommend that you define the access permissions for the r3defcon file so that only the user executing the command can read the r3defcon file.
The following figure shows an example of creating the r3defcon file.
The syntax for the r3defcon file is as follows:
[section] key=string
-
As the separator between section and key and between key and key, specify one or more new-line codes.
-
The character strings specified for section and key are case-insensitive.
-
The key specifications within the same section can be in any order.
-
If a semicolon (;) is placed at the beginning of a line, the line is handled as a comment statement.
-
When there are two or more section or key specifications that have the same name, a KAJM0022-E message appears and command execution is terminated.
The keys that can be specified in the r3defcon file are explained below for each section.
When omitting the SAP BW logon information specification, specify logon (logon section). The following table describes the keys that can be specified in the logon section.
Key |
Value selectable as a string |
Explanation |
---|---|---|
1- to 3-byte character string (The character string must consist of numerals only.) |
Specify the SAP BW client number for logging on to the SAP BW system. Note that a 1- or 2-byte SAP BW client number sent to the SAP BW system is always converted to a 3-byte number. If, for instance, the client number is 001, you can specify the number 1, 01, or 001. However, the 3-byte client number 001 is always sent to the SAP BW system. |
|
1- to 12-byte character string |
Specify the SAP user name for logging on to the SAP BW system. For details about the SAP users that can be specified, see 2.3.9 Providing a SAP user for InfoPackage control or process chain control. |
|
1- to 8-byte character string |
Specify the password that has been assigned to the SAP user for logging on to the SAP BW system. Specify this key when a conventional password rule is applied to the SAP system. |
|
1- to 40-byte character string |
Specify the extended password that was assigned to the SAP user for logging in to the SAP BW system. The extended password is a password rule that was extended in the SAP systems based on SAP NetWeaver 7.0 and later. Specify this key when the extended password rule is applied to the SAP system. You can specify up to 40 bytes, and alphabetic characters are case-sensitive. |
|
Japanese: J English: E |
Specify the language type that can be used with the SAP BW system. You can specify either Japanese or English as the language type. |
- Important
-
When you specify the logon section, be sure to specify all the keys (client, user, passwd or passwd2, and lang). Note that you cannot specify passwd and passwd2 at the same time. Specify one of them according to the availability of the extended password.
When omitting the SAP BW destination information specification, specify address (address section). The following table describes the keys that can be specified in the address section.
- Important
-
dest and host and sysno cannot be specified together. When specifying the address section, specify dest only or specify host and sysno.