3.1.1 Creating a new SAP job
- Organization of this subsection
(1) Procedures for executing SAP jobs
Before you can use JP1/AJS to execute SAP jobs, you must perform the following tasks. These tasks will vary depending on the OS of the machine on which JP1/AJS - View is installed.
(a) If JP1/AJS3 for EAP is installed on a Windows machine
- Procedure 1
-
Environment settings
If the machine on which JP1/AJS3 for EAP is installed runs Windows, manually copy the following file. However, if JP1/AJS3 for EAP of version 12-00 or earlier is linked, do not copy the following file.
- Copied from:
-
-
installation-folder\Program\eapctrlconf.model.windows (model eapctrlconf file for Windows)
-
- Copied to:
-
-
installation-folder\Program\eapctrlconf (eapctrlconf file)
-
- Notes
-
Custom jobs can be set by the definition program even when linking with version 12-00 or earlier, but please define the arguments for the version of AJS-EAP to be executed.
Manually copy the following programs provided by JP1/AJS3 for EAP to the machine on which JP1/AJS - View is installed:
-
installation-folder\Program\jr3cjdfx.exe (definition program)
-
installation-folder\Program\jr3cjdfx.ini (initialization file)
-
installation-folder\Program\eapctrlconf.model.windows (model eapctrlconf file for Windows)
Copy the above files to the same folder located anywhere on the machine on which JP1/AJS - View is installed.
If you are using multiple versions of JP1/AJS3 for EAP, copy the latest versions of JP1/AJS3 for EAP files to the machine on which JP1/AJS - View is installed.
When migrating from an earlier version, if you update a custom job definition module on a machine on which JP1/AJS2 - View is installed, delete all modules copied by earlier versions, and then copy a module that has a later version.
For the model eapctrlconf file for Windows (eapctrlconf.model.windows), copy and then rename the file eapctrlconf.
- Procedure 2
-
Custom job registration
- Procedure 3
-
Custom job definition
When the above procedures are completed and the JP1/AJS jobnet is started for execution of the SAP system custom job, the job is created in the SAP system and then executed.
(b) If JP1/AJS3 for EAP is installed on a Linux machine
- Procedure 1
-
Environment settings
If the machine on which JP1/AJS3 for EAP is installed runs Linux, manually copy the following file. However, if JP1/AJS3 for EAP of version 12-00 or earlier is linked, do not copy the following file.
- Copied from:
-
-
/etc/opt/jp1_am_r3/conf/eapctrlconf.model.linux (model eapctrlconf file for Linux)
-
- Copied to:
-
-
/etc/opt/jp1_am_r3/conf/eapctrlconf
-
- Notes
-
Custom jobs can be set by the definition program even when linking with version 12-00 or earlier, but please define the arguments for the version of AJS-EAP to be executed.
Manually copy the following programs provided by JP1/AJS3 foer EAP to the machine on which JP1/AJS - View is installed:
-
/opt/jp1_am_r3/bin/jr3cjdfx.exe (definition program)
-
/opt/jp1_am_r3/bin/jr3cjdfx.ini (initialization file)
-
/etc/opt/jp1_am_r3/conf/eapctrlconf.model.windows (model eapctrlconf file for Windows)
Copy the above files to the same folder located anywhere on the machine on which JP1/AJS - View is installed.
If you are using multiple versions of JP1/AJS3 for EAP, copy the latest versions of JP1/AJS3 for EAP files to the machine on which JP1/AJS - View is installed.
When migrating from an earlier version, if you update a custom job definition module on a machine on which JP1/AJS2 - View is installed, delete all modules copied by earlier versions, and then copy a module that has a later version.
For the model eapctrlconf file for Windows, copy and then rename the file eapctrlconf.
For the model eapctrlconf file for Windows (eapctrlconf.model.windows), copy and then rename the file eapctrlconf.
In addition, If JP1/AJS - View of version 12-00 or earlier is linked, copy the following file to the JP1/AJS - View installation location:
- Copied from:
-
-
/opt/jp1_am_r3/image/CUSTOM_PC_JP1AMR3UX.gif
-
- Copied to:
-
-
JP1/AJS - View installation-folder\image\custom
-
- Procedure 2
-
Custom job registration
- Procedure 3
-
Custom job definition
When the above procedures are completed and the JP1/AJS jobnet is started for execution of the SAP system custom job, the job is created in the SAP system and then executed.
(2) Registering a custom job
Register the files as custom jobs in the Register Custom Job dialog box of JP1/AJS - View.
To register a custom job for the SAP system:
-
Display the Register Custom Job dialog box in JP1/AJS - View.
-
Choose the Add button.
The Set Properties of Custom Job dialog box is displayed.
-
Register the custom job for the SAP system.
Specify information in the entry boxes of the dialog box as described below.
- Name
-
Specify a name from 1 to 8 bytes for the custom job of JP1/AJS3 for EAP.
- Comment
-
You can enter a comment from 1 to 40 bytes long. You cannot include slashes (/) and blank characters in comments. You can omit Comment.
- Defining program
-
Specify the pathname of the jr3cjdfx.exe program you have manually copied for defining the custom job.
Note that you need not specify Defining program when you select UNIX in Job Type.
- Executing program
-
Specify the pathname of the program for executing the custom job on the JP1/AJS - Agent (or JP1/AJS - Manager) machine.
For Windows:
- installation-folder\Program\jr3bjsub.exe
For Linux:
- /opt/jp1_am_r3/bin/jr3bjsub
Notes
•You need not specify Executing program when you select UNIX in Job Type.
• If the path to the JP1/AJS3 for EAP installation folder is different for different machines, define a job execution work path as a variable in JP1/AJS3. If you do not specify this setting, the message (KAVU4550-W) indicating that no executable file was found during job execution is output to the Execution Result Details dialog box of JP1/AJS3 - View, and the job cannot be executed.
For the setup method, see the manual JP1/Automatic Job Management System 3 Operator's Guide.
- Version
-
Specify 0600.
- Class
-
Specify JP1AMR3.
Further, when specifying PC as the Job Type in Linux, specify JP1AMR3UX.
- Job Type
-
Select PC if the JP1/AJS - Agent (or JP1/AJS - Manager) machine on which JP1/AJS3 for EAP is installed is a Windows machine. Select UNIX if it is a Linux machine.
You can also specify PC when registering a custom job in Linux.
-
Choose the OK button.
For more details on how to register custom jobs, see the manual JP1/Automatic Job Management System 3 Operator's Guide.
(3) Defining a custom job
In the Jobnet Editor window of JP1/AJS, define the registered custom job in a jobnet.
To define a custom job for use with the SAP system:
(a) Defining a custom job (PC job)
-
Use the Jobnet Editor window of JP1/AJS to display the jobnet definition area.
-
Select the Custom Jobs tab, and then drag the registered custom job to be used with the SAP system and drop it onto the jobnet definition area.
The registered custom job is added to the jobnet definition area and the Define Details - [Custom Job] dialog box is displayed.
-
Specify the end judgment.
-
If you want JP1/AJS to handle an abnormal job end (the return value of the jr3bjsub command is 1) and other errors (the return value of the jr3bjsub command is 2 or greater) as abnormal conditions:
Rule
Select Judgment by threshold.
Warning
Specify no value.
Abnormal
Specify 0.
-
If you want JP1/AJS to issue a warning for an abnormal job end (the return value of the jr3bjsub command is 1) and handle other errors (the return value of the jr3bjsub command is 2 or greater) as abnormal conditions:
Rule
Select Judgment by threshold.
Warning
Specify 0.
Abnormal
Specify 1.
-
If you want JP1/AJS to handle an abnormal job end (the return value of the jr3bjsub command is 1, or 5 or greater) as abnormal conditions and handle other errors (the return value of the jr3bjsub command is between 2 and 4) as warnings:
Rule
Select Judgment by threshold.
Warning
Specify no value.
Abnormal
Specify 4 (the upper limit for the return value handled as a warning).
The subsequent judgment job determines if the return value is a value from 1 to 4. For details about the setup method, see the chapter that contains definition examples of jobnets with judgment jobs in the manual JP1/Automatic Job Management System 3 System Design (Work Tasks) Guide.
-
-
Choose the Details button.
The R/3 Job Definition dialog box is displayed.
-
Define the attributes of the SAP request.
Specify the following information in the dialog box.
-
Specify the method for connecting to the SAP system where the SAP job will be created.
-
Define the SAP job.
-
Define the job steps.
-
Specify the job release/completion monitoring settings.
-
Specify the execution result output destination.
- Note
-
When specifying the job cancellation time in the Define Details - [Custom Job] dialog box, make sure that the setting is longer than the job cancellation time specified by JP1/AJS3 for EAP.
-
-
Choose the OK button.
For more details on how to define custom jobs, see the manual JP1/Automatic Job Management System 3 Operator's Guide.
- Important
-
The custom job definition program of the SAP job internally generates the command line for the jr3bjsub command based on the input information.
The maximum length of this command line is 1,020 bytes. If this length is exceeded, the error: The generated command line (byte-count-of-the-generated-command-line bytes) exceeded the maximum length (1,020 bytes). Definition information cannot be saved. occurs in the custom job definition program.
Depending on the SAP job definition, such as when multiple job steps are assigned to a single job, the generated command line may exceed 1,020 bytes.
If multiple job steps are assigned to a single job, define them in separate jobs and specify the execution order for these jobs, for example.
(b) Defining a custom job (UNIX job)
-
Use the Jobnet Editor window of JP1/AJS to display the jobnet definition area.
-
Select the Custom Jobs tab, and then drag the registered custom job to be used with the SAP system and drop it onto the jobnet definition area.
The registered custom job is added to the jobnet definition area and the Define Details - [Custom Job] dialog box is displayed.
-
Define Command statement.
Specify command line parameters for the jr3bjsub command.
-
Specify the end judgment.
-
If you want JP1/AJS to handle an abnormal job end (the return value of the jr3bjsub command is 1) and other errors (the return value of the jr3bjsub command is 2 or greater) as abnormal conditions:
Rule
Select Judgment by threshold.
Warning
Specify no value.
Abnormal
Specify 0.
-
If you want JP1/AJS to issue a warning for an abnormal job end (the return value of the jr3bjsub command is 1) and handle other errors (the return value of the jr3bjsub command is 2 or greater) as abnormal conditions:
Rule
Select Judgment by threshold.
Warning
Specify 0.
Abnormal
Specify 1.
-
If you want JP1/AJS to handle an abnormal job end (the return value of the jr3bjsub command is 1, or 5 or greater) as abnormal conditions and handle other errors (the return value of the jr3bjsub command is between 2 and 4) as warnings:
Rule
Select Judgment by threshold.
Warning
Specify no value.
Abnormal
Specify 4 (the upper limit for the return value handled as a warning).
The subsequent judgment job determines if the return value is a value from 1 to 4. For details about the setup method, see the chapter that contains definition examples of jobnets with judgment jobs in the manual JP1/Automatic Job Management System 3 System Design (Work Tasks) Guide.
-
-
Choose the OK button.
For more details on how to define custom jobs, see the manual JP1/Automatic Job Management System 3 Operator's Guide.
(c) Specifying the method for connecting to the SAP system
To specify the method for connecting to the SAP system where the SAP job will be created, use the R/3 System page of the R/3 Job Definition dialog box.
The following figure shows the R/3 System page.
|
The items to be defined in the R/3 System page are explained below.
Definition items
- Destination
-
Specify the method for connecting to the application server where the job will be created. Use either of the following options to specify the application server to be connected:
-
Specify a specific application server.
-
Use the destination specified in the sapnwrfc.ini file.
- Connect to a specific application server
-
Select this option when directly specifying the application server to be connected to.
- Host name
-
Specify the host name of the application server (or SAP router) to be connected to. A character string of 1 to 100 bytes can be entered for the host name.
You can use host names in the following formats:
-
Host name defined in the hosts file (for example, host1)
-
IP address (for example, 123.123.123.123)
-
SAP router address (for example, /H/hostname/S/port/H/host/S/port/...)
For details about the SAP router address format, see the SAP manual or online help.
This item corresponds to the -h option of the jr3bjsub command.
-
- System number
-
Specify the system number that identifies the target application server. A character string of 1 or 2 bytes can be entered for the system number. Only numerals can be used. Normally enter 00.
This item corresponds to the -s option of the jr3bjsub command.
- Connect by sapnwrfc.ini file
-
Select this option when you set the parameter that identifies the application server to be connected to from the external file. You need to select this option when you try to connect to the application server by balancing the workload.
Depending on what is defined in the sapnwrfc.ini file, the system connects to either a specific application server or the application server determined by the load-balancing function of the message server.
- Destination
-
Enter the value of the DEST key identifying the connection entry in the sapnwrfc.ini file. A character string of 1 to 32 bytes can be entered for the destination.
This item corresponds to the -d option of the jr3bjsub command.
-
- Logon
-
Specify the user information used for the connection destination SAP system. JP1/AJS3 for EAP uses this information to log on to the SAP system and execute jobs. Specify the user to log on by either of the following methods:
-
Use the user specified in sapnwrfc.ini
-
Use a specific user (client, user name, password, and language)
- Log on by using the sapnwrfc.ini file
-
To log on by using the definitions specified in the external file (sapnwrfc.ini) and for Destination, select Log on by using the sapnwrfc.ini file.
This item corresponds to the -dl option of the jr3bjsub command.
- Client
-
Specify the number of the client assigned to the SAP user who executes jobs. The lengths of character strings you can specify are from 1 to 3 bytes. You can only include digits in the character string. When an SAP client number of 1 or 2 bytes is to be sent to the SAP system, it is converted to 3 bytes.
For example, if the client number is 001, you can specify 1, 01, or 001. When this client number is sent to the SAP system, it is sent as 001.
This item corresponds to the -c option of the jr3bjsub command.
- SAP user name
-
Specify the name of the SAP user who executes jobs.
For details about the users who can be specified, see 2.3.9 Providing a SAP user for job control.
When you do not explicitly specify the authorized user to define the job step, the system executes the job step by using the permission specified in this option.
The lengths of character strings you can specify are from 1 to 12 bytes. You cannot include single-byte lower-case alphabetic characters in the user name.
This item corresponds to the -u option of the jr3bjsub command.
- Password
-
For the SAP user who executes jobs, enter the password or extended password specified for the user name. To use an extended password, select Use an extended password.
The lengths of character strings you can specify are from 1 to 8 bytes for the password, and from 1 to 40 bytes for the extended password. Entered characters are marked with asterisks (*).
This item corresponds to the -p option of the jr3bjsub command if you use the password, and the -p2 option of the jr3bjsub command if you use the extended password.
- Using the extended password
-
When the extended password rule is applied to the SAP system, select the Using the extended password check box. When you select this check box, confirm that the configuration at the execution host is as follows:
-
JP1/AJS3 for EAP 09-00 and later is installed.
-
The availability of the extended password is set to ON by the jr3chrfc command.
-
- Language
-
Specify the language environment for executing jobs. You can use either Japanese or English. Specify the following language supported by the SAP system as the language to be used.
-
For Japanese: J
-
For English: E
You cannot specify a lowercase single-byte character for the language.
In the following cases, the default language type defined by the destination SAP system is used:
-
Language type specification is omitted.
-
A language type not defined by the destination SAP system is specified.
The language type specified for this item affects the language for the SAP job log. It also affects the language for the error details that are returned by the SAP system and inserted into a message, such as KAJM0802-E and KAJM0813-E.
This item corresponds to the -l option of the jr3bjsub command.
-
-
(d) Defining an SAP job
To create an SAP job definition, use the R/3 Job Definition page of the R/3 Job Definition dialog box.
The following figure shows the R/3 Job Definition page.
|
The items to be defined in the Job Definition page are explained below.
Definition items
- Register job
-
Enter the setup data such as the job name and job step information necessary for job registration.
A job consists of one or more job steps. ABAP report programs (ABAP programs) or general programs (external programs) executable by the SAP system can be specified for the job steps.
The background jobs that can be registered on the SAP system are those that can be defined and executed using transaction code SM36.
- Job name
-
Specify the job name to be registered in the SAP system. The lengths of character strings you can specify are from 1 to 32 bytes. You cannot include single-byte lower-case alphabetic characters in the job name.
This item corresponds to the -jn option of the jr3bjsub command.
- Job class
-
Specify the job class (priority level of job execution) of the SAP job to be executed in the SAP system. The available job classes are as follows:
-
A - High
-
B - Middle
-
C - Low
Normally, specify C - Low. If you want to execute a job with a higher level of priority, specify B - Middle. If you need to execute a job immediately because of an emergency, specify A - High. The default is C - Low.
This item corresponds to the -class option of the jr3bjsub command.
Note
To specify A - High or B - Middle, JP1/AJS2 for EAP 07-50 or later must be installed on the execution destination host and the XBP 2.0 interface must be enabled in the connection destination SAP system.
-
- Defined job steps
-
Click Add, Delete, or Property to specify the job steps that constitute an SAP job. The programs specified as job steps (ABAP programs or external programs) are executed in the order indicated in the Defined job steps program list.
To change the program execution order, select the program you want to move, and then click Up or Down.
-
Add button
Use this button when adding a program as a job step. Clicking this button opens the Job Step dialog box. In the dialog box, define the program to be added.
-
Delete button
Use this button when deleting a program from the Defined job steps program list. You can delete the selected program from the program list.
-
Property button
Use this button when referencing or updating the definitions of programs listed in Defined job steps. Clicking this button opens the Job Step dialog box for the selected program type.
-
Up button
Use this button to move the selected program up the execution order in the Defined job steps program list.
-
Down button
Use this button to move the selected program down the execution order in the Defined job steps program list.
-
- Define target host system
-
When you want to define the host of the application server that executes jobs, select this check box, and then enter the host name.
If you do not select this check box, the SAP system will distribute the execution load of SAP jobs among the application servers.
When you select this check box, the Define target application server check box is cleared.
Define target host system is a job definition compatible parameter created for Release 4.0 and earlier SAP systems. To define jobs for Release 4.5 or later SAP systems, use Define target application server.
Note
If one of the following conditions is satisfied, and if you select the Define target host system check box, the specification in the Host name field becomes ineffective:
-
Neither Release job as soon as possible nor Release job immediately is selected as the release method in the Monitor dialog box.
-
You have registered the job normally, but have failed to release the job.
In this case, no target host is assigned to the job registered on the SAP system.
To execute the job on the target system, release the job by specifying the target system using the -tgh or -tgs option in the jr3bjrel command. If you release the job without specifying a target system using the jr3bjrel command, the SAP system will dynamically select the target system on which the job will be executed.
-
- Host name
-
Specify the host name of the application server that executes jobs.
From the list of host names displayed by the transaction SM51, select the host name assigned to the application server that offers a background processing service. Select one of the application servers that are running on the specified host and designate it as the target system on which the job will be executed.
This item corresponds to the -tgh option of the jr3bjsub command.
- Define target application server
-
To specify an application server or a job server group that executes the created SAP jobs, select the Define target application server check box. If you do not specify an application server or a job server group in the text box, the created SAP jobs are distributed among the application servers for execution.
When you select this check box, the Define target host system check box is cleared.
Note
If either of the following conditions is satisfied, the server specified in the Server name text box under the selected Define target application server check box is invalid:
-
If Release job as soon as possible or Release job immediately is not selected as the release method in the Monitor dialog box
-
If the job was successfully created but failed to be released
If either of these conditions applies, no execution destination server is set for the jobs created on SAP.
To execute these jobs on a specific execution destination, use the -tgh option or the -tgs option of the jr3bjrel command to specify the execution destination and then release the jobs. If you release the jobs without specifying an execution destination using the jr3bjrel command, the execution destination for the jobs is dynamically selected by the SAP system.
-
- Server name
-
Specify the name of the application server or the job server group that executes jobs. You can specify a character string of 1 to 20 bytes.
When you use an application server, you can specify one of the names (upper-case and lower-case characters are differentiated) that are assigned to the application servers for providing background processing services. These application server names are listed by transaction SM51. When you use a job server group, you can specify one of the names (upper-case and lower-case characters are differentiated) of job server groups containing the application servers that provide background processing services. These job server group names are listed by transaction SM61.
This item corresponds to the -tgs option of the jr3bjsub command.
- Monitor job release and completion
-
Specify whether or not to release the job after you register the job, or whether or not to monitor the completion of the released job.
-
Set button
Use this button to browse or modify the existing settings in the Monitor dialog box that prompts you to specify whether or not to release the job after you register the job, or whether or not to monitor the completion of the released job.
-
- Output results
-
Specify the message that JP1/AJS3 for EAP (program for executing custom jobs) outputs, or specify the method for obtaining logs of SAP jobs whose termination is monitored.
To browse or modify the existing settings, click the Set button on the right.
-
Set button
Use this button to browse or modify the existing settings in the Output Results dialog box that prompts you specify the method for obtaining messages JP1/AJS3 for EAP outputs or log where the completion of the SAP job is monitored.
-
(e) Defining job steps
For details about job step definition, use the Job Step dialog box. The Job Step dialog box opens when you click the Add or Property button in the R/3 Job Definition dialog box.
Figure 3-3 shows the Job Step dialog box for the ABAP program.
|
Figure 3-4 shows the Job Step dialog box for the external program.
|
The items to be defined in the Job Step dialog box are explained below.
Definition items
- Job step
-
Define the program that is to be specified as the job step. You can define either an ABAP program or an external program.
- ABAP program
-
Select this option to define an ABAP program.
- External program
-
Select this option to define an external program.
- Program
-
Specify the name of an ABAP program or an external program to be specified as a job step. For an ABAP program, you can specify a character string of 1 to 40 bytes. In an external program, you can enter a character string of 1 to 128 bytes. You cannot use lower-case alphabetic characters for ABAP programs.
This item corresponds to the -pa option of the jr3bjsub command (for ABAP programs) and the -px option of the jr3bjsub command (for external programs).
- Argument
-
Specify the arguments of the ABAP program or the external program specified in Program. For an ABAP program, you can specify a character string of 1 to 14 bytes. For an external program, you can specify a character string of 1 to 255 bytes. If the specified ABAP program or external program does not have any arguments, you do not need to specify any. For ABAP programs, you cannot use lower-case alphabetic characters.
This item corresponds to the -var option of the jr3bjsub command (for ABAP programs) and the -arg option of the jr3bjsub command (for external programs).
- Temporary Variant
-
Click this button to open the Temporary Variant dialog box to specify a temporary variant of the ABAP program.
- Authorized user
-
Specify the authorized user to be set when the ABAP program or the external program specified in Program is executed. You can specify a character string of 1 to 12 bytes for an ABAP program or an external program. The default authorized user is the user who logs on to the SAP system. You cannot use lower-case alphabetic characters to specify an authorized user.
This item corresponds to the -auth option of the jr3bjsub command.
- Language (for ABAP programs)
-
Use a single-byte alphabetic character to specify the language to be used when ABAP programs are executed. You can use either Japanese or English. Specify the following language supported by the SAP system as the language to be used.
-
For Japanese: J
-
For English: E
You cannot specify a lowercase single-byte character for the language. By default, the language type defined by the destination SAP system is used.
This item corresponds to the -lang option of the jr3bjsub command.
-
- Output device (for ABAP programs)
-
Indicates the output destination of the execution results of the ABAP program. To change the output device, click Change and use the Output Parameters dialog box.
- Change button (for ABAP programs)
-
Click this button to open the Output Parameters dialog box to specify the output destination of the execution results of the ABAP program and the output method.
- Target host system (for external programs)
-
Specify the name of the host that executes the specified external program.
A character string of 1 to 32 bytes can be entered for the target host system.
You can enter host names in the following formats:
-
Host name defined in the hosts file (for example, host1)
-
IP address (for example, 172.16.90.4)
For this item, specify the name of the host on which the application server is running.
This item corresponds to the -xpgtgh option of the jr3bjsub command.
-
(f) Adding a temporary variant
To add the details of a temporary variant, use the Temporary Variant dialog box.
The Temporary Variant dialog box opens when you click the Temporary Variant button in the Job Step dialog box.
The following figure shows the Temporary Variant dialog box.
|
The items to be defined in the Temporary Variant dialog box are explained below.
Definition items
- Temporary variant
-
Select an ABAP program in the Job Step dialog box to specify the temporary variant field for the specified program.
- Program
-
The program specified in the Job Step dialog box is displayed.
- Variant
-
The argument specified in the Job Step dialog box is displayed.
- Set items
-
Click the Add, Delete, or Change button to specify a temporary variant field. The Specified items section shows the items added as temporary variants in the order of definitions in the job definition.
-
Add button
Use this button to add the temporary variant field for the program added as a job step. Define the item names in the Temporary Variant Field dialog box, which appears when you click the Add button.
-
Delete button
Use this button to delete a temporary variant field.
-
Change button
Use this button to modify a temporary variant field.
-
(g) Defining a temporary variant field
To define the details of a temporary variant field, use the Temporary Variant Field dialog box.
The Temporary Variant Field dialog box opens when you click the Add or Change button in the Temporary Variant dialog box.
The following figure shows the Temporary Variant Field dialog box.
|
Definition items
- Temporary Variant Field
-
Specify the temporary variant field for the program specified in the Job Step dialog box.
- Program
-
The program specified in the Job Step dialog box is displayed.
- Variant
-
The argument specified in the Job Step dialog box is displayed.
- Field name
-
Specify the item name of the temporary variant. A character string of 1 to 8 bytes can be entered. You must specify the item name.
This item corresponds to the -selname option of the jr3bjsub command.
- I/E
-
Specify whether to select the temporary variant name specified in Field name. If you specify a single-byte lower-case alphabetic character, it is treated as a single-byte upper-case equivalent. It is not converted into a single-byte upper-case equivalent.
-
Select: I
-
Do not select: E
You can omit I/E. If omitted, the name in question is not selected.
This item corresponds to the -sign option of the jr3bjsub command.
-
- Option
-
Specify the option value# of the temporary variant name specified in Field name. A character string of 1 to 2 bytes can be entered.
#: The option value that is displayed in the Display a Variant window when you start the ABAP Editor on the SAP frontend software
This item corresponds to the -option option of the jr3bjsub command.
- frm
-
Specify the frm value# of the temporary variant name specified in Field name. A character string of 1 to 45 bytes can be entered.
#: The frm value that is displayed in the Display a Variant window when you start the ABAP Editor on the SAP frontend software
This item corresponds to the -frm option of the jr3bjsub command.
- to
-
Specify the to value# of the temporary variant name specified in Field name. A character string of 1 to 45 bytes can be entered.
#: The to value that is displayed in the Display a Variant window when you start the ABAP Editor on the SAP frontend software
This item corresponds to the -to option of the jr3bjsub command.
(h) Defining the print method
To define the details about the method for printing the execution results of the ABAP program, use the Output Parameters dialog box.
The Output Parameters dialog box opens when you click the Change button in the Job Step dialog box (for ABAP programs).
The following figure shows the Output Parameters dialog box.
|
The items to be defined in the Output Parameters dialog box are explained below.
Definition items
- Print parameters
-
Define the method for printing the execution results of the ABAP program.
- Output device
-
Specify an execution result output device using the abbreviation of an output device configured on the SAP system. The lengths of character strings you can specify are from 1 to 4 bytes for the abbreviation. If you omit this option, the default destination that the SAP system defines is assumed.
For the output destination, you cannot specify lowercase single-byte characters. If you do specify such characters, they are converted to uppercase single-byte characters.
This item corresponds to the -out option of the jr3bjsub command.
- Number of copies
-
Specify the number of copies to be printed. The values you can specify are from 1 to 255. The default value is 1.
This item corresponds to the -cc option of the jr3bjsub command.
- Spool request title
-
Specify the title of the spool request. You can specify a title of 1 to 68 bytes. If you omit this item, the spool request title is blank.
This item corresponds to the -title option of the jr3bjsub command.
Note
To specify a title in Spool request title, JP1/AJS2 for EAP 07-50 or later must be installed on the execution destination host and the XBP 2.0 interface must be enabled in the connection destination SAP system.
- Authorization
-
To prevent the invalid operation of spool requests, you can specify an authorized character string of 1 to 12 bytes.
The users, who have the permission for the spool action objects matching with the authorized character string specified in this option, can request spools.
For the authorized character string, you cannot specify lowercase single-byte characters. If you do specify such characters, they are converted to uppercase single-byte characters.
This item corresponds to the -shwpwd option of the jr3bjsub command.
- Print immediately
-
Select this check box to immediately send the execution results of the ABAP program to the printer.
This item corresponds to the -ip option of the jr3bjsub command.
- Set the spool retention period
-
Select this check box if you want to change the default spool period of the SAP system.
This item corresponds to the -rpd option of the jr3bjsub command.
- Delete after printing
-
Select this check box to delete the execution results of the ABAP program after printing. If printing succeeds, the SAP system automatically deletes the print requests associated with the spool requests.
When an error occurs, spool requests, print requests, and the associated logs are kept in the system even if this option is selected.
This item corresponds to the -dp option of the jr3bjsub command.
- Archiving mode
-
Specify a method for archiving the execution results of the ABAP program. You can specify one of the following methods:
-
Print (default)
-
Archive
-
Print and archive
This item corresponds to the -armode option of the jr3bjsub command.
-
- Output format
-
Specify the numbers of lines and columns or the format name for the output format for the execution results of the ABAP program.
- lines
-
Specify the number of lines on each page of the list. You can specify a number from of 1 to 255. If you omit this option, the SAP system assumes the appropriate value.
When you select the By format name check box, the value specified in the lines box is invalid.
This item corresponds to the -ln option of the jr3bjsub command.
- columns
-
Specify the number of columns on each page of the list. You can specify a number from 1 to 255. If you omit this option, the SAP system assumes the appropriate value.
When you select the By format name check box, the value specified in the columns box is invalid.
This item corresponds to the -col option of the jr3bjsub command.
- By format name
-
Specify the name of the desired output format. To do so, select the By format name check box and specify a name in the text box on the right. You can specify a character string of 1 to 16 bytes.
When you select this check box, the values specified in the lines and columns boxes are invalid.
This item corresponds to the -fmt option of the jr3bjsub command.
Note
To specify a format name, JP1/AJS2 for EAP 07-50 or later must be installed on the execution destination host and the XBP 2.0 interface must be enabled in the connection destination SAP system.
- Cover Sheet button
-
Specify whether or not to print the SAP cover or selected-report cover, by browsing or modifying the existing settings in the Cover Sheet dialog box.
- Archive parameters
-
Specify the following archive parameters.
- Object type
-
Specify the object type of the archive document. The lengths of character strings you can specify are from 1 to 10 bytes. If you select Archive or Print and Archive as Archiving mode, you must fill in the Obj type field.
This item corresponds to the -objtyp option of the jr3bjsub command.
- Document type
-
Specify the document type used to classify the archive document. The lengths of character strings you can specify are from 1 to 10 bytes. If you select Archive or Print and Archive as Archiving mode, you must fill in the Doc type field.
This item corresponds to the -doctyp option of the jr3bjsub command.
- Information
-
The left text box shows the ABAP program name. Specify the information ID of the archive document. As well as the report name that generates the print list displayed in the left text box, this information ID is registered as the detailed information of the archive document. The lengths of character strings you can specify are from 1 to 3 bytes. If you select Archive or Print and Archive as Archiving mode, you must fill in the Information field.
This item corresponds to the -info option of the jr3bjsub command.
- Text
-
Enter an explanation about the archive request.
You can enter a character string of 1 to 40 bytes. This text box is available when you select Archive or Print and archive in the Archiving mode text box. You can omit the Text box.
This item corresponds to the -text option of the jr3bjsub command.
Note
To enter an explanation in Text, JP1/AJS2 for EAP 07-50 or later must be installed on the execution destination host and the XBP 2.0 interface must be enabled in the connection destination SAP system.
(i) Attaching a cover to the output results
You can add a SAP cover when printing the execution results of the ABAP program. You define details of the SAP cover in the Cover dialog box.
You can open the Cover dialog box by choosing Cover Sheet in the Output Parameter dialog box.
The Cover dialog box contains the following definition items you specify.
Definition items
- SAP cover sheet
-
Specify whether or not to print a SAP cover. You can select one of the following:
-
Printer default (A SAP cover is printed depending on the settings for the printer to be used)
-
Print
-
Not print
This item corresponds to the -sapcvr option of the jr3bjsub command.
-
- Receiver
-
Enter the recipient name to be printed on the SAP page. The length of the character string you can specify is from 1 to 12 bytes. You cannot include single-byte lower-case alphabetic characters in the receiver name. If you specify single-byte lower-case alphabetic characters, they are converted to upper-case equivalents.
This item corresponds to the -receiver option of the jr3bjsub command.
- Department
-
Enter the name of the department to be printed on the SAP cover.
You can specify a character string of 1 to 12 bytes. If you omit this item, the department set in the profile of the user who is authorized to execute the ABAP program is printed on the SAP cover.
This item corresponds to the -dpt option of the jr3bjsub command.
Note
To specify a name in Department, JP1/AJS2 for EAP 07-50 or later must be installed on the execution destination host and the XBP 2.0 interface must be enabled in the connection destination SAP system.
- Selection cover sheet
-
Print a selected-report cover describing execution conditions for the program.
This item corresponds to the -selcvr option of the jr3bjsub command.
(j) Specifying the job release/completion monitoring method
To specify the job release/completion monitoring method, use the Monitor dialog box.
The Monitor dialog box opens when you click the Set button (for job release/completion monitoring) in the R/3 Job Definition dialog box.
The following figure shows the Monitor dialog box (for job release/completion monitoring).
|
The items to be defined in the Monitor dialog box are explained below.
Definition items
- Monitor job release and completion
-
Specify whether to release a job after you register the job, and whether to monitor the completion of the released job.
- Do not release job
-
Select this option when you only want to register the job without releasing the job. Next time you release this job, be sure to release the job on the SAP system.
- Release job as soon as possible
-
Starts the job as soon as possible after you register the job. The system immediately sets the start conditions, and the SAP system starts the job if a background process is available.
This item corresponds to the -rs option of the jr3bjsub command.
- Release job immediately
-
Immediately starts the registered job. If the system resource for executing the job is not allocated on the system, release of the job fails and the job is left registered.
This item corresponds to the -ri option of the jr3bjsub command.
- Monitoring completion of released job
-
Select this check box to monitor the completion of a released job.
This item corresponds to the -wait option of the jr3bjsub command.
- Include child jobs
-
Select Include child jobs to monitor the completion of all jobs, which includes the child jobs that are generated during the execution of the target job (completion monitoring of parent and child jobs).
This item corresponds to the -with_child option of the jr3bjsub command.
Note
To select Include child jobs, JP1/AJS2 for EAP 07-50 or later must be installed on the execution destination host, and the XBP 2.0 interface and the parent and child function must be enabled in the connection destination SAP system.
- Set the query interval about job status
-
Select this check box to change the interval at which the SAP system will be inquired about the job status.
- Monitor every [ ] seconds
-
Specify the interval at which the SAP system will be queried about the job status. You can specify 1 to 65,535 seconds.
The default query interval is the value specified in the environment settings file. (If a value is not specified in the environment settings file or that file was not created, the default value is 5 seconds.)
This item corresponds to the -ival option of the jr3bjsub command.
- Set monitoring time limit
-
Select this check box to enter the monitoring time. If the SAP job does not stop within the specified monitoring time, execution of the custom job fails.
- Monitor [ ] minutes
-
Specify the time for monitoring the job termination. You can specify 1 to 65,535 seconds. If no job termination monitoring time was specified, monitoring continues indefinitely.
This item corresponds to the -time option of the jr3bjsub command.
- Cancel R/3 job if timeout occurs during execution
-
Use this check box to cancel the executing SAP job if the job does not terminate in the specified monitoring time.
You cannot cancel an inactive job such as a released or ready job. Alternatively, you cannot cancel a job that is executing an external program.
This item corresponds to the -cancel option of the jr3bjsub command.
(k) Specifying the execution result output destination
To specify the execution result output destination, use the Output Results dialog box.
The Output Results dialog box opens when you click the Set button (for execution result output destination) in the R/3 Job Definition dialog box.
The following figure shows the Output Results dialog box (for execution result output destination).
|
The items to be defined in the Output Results dialog box are explained below.
Definition items
- Output results
-
Specify the method for obtaining the log of the messages JP1/AJS3 for EAP outputs and the log of SAP jobs whose termination are monitored.
- Output standard messages to specified file
-
Click this check box when you want to save the standard output messages of JP1/AJS3 for EAP to a specified file, and then enter the name of the destination file. Messages with the information level indicating the execution status of the program are output to the standard output. If the specified file does not exit, it is newly created and messages are always added in the file.
For details about the work directory of the program for executing the custom job, see the manual JP1/Automatic Job Management System 3 Administration Guide.
- File (for standard output messages)
-
Use the full path to specify the name of the output destination file for storing the standard output messages of JP1/AJS3 for EAP. You can enter a character string of 1 to 259 bytes. You can include blank characters in the path.
If you do not specify the full path name for the destination file, the file is created in the JP1/AJS3 for EAP work directory that is specified in the environment setup file for job control. (If the JP1/AJS3 for EAP work directory is not specified in the environment setup file, the file is created in the work directory that is used when a JP1/AJS job is executed.)
For the file name, do not specify a device file, such as /dev/null. If a file for standard output messages is not needed, delete the file that is created.
You can also write standard output messages to this file.
This item corresponds to the -so option of the jr3bjsub command.
- Output standard error messages to specified file
-
Select this check box when you want to save the standard error output messages of JP1/AJS3 for EAP to a specified file, and then enter the name of the destination file. Messages with the caution and error level are output to the standard error output. If the specified file does not exit, it is newly created and messages are always added in the file.
For details about the work directory of the program for executing the custom job, see the manual JP1/Automatic Job Management System 3 Administration Guide.
- File (for standard error output messages)
-
Use the full path to specify the name of the output destination file for storing the standard error output messages of JP1/AJS3 for EAP. You can enter a character string of 1 to 259 bytes. You can include blank characters in the path.
If you do not specify the full path name for the destination file, the file is created in the JP1/AJS3 for EAP work directory that is specified in the environment setup file for job control. (If the JP1/AJS3 for EAP work directory is not specified in the environment setup file, the file is created in the work directory that is used when a JP1/AJS job is executed.)
For the file name, do not specify a device file, such as /dev/null. If a file for standard error output messages is not needed, delete the file that is created.
You can also write standard output messages to this file.
This item corresponds to the -se option of the jr3bjsub command.
- Output the R/3 job log to specified file
-
Select this check box when you want to obtain the log of an SAP job which ceased to be monitored, and then enter the name of the destination file. If the specified file does not exit, it is newly created and messages are always added in the file.
For details about the work directory of the program for executing the custom job, see the manual JP1/Automatic Job Management System 3 Administration Guide.
- File (for SAP job log)
-
Use the full path to specify the name of the output destination file for the SAP job log. You can specify a character string of 1 to 259 bytes. You can include blank characters in the path.
If you do not specify the full path name for the destination file, the file is created in the JP1/AJS3 for EAP work directory that is specified in the environment setup file for job control. (If the JP1/AJS3 for EAP work directory is not specified in the environment setup file, the destination file is created in the work directory that is used when a JP1/AJS job is executed.)
For the SAP job log file name, do not specify a device file, such as /dev/null. If the SAP job log file is not needed, delete the file that is created.
You can also write the SAP job log to this file.
If you specify YES for the JoblogAddToStderr key of the Command section of the environment settings file, you can output the SAP job log to the specified file and to the standard error output at the same time. Therefore, if the Output standard error messages to specified file check box is not selected, you can use JP1/AJS - View to view the contents of the SAP job log as follows:
-
When you specify an output destination file for standard error output messages
You can output the SAP job log to the specified output destination file for standard error output messages.
-
When you do not specify an output destination file for standard error output messages, but specify a standard error output file name in the Define Details - [Custom Job] dialog box of JP1/AJS - View
You can view the content of the SAP job log in the Execution Result Details dialog box in the Jobnet Monitor window of JP1/AJS - View.
This item corresponds to the -jo option of the jr3bjsub command.
-
Get message type in R/3 job log#
When you collect SAP job logs, select the Get message type in R/3 job log check box if you also want to collect message types. The message type can be collected only if SAP job logs are collected.
This item corresponds to the -mt option of the jr3bjsub command.
-
Search message type#
Select this check box if you want to terminate a custom job command abnormally with the return value 4 when the specified character is contained in the message types of the collected SAP job logs.
This item corresponds to the -mts option of the jr3bjsub command.
-
Search Target letters#
Specify the search target character in the message types of the collected SAP job logs as a character output to the message type.
If you specify more than one character, the search means that any of the specified characters are contained. A character string of 1 to 8 bytes can be entered. You must specify it if you search the message types.
This item corresponds to the message-type-character-string option specified in the -mts option of the jr3bjsub command.
#: If JP1/AJS is configured not to monitor the completion of SAP jobs in the Monitor job release and completion dialog box, or if SAP job logs are not stored in a file, this item is inactive.
-
For details about the work directory that is used when JP1/AJS jobs are executed, see the manual JP1/Automatic Job Management System 3 System Design (Configuration) Guide.
(l) Defining environment variables
To add, edit, or delete environment variables, use the Environment Variable dialog box (for job control functionality).
To open the Environment Variable dialog box (for job control functionality) from the Environment Variables page, click the Add button. To open the Environment Variables page, click the Environment Variables tab.
The following figure shows the Environment Variables page.
|
The items to be defined in the Environment Variables page are explained below.
-
Definition items
- Environment variables
-
An area used to specify environment variables for JP1/AJS3 for EAP.
Defined environment variables
A list control used to add, edit, and delete environment variable definitions for JP1/AJS3 for EAP. The names and values of the defined environment variables are displayed in the order of definitions.
You can define up to 10 environment variables whose total size is no more than 20,411 bytes.
- Add
-
Opens an empty Environment Variable dialog box (for job control functionality).
A newly defined environment variable will be added before the environment variable selected when the Add button is clicked. (If nothing is selected, the variable will be added to the top.)
- Edit
-
Applies the environment variable selected in the list control, and opens the Environment Variable dialog box (for job control functionality). (Double-clicking the environment variable selected in the list control also executes the same operation.)
If no environment variable is selected in the list control, this button is inactive.
- Delete
-
Deletes the environment variable definition selected in the list control. (Pressing the Delete key also executes the same operation.)
If no environment variable is selected in the list control, this button is inactive.
The items to be defined in the Environment Variable dialog box (for job control functionality) are explained below.
-
Definition items
- Environment variable
-
An area used to specify environment variables for JP1/AJS3 for EAP.
- Variable name
-
Specify the name of an environment variable by using a character string of 1 to 259 bytes. Entering a value for this item is mandatory.
- Variable value
-
Specify the value of an environment variable by using a character string of 1 to 2,047 bytes. Entering a value for this item is mandatory.
- OK
-
Temporarily saves the specified items into the program, and then closes the dialog box. To save the settings into the definitions, in the main window, click the OK button to close the program. (If this button is highlighted, pressing the Enter key also executes the same operation.)
The specified environment variables are temporarily saved in the following format, which is the same as the storage format for job definitions:
environment-variable-name-1=value-1<linefeed>
environment-variable-name-2=value-2<linefeed>
If double quotation marks (") or hash marks (#) are contained in an environment variable, such symbols are escaped with a hash mark (#) as follows, and then the environment variable is temporary saved:
" -> #"
# -> ##
If the size of the defined environment variables exceeds 20,411 bytes, an error dialog box is displayed.
- Cancel
-
Deletes the specified items, and then closes the dialog box. (Pressing the ESC key also executes the same operation.)