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
(2) Save function for unsupported definition items for R/3 jobs
(3) Error-checking function
(4) Which definition items for each standard custom job can be defined
(5) Required items and exclusive items for each standard custom job
(6) Notes

(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.

Figure 2‒9: Display example for importing or exporting an R/3 job (`JP1AMR3`)

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.

To Page Top

(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.

To Page Top

(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.

Table 2‒3: Error-checking function supported for the R/3 job definition information section
Checked item	Check made
Checked item	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

To Page Top

(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.

Table 2‒4: 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
Definition item		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
Environment variables	Value
Other R/3 job definition information

Legend:

Yes: Can be defined.

No: Cannot be defined.

To Page Top

(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.

Table 2‒5: The required items for the R/3 job definition information section for each standard custom job
Definition item		Conditions
Definition item		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		Not applicable	None

Table 2‒6: The exclusive items for the R/3 job definition information section for each standard custom job
Definition item		Exclusive item	Conditions
Definition item		Exclusive item	JP1AMR3	JP1AMR3CP
Host name		Destination	None
Host name		Logon by sapnwrfc.ini file	Logon by sapnwrfc.ini file: Yes
System number		Destination	None
System number		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

To Page Top

(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.

To Page Top