jr3bjcan
- Organization of this page
Format 1
jr3bjcan [SAP-destination-information] [SAP-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 (").
Format 2
jr3bjcan -help
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 SAP 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 SAP system is placed in the terminated state.
Arguments
SAP-destination-information
Specify the SAP system where the job to be canceled exists. For details about the format of SAP destination information, see (1) Common argument format for job control function commands.
SAP-logon-information
Specify logon information that is valid in the SAP system where the job to be canceled exists. For details about the format of SAP 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 SAP 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.
Return values
- 0
-
All the specified jobs were successfully canceled.
- Integer of 1 or more
-
The specified jobs were not canceled successfully.
Usage examples
-
Canceling job R3JOB1 of user R3USER1
The conditions are as follows:
-
The sapnwrfc.ini file will be used (-d R3SERV1).
-
SAP 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
-