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

(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 Job Management Partner 1/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 Job Management Partner 1/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‒8: 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. You must also specify values in Client, SAP user name, Password, and Language.

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‒9: 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