3.2.3 Defining a custom job

In the Jobnet Editor window of JP1/AJS, define the custom job that you registered in JP1/AJS in a jobnet.

To define a custom job for use with the SAP BW system:

Organization of this subsection

(1) Defining a custom job (PC job)
(2) Defining a custom job (UNIX job)
(3) Specifying the method for connecting to the SAP BW system
(4) Defining InfoPackage or a process chain
(5) Defining environment variables

(1) Defining a custom job (PC job)

Display the jobnet definition area in the Jobnet Editor window of JP1/AJS.
Select the Custom Jobs tab, and then drag the registered SAP BW system custom job and drop it onto the jobnet definition area.

The SAP BW system 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 end of InfoPackage or a process chain (the return value of the jbwipsta command is 1) and other errors (the return value of the jbwipsta 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 end of InfoPackage or a process chain (the return value of the jbwipsta command is 1) and handle other errors (the return value of the jbwipsta command is 2 or greater) as abnormal conditions:
  
  Rule
  
  Select Judgment by threshold.
  
  Warning
  
  Specify 0.
  
  Abnormal
  
  Specify 1.
Choose the Details button.

The SAP BW InfoPackage/Process Chain Definition dialog box is displayed.
Specify the following information in the SAP BW InfoPackage/Process Chain Definition dialog box.
- Specify the method for connecting to the SAP BW system containing InfoPackage or a process chain to be started.
- Define InfoPackage or a process chain.
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.

To Page Top

(2) Defining a custom job (UNIX job)

Display the jobnet definition area in the Jobnet Editor window of JP1/AJS.
Select the Custom Jobs tab, and then drag the registered SAP BW system custom job and drop it onto the jobnet definition area.

The SAP BW system custom job is added to the jobnet definition area and the Define Details - [Custom Job] dialog box is displayed.
Define Command statement.

Define the command line for the jbwipsta command.
Specify the End judgment.
- If you want JP1/AJS to handle an abnormal end of InfoPackage or a process chain (the return value of the jbwipsta command is 1) and other errors (the return value of the jbwipsta 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 end of InfoPackage or a process chain (the return value of the jbwipsta command is 1) and handle other errors (the return value of the jbwipsta command is 2 or greater) as abnormal conditions:
  
  Rule
  
  Select Judgment by threshold.
  
  Warning
  
  Specify 0.
  
  Abnormal
  
  Specify 1.
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.

To Page Top

(3) Specifying the method for connecting to the SAP BW system

To specify the method for connecting to the SAP BW system containing InfoPackage or a process chain to be started, use the SAP BW System page of the SAP BW InfoPackage/Process Chain Definition dialog box.

The following figure shows the SAP BW System page.

Figure 3‒16: SAP BW System page - SAP BW InfoPackage/Process Chain Definition dialog box)

The items to be defined in the SAP BW System page are explained below.

Definition items

Destination

Specify the method for connecting to the application server in the SAP BW system containing InfoPackage or a process chain to be started. 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 which you want to connect.

Host name

Specify the host name of the application server (or SAP router) to which you want to connect. You can enter a character string of 1 to 100 bytes for the host name.

You can use host names in the following formats:

Host name defined in the hosts file
IP address
SAP router address

For details about the SAP router address format, see the R/3 manual or online help.

This item corresponds to the -h option of the jbwipsta command.

System number

Specify the target system number on the SAP BW system. You can enter a character string of 1 or 2 bytes for the system number. Only numerals can be used. The default is 0.

This item corresponds to the -s option of the jbwipsta command.

Connect by sapnwrfc.ini file

Select this option when you want to use the sapnwrfc.ini file to connect to the application server.

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

Specify the value that was specified for DEST in the sapnwrfc.ini file. You can enter a character string of 1 to 32 bytes for the destination.

This item corresponds to the -d option of the jbwipsta command.

Logon

Specify the logon information to be used for connecting to the application server specified in Destination. 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 jbwipsta command.

Client

Specify the client number of the logon destination SAP BW client. You can enter a character string of 1 to 3 bytes for the client number. Only numerals can be used. When a SAP BW client number of 1 or 2 bytes is to be sent to the SAP BW system, it is converted to 3 bytes. For example, if the client number is 001, you can specify 1, 01, or 001. However, when this client number is sent to the SAP BW system, it is sent as the 3-byte client number 001.

This item corresponds to the -c option of the jbwipsta command.

SAP user name

Specify the user name of the user who executes InfoPackage or a process chain. InfoPackage or the process chain is executed with the specified user name.

For details about the users who can be specified, see 2.3.9 Providing a SAP user for InfoPackage control or process chain control.

You can enter a character string of 1 to 12 bytes for the user name. You cannot include single-byte lower-case alphabetic characters in the user name.

This item corresponds to the -u option of the jbwipsta command.

Password

Enter the password or extended password for the user specified in SAP user name who executes InfoPackage or a process chain. To use an extended password, select the Use an extended password check box. 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

Enter a single-byte alphabetic character to specify the language to be used. You can use either Japanese or English. Specify the following language supported by the SAP BW 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 BW system is used:

Language type specification is omitted.
A language type not defined by the destination SAP BW system is specified.

The language type specified for this item 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 jbwipsta command.

To Page Top

(4) Defining InfoPackage or a process chain

To define InfoPackage or a process chain, use the SAP BW InfoPackage or Process Chain Definition page of the SAP BW InfoPackage/Process Chain Definition dialog box.

The following figure shows the SAP BW InfoPackage or Process Chain Definition page.

Figure 3‒17: SAP BW InfoPackage or Process Chain Definition page - SAP BW InfoPackage/Process Chain Definition dialog box

The items to be defined in the SAP BW InfoPackage or Process Chain Definition page are explained below.

Definition items

Start InfoPackage or process chain

Specify information about the InfoPackage or process chain to be started.

InfoPackage

Select this option to start InfoPackage.

process chain

Select this option to start a process chain.

ID

Specify the ID of the InfoPackage or the process chain to be started. You can enter a character string of 30 bytes (fixed) for InfoPackage and from 1 to 25 bytes for a process chain. You cannot specify lower-case alphabetic characters in this text box.

This item corresponds to the -ip option or the -pc option of the jbwipsta command.

Monitor InfoPackage or process chain completion

Specify information about completion monitoring when you want to monitor the completion of the started InfoPackage or process chain. When you choose the Reset button, the values specified in this box are replaced by the default values.

To monitor the completion of InfoPackage, the SAP BW system side requires a setting that changes the signal to green or red when InfoPackage ends with an error. For details about this setting, see 2.3.8 Specifying the action to take when InfoPackage ends with a warning on the SAP BW system.

Monitoring completion of started InfoPackage or process chain

Select this option when you want to monitor the completion of the started InfoPackage or process chain.

The completion of InfoPackage or a process chain is judged by acquiring the following statuses from the SAP BW system:

Monitor InfoPackage Completion

The InfoPackage request status that can be checked in the Monitors tree of the transaction RSMON (Total and Technical status displayed in the Status tab)
Monitor Process Chain Completion

The process chain status that can be checked in the Log view window of the transaction RSPC

This item corresponds to the -wait option of the jbwipsta command.

Set InfoPackage or process chain status monitoring interval

Select this check box when you want to specify an interval for querying the SAP BW system about the status of InfoPackage or a process chain.

Monitor every [ ] seconds

Specify in seconds the interval for querying the SAP BW system about the status of InfoPackage or a process chain. The specifiable range is from 1 to 65,535. The default monitoring interval is the value specified in the environment setup file. (If no value was specified in the environment setup file or no environment setup file was created, 5 seconds is assumed.)

This item corresponds to the -ival option of the jbwipsta command.

Set monitoring time limit

Select this check box when you want to specify the length of time for monitoring the completion of the started InfoPackage or process chain.

Monitor [ ] minutes

Specify in minutes the length of time for monitoring the completion of InfoPackage or a process chain after it starts. The specifiable range is from 1 to 65,535. If no completion monitoring time is specified for InfoPackage or the process chain, monitoring continues indefinitely.

This item corresponds to the -time option of the jbwipsta command.

Set the waiting period for after InfoPackage ends normally

Select this check box to set the length of time (wait time) between the normal end of InfoPackage and the end of the job that executes InfoPackage.

Wait for [ ] seconds

Specify in seconds the length of time (wait time) between the normal end of InfoPackage and the end of the job that executes InfoPackage. JP1/AJS3 for EAP cannot monitor the completion of a QM action (enables the loaded data) that is executed after loading of the InfoPackage data or the completion of subsequent InfoPackage processing (such as deleting duplicated requests). To execute a succeeding job after these types of processing, specify the wait time here.

You can specify a value from 0 to 65,535. If you do not specify the wait time, the number of seconds set for the QMActionWaitTime key (in the command section) in the environment setup file is assumed.

This item corresponds to the -qmwait_time option of the jbwipsta command.

To Page Top

(5) Defining environment variables

To add, edit, or delete environment variables, use the Environment Variable dialog box (for InfoPackage or process chain control functionality).

To open the Environment Variable dialog box (for InfoPackage or process chain 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.

Figure 3‒18: Environment Variables page - SAP BW InfoPackage/Process Chain Definition dialog box

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,479 bytes.

Add

Opens an empty Environment Variable dialog box (for InfoPackage or process chain 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 InfoPackage or process chain 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 InfoPackage or process chain 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,479 bytes, an error dialog box is displayed.

Cancel

Deletes the specified items, and then closes the dialog box. (Pressing the ESC key

To Page Top