jbwipsta
- Organization of this page
Format 1
jbwipsta [SAP-BW-destination-information] [SAP-BW-logon-information] {-ip InfoPackage-ID | -pc process-chain-ID} [-wait [-time monitoring-time] [-ival monitoring-interval] [-qmwait_time wait-time]]
Format 2
jbwipsta -help
Description
Starts InfoPackage or a process chain defined beforehand on the SAP BW system.
-
To start InfoPackage
When InfoPackage is successfully started, the SAP BW system assigns a request number to identify the InfoPackage request. This request number is output to the standard output as part of a message.
The user can use the request number to check the status of InfoPackage with the SAP front-end software.
-
To start a process chain
When a process chain is successfully started, the SAP BW system assigns a log ID to identify the execution log of the process chain. This log ID is output to the standard output as part of a message. The user can use the log ID and the SAP front-end software to check the status of the process chain and the execution log.
Arguments
SAP-BW-destination-information
Specify the SAP BW system where the InfoPackage or the process chain to be started is registered. For details about the format of SAP BW destination information, see (2) Argument formats for the command of the InfoPackage control function and the process chain control function.
SAP-BW-logon-information
Specify the logon information that is valid in the SAP BW system where the InfoPackage or the process chain to be started is registered. For details about the format of SAP BW logon information, see (2) Argument formats for the command of the InfoPackage control function and the process chain control function.
-ip InfoPackage-ID
Specify the ID of the InfoPackage to be started. You can enter a character string of 30 bytes (fixed) for the InfoPackage ID.
You must specify either the -ip option or the -pc option. You cannot specify both simultaneously.
-pc process-chain-ID
Specify the ID of the process chain to be started. You can specify a character string of 1 to 25 bytes.
You must specify either the -ip option or the -pc option. You cannot specify both simultaneously.
-wait
This argument monitors the started InfoPackage or process chain until its completion (until InfoPackage or process chain execution ends, commands cannot be executed from the command line).
The completion of InfoPackage or the process chain is evaluated by acquiring the following statuses from the SAP BW system.
-
Monitoring of InfoPackage Completion
The InfoPackage request status that can be checked in the Monitors tree of the transaction RSMON (Total and Technical statuses displayed in the Status tab)
-
Monitoring of Process Chain Completion
The process chain status that can be checked in the Log view window of the transaction RSPC
-time monitoring-time
Specify the length of time to monitor the completion of InfoPackage or a process chain (in minutes). The completion of InfoPackage or the process chain is monitored for the specified length of time. Make sure that this monitoring time setting is greater than the monitoring interval value that is specified by the -ival option. The specifiable range for the monitoring time is from 1 to 65,535. If the -time option is omitted, there is no limit on the monitoring time.
If InfoPackage or the process chain does not end within the specified monitoring time, InfoPackage or process chain monitoring results in a timeout error and the command ends regardless of the status of InfoPackage or the process chain.
The -time option is valid when the -wait option is specified.
-ival monitoring-interval
Specify the interval in seconds at which InfoPackage or a process chain is to be monitored. InfoPackage or a process chain can be monitored at the specified monitoring interval until InfoPackage or the process chain ends (InfoPackage or process chain polling monitoring). The specifiable range for the monitoring interval is from 1 to 65,535. If a monitoring interval is omitted when the -ival option is specified, the monitoring interval is 5 seconds.
The default monitoring interval of 5 seconds can be changed in the environment setup file.
The -ival option is valid when the -wait option is specified.
-qmwait_time wait-time
Specify the length of time (wait time in seconds) between the normal end of InfoPackage and the end of the job that executes the 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 the subsequent processing of InfoPackage (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 omit the -qmwait_time option, the number of seconds set for the QMActionWaitTime key (command section) in the environment setup file is assumed.
The -qmwait_time option is valid when the -ip and -wait options are specified.
-help
This argument provides information on using the command.
Return values
-
When the -wait option is not specified
- 0
-
InfoPackage or a process chain was successfully started.
- Integer of 1 or more
-
InfoPackage or a process chain was not started.
-
When the -ip and -wait options are specified
- 0
-
InfoPackage ended normally.
- 1
-
InfoPackage ended abnormally.
- 2
-
Timeout occurred before InfoPackage completion was detected.
- Integer of 3 or more
-
The command ended abnormally (InfoPackage startup failed or completion monitoring failed).
-
When the -pc and -wait options are specified
- 0
-
The process chain ended normally.
- 1
-
The process chain ended abnormally or forcibly.
- 2
-
A timeout error occurred before process chain completion was detected.
- Integer of 3 or more
-
The command ended abnormally (process chain startup failed or completion monitoring failed).
Precautions
-
When starting InfoPackage
-
To start InfoPackage using this command, you must define the InfoPackage in SAP BW beforehand and confirm that it operates normally.
-
To be able to start InfoPackage using this command, you must enter a definition beforehand that enables InfoPackage to be started by background processing. To do so, select background processing in the definition of the InfoPackage scheduler and set immediate execution as the startup condition for starting InfoPackage in the background.
-
To monitor the completion of InfoPackage using this command, you need to specify that the signal color changes to blue or red when InfoPackage ends with a warning. To do so, open the Monitor window of the administrator work bench, and choose Settings -> Evaluation of requests (traffic lights). In the opened dialog box, select is judged to be successful (green lights) or is thought to have errors (red lights) in If no data is available in the system, the request and If warning arise during processing, the request.
-
-
When starting a process chain
-
To start a process chain using this command, you must define the process chain in SAP BW beforehand and confirm that it operates normally.
-
To start a process chain using this command, you must define the process chain so it can be immediately executed from a non-SAP BW system. To do so, in the startup process of the process chain, select Start Using Meta Chain or API.
-
When JP1/AJS re-executes a job that executes a process chain, the process chain is re-executed from the beginning, not from the process that has failed. Therefore, if you want JP1/AJS to re-execute jobs that execute process chains, we recommend that you create each process chain in the smallest re-executable unit as possible.
-
Usage examples
-
Start InfoPackage under the following conditions:
-
SAP BW destination information is specified (-h bw20b01 -s 00).
-
SAP BW logon information is specified (-c 100 -u JP1 -p2 bw2001 -l J).
-
InfoPackage is specified (-ip ZPAK_54QRO40UDA09WUQDLD92RSYRL).
-
InfoPackage completion is to be monitored (-wait -time 10 -ival 10).
To start InfoPackage under the above conditions, make sure that the jbwipsta command line is specified as follows:
jbwipsta -h bw20b01 -s 00 -c 100 -u JP1 -p2 bw2001 -l E -ip ZPAK_54QRO40UDA09WUQDLD92RSYRL -wait -time 10 -ival 10
-
-
Start the process chain under the following conditions:
-
SAP BW destination information is specified (-h bw35001 -s 00).
-
SAP BW logon information is specified (-c 100 -u JP1 -p2 bw35001 -l J).
-
A process chain is specified (-pc ZPC_HRCALCMNTH)
-
Process chain completion is to be monitored (-wait -time 30 -ival 5).
To start the process chain under the above conditions, make sure that the jbwipsta command line is specified as follows:
jbwipsta -h bw35001 -s 00 -c 100 -u JP1 -p2 bw35001 -l E -pc ZPC_HRCALCMNTH -wait -time 30 -ival 5
-