jr3bjcan

Organization of this page

Format 1
Format 2
Description
Arguments
Return values
Usage examples

Format 1

jr3bjcan [R/3-destination-information]
          [R/3-logon-information]
          [redirection-information]
           -jn job-name
          [-jc job-count]
          [-user SAP-user-name]

Note: If the character string for the argument specification contains a space, enclose the argument with double quotation marks (").

To Page Top

Format 2

jr3bjcan -help

To Page Top

Description

Cancels a background job while an ABAP program job step is active (being executed).

The jr3bjcan command ends abnormally if an attempt is made to cancel a job in the following states:

Execution of the job has not started (the job is in the scheduled state).
The job that is specified to start execution is still waiting for execution (the job is in the released or ready state).
The job has ended (either finished or terminated).
The job is active and an external program job step is currently being executed.

If the SAP kernel patch and profile parameters described in SAP Note 903769 are set in the connection destination R/3 system, you can use the jr3bjcan command to cancel the job even if a job step corresponding to an external program is being executed.

For details about the applicable SAP kernel patch and profile parameters, see the aforementioned SAP Note 903769.

When the jr3bjcan command ends normally, the job being executed by the R/3 system is placed in the terminated state.

To Page Top

Arguments

`R/3-destination-information`

Specify the R/3 system where the job to be canceled exists. For details about the format of R/3 destination information, see (1) Common argument format for job control function commands.

`R/3-logon-information`

Specify logon information that is valid in the R/3 system where the job to be canceled exists. For details about the format of R/3 logon information, see (1) Common argument format for job control function commands.

`redirection-information`

Specify standard output and standard error output files for command execution. For details about the format of redirection information, see (1) Common argument format for job control function commands.

`-jn` `job-name`

Specify the job name of the job to be canceled. A character string of 1 to 32 bytes can be entered for the job name specification. If there are duplicate job names in the specified R/3 system, enter the job count with the -jc option to specify the job.

Note that you must specify the -jn option.

`-jc` `job-count`

To differentiate jobs having the same name, specify the job count. If the job count specification is omitted, all the jobs having the same name are canceled.

`-user` `SAP-user-name`

This argument cancels only the jobs that are specified by the -jn option and owned by the specified SAP user. A character string of 1 to 12 bytes can be entered for the SAP user name specification.

`-help`

This argument provides information on using the command.

To Page Top

Return values

0: All the specified jobs were successfully canceled.
Integer of 1 or more: The specified jobs were not canceled successfully.

To Page Top

Usage examples

Canceling job R3JOB1 of user R3USER1

The conditions are as follows:
- The sapnwrfc.ini file will be used (-d R3SERV1).
- R/3 logon information will be specified (-c 001 -u R3USER1 -p2 HT0110).
- The job count will be specified (-jc 15520501).
- The standard output file and standard error output file will be created in the directory specified by the environment setup file (-so STDOUT1 -se STDERR1).
To cancel job r3job1 of user r3user1 under the above conditions, specify the jr3bjcan command line as follows:
```
jr3bjcan -d R3SERV1 -c 001 -u R3USER1 -p2 HT0110 -jn R3JOB1 -jc 15520501 -user R3USER1 -so STDOUT1 -se STDERR1
```

To Page Top