2.7.1 R/3 job definition information section
If you want to display the definition items related to detailed definitions in JP1/AJS3 for Enterprise Applications, display the R/3 job definition information section in the definition information management template. To display this section, specify JP1AMR3 in the CUSTOM-JOB environment settings parameter.
When JP1AMR3 is specified in the CUSTOM-JOB environment settings parameter, you can use the definition items for the following standard custom jobs: JP1AMR3 that executes background jobs of the R/3 system, and JP1AMR3CP that executes the custom job that copies jobs of the R/3 system.
If you do not specify JP1AMR3 in the CUSTOM-JOB environment settings parameter (default), you can use the values of the parameters and the environment variables of the standard custom jobs in JP1/AJS3 for Enterprise Applications in the Parameters column and the Environment variables column in the Basic job definition information section.
For details about the environment settings parameters, see 3.2.1 Settings for environment settings parameters.
- Organization of this subsection
(1) Function for specifying multiple job steps
You can define multiple job steps for a single R/3 job (JP1AMR3). The following shows a display example when you import or export an R/3 job.
|
When you import an R/3 job, the items to be displayed in cells are stored in the order in which they are displayed in JP1/AJS3 - View.
For an item not supported in JP1/AJS3 - View, only a line break is inserted (for example, archiving mode for an external program).
When you export an R/3 job, items are displayed in JP1/AJS3 - View in the order specified for the cells.
When you define a new job step or add a new job step to existing job steps, you must set values for all items of the job step. However, if there is no value to be defined, specify only a line break. If you do not specify anything for an item, the definition information will not be aligned correctly. Exporting is not possible unless you set the data for the item because the number of lines in the item differs from that of the program type.
(2) Save function for unsupported definition items for R/3 jobs
This function saves the R/3 job definition items not supported by JP1/AJS3 - Definition Assistant in Other R/3 job definition information and Other job step information in the R/3 job definition information section in the definition information management template. These items are saved in the command argument format.
(a) Import function
When you import definition information, the definition items that have no corresponding R/3 job definition items in the definition information management template are set in Other R/3 job definition information or Other job step information in the command argument format. Common definition items that do not depend on the program type of the R/3 job are set in Other R/3 job definition information. Definition items for each program type of the R/3 job are set in Other job step information.
For details about the R/3 job definition items not supported by JP1/AJS3 - Definition Assistant, see 5.2 Support status of the definition items in JP1/AJS3 - View.
(b) Export function
-
Batch definition and individual definition functions
You can define the definition items that have no corresponding definition items in the definition information management template. To do this, define information in Other R/3 job definition information and Other job step information in the command argument format and execute either batch export or individual export.
Either type merges supported definition items in the definition information management template with the definition information in Other R/3 job definition information and Other job step information. Accordingly, although you can also define the supported definition items in Other R/3 job definition information and Other job step information, do not do this. Instead, define them in the corresponding definition item columns.
-
Modification function
You cannot modify the contents of the R/3 job definition information section. In addition, you cannot mark cells by pressing the F2 key.
To modify definition information, therefore, use the batch or individual definition function to redefine the unit.
(3) Error-checking function
When you click the CHECK button or press the F10 key, the following check function is available for the R/3 job definition information section.
Checked item |
Check made |
|
---|---|---|
Definition Items of JP1AMR3 |
Definition Items of JP1AMR3CP |
|
Whether an invalid definition item is set |
Yes |
Yes |
Whether the required items are specified |
Yes |
Yes |
Whether the specifications conform to the input restrictions# |
Yes |
No |
Whether an invalid definition item is set for the specified program type |
Yes |
No |
Whether exclusive items are specified |
Yes |
Yes |
Whether the number of entries for the program type is within the specifiable range of the job step (1 to 99) |
Yes |
No |
Whether any item contains a number of lines that differs from the number of lines in the program type. |
Yes |
No |
Whether in the environment variables, verify that there are no specifications consisting only of a line break. |
Yes |
Yes |
Whether in the environment variables, verify that variable names are not duplicated. |
Yes |
Yes |
Whether verify that the number of specified environment variables does not exceed the upper limit of 10 variables (environment variable: variable and environment variable: value). |
Yes |
Yes |
Whether verify that the number of specifications in the environment variables matches the variable and values. |
Yes |
Yes |
- Legend:
-
Yes: Checked
No; Not checked
- #
-
Applies to definition items under a job step. Other definition items are checked when they are entered. The following items are not checked:
-
Whether the specified value is registered in the list box (however, the value of the program type is checked)
-
Contents of Other job step information
-
(4) Which definition items for each standard custom job can be defined
The following table lists which items can be defined for the R/3 job definition information section for each standard custom job.
Definition item |
Whether it can be defined |
||
---|---|---|---|
JP1AMR3 |
JP1AMR3CP |
||
Host name |
Yes |
Yes |
|
System number |
|||
Destination |
|||
Logon by sapnwrfc.ini file |
|||
Client |
|||
SAP user name |
|||
Password |
|||
Extended password |
|||
Language |
|||
Job name |
No |
||
Job step |
Program type |
||
Program |
|||
Variant |
|||
Authorized user |
|||
Target host |
|||
Archiving mode |
|||
Output device |
|||
lines |
|||
columns |
|||
Format |
|||
Number of copies |
|||
Authorization |
|||
Spool save period |
|||
SAP cover sheet |
|||
Receiver |
|||
Obj. type |
|||
Doc. type |
|||
Information |
|||
Information text |
|||
Other job step information |
|||
Name of the source job |
No |
Yes |
|
Job count of the source job |
|||
Number of the first step to start copying job |
|||
New name of the copied job |
|||
Environment variables |
Variable |
Yes |
|
Value |
|||
Other R/3 job definition information |
- Legend:
-
Yes: Can be defined.
No: Cannot be defined.
(5) Required items and exclusive items for each standard custom job
The following two tables list the required definition items and the exclusive definition items for the R/3 job definition information section for each standard custom job.
Definition item |
Conditions |
||
---|---|---|---|
JP1AMR3 |
JP1AMR3CP |
||
Host name |
Destination is not specified. |
||
Client |
Logon by sapnwrfc.ini file is not specified or No. |
||
SAP user name |
|||
Password, or Extended password |
|||
Job name |
None |
Not applicable |
|
Job step |
Program |
None |
|
Target host |
Program type: External program |
||
Obj. type |
Program type: ABAP program Archiving mode: A or PA |
||
Doc. type |
Same as above |
||
Information |
Same as above |
||
Name of the source job |
Not applicable |
None |
|
Job count of the source job |
None |
Definition item |
Exclusive item |
Conditions |
||
---|---|---|---|---|
JP1AMR3 |
JP1AMR3CP |
|||
Host name |
Destination |
None |
||
Logon by sapnwrfc.ini file |
Logon by sapnwrfc.ini file: Yes |
|||
System number |
Destination |
None |
||
Logon by sapnwrfc.ini file |
Logon by sapnwrfc.ini file: Yes |
|||
Password |
Extended password |
None |
||
Logon by sapnwrfc.ini file |
Client SAP user name Password Extended password Language |
Logon by sapnwrfc.ini file: Yes |
||
Job step |
Archiving mode |
Obj. type Doc. type Information Information text |
Program type: ABAP program Archiving mode: Mode other than A or PA |
Not applicable |
lines |
Format |
Program type: ABAP program |
||
columns |
Format |
Program type: ABAP program |
(6) Notes
Note the following when using the R/3 job definition information section:
-
When you create a new R/3 job, initial values for the release of the job and for monitoring of job completion differ between JP1/AJS3 - View and JP1/AJS3 - Definition Assistant. To match the initial values with those of JP1/AJS3 - View, specify the command options -rs and -wait in Other R/3 job definition information.
-
In Other R/3 job definition information, do not specify command options supported by JP1/AJS3 - Definition Assistant. Also, do not set the same command option more than once.
-
For an individual line in a cell in Other job step information, do not specify command options supported by JP1/AJS3 - Definition Assistant. Also, do not set the same command option more than once.
-
If you specify invalid definition information in Other R/3 job definition information or Other job step information and then perform export operations, definition information might become invalid in JP1/AJS at the connection destination.
-
When exporting, do not specify definition items that are not supported by JP1/AJS3 for Enterprise Applications at the connection destination. If you perform export in this manner, invalid options will be set in the R/3 job definition information.
-
To add or delete job steps, match the number of lines in a cell in the columns of items for all job steps. If you do not match the number of lines, job step definition information will not be aligned correctly, resulting in an export error or definition information not being applied correctly at the destination.
-
If the version of JP1/AJS3 for Enterprise Applications at the connection destination is higher than the version of JP1/AJS3 - Definition Assistant, the import results might be invalid.