jr3bjsho

Organization of this page

Format 1
Format 2
Description
Arguments
Return values
Usage examples

Format 1

jr3bjsho  [R/3-destination-information]
          [R/3-logon-information]
          [redirection-information]
          -jn job-name
          [-jc job-count]
          [-user SAP-user-name]
          [-status status-name]
          [-check]
          [-ls]
          [-lo [-mt]]

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

To Page Top

Format 2

jr3bjsho -help

To Page Top

Description

Displays the information (including the R/3 job log) about R/3 system background jobs in list or detailed list format.

The characteristics of the display formats are summarized below.

When list format is used

Information about a job complying with the an option-specified pattern can be displayed in list format.
When detailed form is used

Job information, including job step information and R/3 job log information, can be displayed in detailed list format. The -ls and -lo options can be used.

Individual items of information in the prescribed format are transferred to the standard output. The -ls and -lo options can be specified in any order.

To Page Top

Arguments

`R/3-destination-information`

Specify the R/3 system where the job about which information is to be displayed 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 the logon information that is valid in the R/3 system where the job about which information is to be displayed 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 about which information is to be displayed. 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 the -jn option specification cannot be omitted.

`-jc` `job-count`

To differentiate jobs having the same name, specify the job count. If the job count specification is omitted, information about all jobs having the same name is displayed.

`-user` `SAP-user-name`

This argument displays information about 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.

`-status` `status-name`

This argument displays only jobs that are specified by the -jn option and in the specified state. Note that one or more status names can be specified (e.g., -status RYF). If there are duplicate status name specifications, they are handled as one status name.

The characters that can be specified and their meaning are shown below.

P: Scheduled

S: Released

Y: Ready

R: Active

F: Finished

A: Terminated

`-check`

This argument displays the latest R/3 system job information.

`-ls`

This argument displays the job attribute information in detailed list format.

`-lo`

This argument displays an R/3 job log if there is one for the target job.

`-mt`

Specify this option if the message type is output to the R/3 job log. If this option is omitted, the message type is not collected.

If the -lo option is not specified, this option cannot be specified.

`-help`

This argument provides information on using the command.

To Page Top

Return values

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

To Page Top

Usage examples

Displaying job information about job JOB0129 in list format

The conditions are as follows:
- R/3 destination information will be specified (-h R3CENTRL -s 00).
- R/3 logon information will be specified (-c 000 -u R3USER1 -p2 HT0110).
- The standard output file and standard error output file will be created in the system's standard output and standard error output, respectively.
To display the job information about job JOB0129 in list format under the above conditions, make sure that the jr3bjsho command line is specified as follows:
```
jr3bjsho -h R3CENTRL -s 00 -c 000 -u R3USER1 -p2 HT0110  -jn KEISAN-1
```
Output result:
Displaying the job information about job JOB0129 in detailed list format

The conditions are as follows:
- R/3 destination information will be specified (-h R3CENTRL -s 00).
- R/3 logon information will be specified (-c 000 -u R3USER1 -p2 HT0110).
- The job count will be specified (-jc 13531901).
- The standard output file and standard error output file will be created in the system's standard output and standard error output, respectively.
To display the job information about job JOB0129 in detailed list format under the above conditions, make sure that the jr3bjsho command line is specified as follows:
```
jr3bjsho -h R3CENTRL -s 00 -c 000 -u R3USER1 -p2 HT0110 -jn KEISAN-1 -jc 13531901 -ls -lo
```
Output result:

To Page Top