Hitachi

JP1 Version 12 JP1/Automatic Job Management System 3 for Enterprise Applications Description, User's Guide and Reference


3.1.2 Copying an existing R/3 job

Organization of this subsection

(1) Procedures for executing R/3 jobs

Before you can use JP1/AJS to execute R/3 jobs, you must perform the following tasks. These tasks will vary depending on the OS of the machine on which JP1/AJS - View is installed.

(a) If JP1/AJS3 for EAP is installed on a Windows machine

Procedure 1

Environment settings

If the machine on which JP1/AJS3 for EAP is installed runs Windows, manually copy the following programs provided by JP1/AJS3 for EAP to the machine on which JP1/AJS - View is installed:

  • installation-folder\Program\jr3cpcjd.exe (definition program)

  • installation-folder\Program\jr3cpcjd.ini (initialization file)

Copy the above files to the same folder located anywhere on the machine on which JP1/AJS - View is installed.

If you are using multiple versions of JP1/AJS3 for EAP, copy the latest versions of JP1/AJS3 for EAP files to the machine on which JP1/AJS - View is installed.

When migrating from an earlier version, if you update a custom job definition module on a machine on which JP1/AJS2 - View is installed, delete all modules copied by earlier versions, and then copy a module that has a later version. In addition, if JP1/AJS - View of version 12-00 or earlier is linked, copy the following file to the JP1/AJS - View installation location:

Copied from:
  • installation-folder\Image\CUSTOM_PC_JP1AMR3CP.gif

Copied to:
  • JP1/AJS - View installation-folder\image\custom

Procedure 2

Custom job registration

Procedure 3

Custom job definition

When the above procedures are completed and the JP1/AJS jobnet is started for execution of the R/3 system custom job, the job is created in the R/3 system and then executed.

(b) If JP1/AJS3 for EAP is installed on a Linux machine

If JP1/AJS - View of version 12-00 or earlier is linked, copy the following file to the JP1/AJS - View installation location:

Copied from:
  • installation-folder\Image\CUSTOM_UX_JP1AMR3CP.gif

Copied to:
  • JP1/AJS - View installation-folder\image\custom

(2) Registering a custom job

Register the files as custom jobs in the Register Custom Job dialog box of JP1/AJS - View.

To register a custom job:

  1. Display the Register Custom Job dialog box in JP1/AJS - View.

    [Figure]

  2. Choose the Add button.

    [Figure]

    The Set Properties of Custom Job dialog box is displayed.

  3. Register the custom job for the R/3 system.

    Specify information in the entry boxes of the dialog box as described below.

    Name

    Specify a name from 1 to 8 bytes for the custom job of JP1/AJS3 for EAP.

    Comment

    You can enter a comment from 1 to 40 bytes long. You cannot include slashes (/) and blank characters in comments. You can omit Comment.

    Defining program

    Specify the pathname of the jr3cpcjd.exe program you have manually copied for defining the custom job.

    Note that you need not specify Defining program when you select UNIX in Job Type.

    Executing program

    Specify installation_folder\Program\jr3bjcpy.exe as the pathname of the program for executing the custom job on the JP1/AJS - Agent (or JP1/AJS - Manager) machine.

    Notes

    •You need not specify Executing program when you select UNIX in Job Type.

    • If the path to the JP1/AJS3 for EAP installation folder is different for different machines, define a job execution work path as a variable in JP1/AJS3. If you do not specify this setting, the message (KAVU4550-W) indicating that no executable file was found during job execution is output to the Execution Result Details dialog box of JP1/AJS3 - View, and the job cannot be executed.

    For the setup method, see the manual JP1/Automatic Job Management System 3 Operator's Guide.

    Version

    Specify 0600.

    Class

    Specify JP1AMR3CP.

    Job Type

    Select PC if the JP1/AJS - Agent (or JP1/AJS - Manager) machine on which JP1/AJS3 for EAP is installed is a Windows machine. Select UNIX if it is a Linux machine.

  4. Choose the OK button.

For more details on how to register custom jobs, see the manual JP1/Automatic Job Management System 3 Operator's Guide.

(3) Defining a custom job

In the Jobnet Editor window of JP1/AJS, define the registered custom job in a jobnet.

To define a custom job for use with the R/3 system:

(a) Defining a custom job (PC job)

  1. Use the Jobnet Editor window of JP1/AJS to display the jobnet definition area.

  2. Select the Custom Jobs tab, and then drag the registered custom job to be used with the R/3 system and drop it onto the jobnet definition area.

    The registered custom job is added to the jobnet definition area and the Define Details - [Custom Job] dialog box is displayed.

    [Figure]

  3. Specify the end judgment.

    • If you want JP1/AJS to handle an abnormal job end (the return value of the jr3bjcpy command is 1) and other errors (the return value of the jr3bjcpy 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 job end (the return value of the jr3bjcpy command is 1) and handle other errors (the return value of the jr3bjcpy command is 2 or greater) as abnormal conditions:

      Rule

      Select Judgment by threshold.

      Warning

      Specify 0.

      Abnormal

      Specify 1.

    • If you want JP1/AJS to handle an abnormal job end (the return value of the jr3bjcpy command is 1, or 5 or greater) as abnormal conditions and handle other errors (the return value of the jr3bjcpy command is between 2 and 4) as warnings:

      Rule

      Select Judgment by threshold.

      Warning

      Specify no value.

      Abnormal

      Specify 4 (the upper limit for the return value handled as a warning).

    The subsequent judgment job determines if the return value is a value from 1 to 4. For details about the setup method, see the chapter that contains definition examples of jobnets with judgment jobs in the manual JP1/Automatic Job Management System 3 System Design (Work Tasks) Guide.

  4. Choose the Details button.

    The R/3 Job Copy Definition dialog box is displayed.

  5. Copy define the attributes of the R/3 request.

    Specify the following information in the dialog box.

    • Specify the method for connecting to the R/3 system to use for the copy of the R/3 job.

    • Define the R/3 job.

    • Specify the job release/completion monitoring settings.

    • Specify the execution result output destination.

    Note

    When specifying the job cancellation time in the Define Details - [Custom Job] dialog box, make sure that the setting is longer than the job cancellation time specified by JP1/AJS3 for EAP.

  6. Choose the OK button.

For more details on how to define custom jobs, see the manual JP1/Automatic Job Management System 3 Operator's Guide.

Important

The custom job definition program of the R/3 job internally generates the command line for the jr3bjcpy command based on the input information.

The maximum length of this command line is 1,020 bytes. If this length is exceeded, the error: The generated command line (byte-count-of-the-generated-command-line bytes) exceeded the maximum length (1,020 bytes). Definition information cannot be saved. occurs in the custom job definition program.

Depending on the R/3 job definition, such as when multiple job steps are assigned to a single job, the generated command line may exceed 1,020 bytes.

If multiple job steps are assigned to a single job, define them in separate jobs and specify the execution order for these jobs, for example.

(b) Defining a custom job (UNIX job)

  1. Use the Jobnet Editor window of JP1/AJS to display the jobnet definition area.

  2. Select the Custom Jobs tab, and then drag the registered custom job to be used with the R/3 system and drop it onto the jobnet definition area.

    The registered custom job is added to the jobnet definition area and the Define Details - [Custom Job] dialog box is displayed.

    [Figure]

  3. Define Command statement.

    Specify command line parameters for the jr3bjcpy command.

  4. Specify the end judgment.

    • If you want JP1/AJS to handle an abnormal job end (the return value of the jr3bjcpy command is 1) and other errors (the return value of the jr3bjcpy 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 job end (the return value of the jr3bjcpy command is 1) and handle other errors (the return value of the jr3bjcpy command is 2 or greater) as abnormal conditions:

      Rule

      Select Judgment by threshold.

      Warning

      Specify 0.

      Abnormal

      Specify 1.

    • If you want JP1/AJS to handle an abnormal job end (the return value of the jr3bjcpy command is 1, or 5 or greater) as abnormal conditions and handle other errors (the return value of the jr3bjcpy command is between 2 and 4) as warnings:

      Rule

      Select Judgment by threshold.

      Warning

      Specify no value.

      Abnormal

      Specify 4 (the upper limit for the return value handled as a warning).

    The subsequent judgment job determines if the return value is a value from 1 to 4. For details about the setup method, see the chapter that contains definition examples of jobnets with judgment jobs in the manual JP1/Automatic Job Management System 3 System Design (Work Tasks) Guide.

  5. Choose the OK button.

For more details on how to define custom jobs, see the manual JP1/Automatic Job Management System 3 Operator's Guide.

(c) Specifying the method for connecting to the R/3 system

To specify the method for connecting to the R/3 system where the R/3 job will be created, use the R/3 System page of the R/3 Job Definition dialog box.

The following figure shows the R/3 System page.

Figure 3‒11: R/3 System page - R/3 Job Copying Definition dialog box

[Figure]

The items to be defined in the R/3 System page are explained below.

Definition items

Destination

Specify the method for connecting to the application server to which the job will be copied. 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 be connected to.

Host name

Specify the host name of the application server (or SAP router) to be connected to. A character string of 1 to 100 bytes can be entered for the host name.

You can use host names in the following formats:

  • Host name defined in the hosts file (for example, host1)

  • IP address (for example, 123.123.123.123)

  • SAP router address (for example, /H/hostname/S/port/H/host/S/port/...)

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 jr3bjcpy command.

System number

Specify the system number that identifies the target application server. A character string of 1 or 2 bytes can be entered for the system number. Only numerals can be used. Normally enter 00.

This item corresponds to the -s option of the jr3bjcpy command.

Connect by sapnwrfc.ini file

Select this option when you set the parameter that identifies the application server to be connected to from the external file. You need to select this option when you try to connect to the application server by balancing the workload.

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

Enter the value of the DEST key identifying the connection entry in the sapnwrfc.ini file. A character string of 1 to 32 bytes can be entered for the destination.

This item corresponds to the -d option of the jr3bjcpy command.

Logon

Specify the user information used for the connection destination R/3 system. JP1/AJS3 for EAP uses this information to log on to the R/3 system and execute jobs. Specify the user to log on by either of the following methods:

  • Use the user specified in sapnwrfc.ini

  • Use a specific user (client, user name, password, and language)

Log on by using the sapnwrfc.ini file

To log on by using the definitions specified in the external file (sapnwrfc.ini) and for Destination, select Log on by using the sapnwrfc.ini file.

This item corresponds to the -dl option of the jr3bjcpy command.

Client

Specify the number of the client assigned to the R/3 user who executes jobs. The lengths of character strings you can specify are from 1 to 3 bytes. You can only include digits in the character string. When an R/3 client number of 1 or 2 bytes is to be sent to the R/3 system, it is converted to 3 bytes.

For example, if the client number is 001, you can specify 1, 01, or 001. When this client number is sent to the R/3 system, it is sent as 001.

This item corresponds to the -c option of the jr3bjcpy command.

SAP user name

Specify the name of the R/3 user who executes jobs.

For details about the users who can be specified, see 2.2.9 Providing a SAP user for job control.

When you do not explicitly specify the authorized user to define the job step, the system executes the job step by using the permission specified in this option.

The lengths of character strings you can specify are from 1 to 12 bytes. You cannot include single-byte lower-case alphabetic characters in the user name.

This item corresponds to the -u option of the jr3bjcpy command.

Password

For the R/3 user who executes jobs, enter the password or extended password specified for the user name. To use an extended password, select Use an extended password.

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 jr3bjcpy command if you use the password, and the -p2 option of the jr3bjcpy 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

Specify the language environment for executing jobs. You can use either Japanese or English. Specify the following language supported by the R/3 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 R/3 system is used:

  • Language type specification is omitted.

  • A language type not defined by the destination R/3 system is specified.

The language type specified for this item affects the language for the R/3 job log. It also 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 jr3bjcpy command.

(d) Defining an R/3 job

To create an R/3 job definition, use the R/3 Job Copying Definition page of the R/3 Job Copying Definition dialog box.

The following figure shows the R/3 Job Copying Definition page.

Figure 3‒12: Job Definition page - R/3 Job Copying Definition dialog box

[Figure]

The items to be defined in the Job Copying Definition page are explained below.

Definition items

Copy job

Specify the items required to copy a job (such as the name of the source job and the job step information of the source job).

Name of the source job

Specify the job name of the source R/3 job.

The lengths of character strings you can specify are from 1 to 32 bytes. You cannot include single-byte lower-case alphabetic characters in the name of the source job.

This item corresponds to the -jn option of the jr3bjcpy command.

Number of the first step to start copying job

Specify the job count of the source R/3 job.

The lengths of character strings you can specify are from 1 to 8 bytes. Note that only numerals can be used. The default is 0.

This item corresponds to the -jc option of the jr3bjcpy command.

New name of the copied job

Specify the job name of the copied R/3 job.

The lengths of character strings you can specify are from 1 to 32 bytes. You cannot specify a lowercase single-byte character for the new name of the copied job. If you omit this option, the job is copied with the same name as the name of the source job.

This item corresponds to the -djn option of the jr3bjcpy command.

Define target host system

When you want to define the host of the application server that executes jobs, select this check box, and then enter the host name.

If you do not select this check box, the R/3 system will distribute the execution load of R/3 jobs among the application servers.

When you select this check box, the Define target application server check box is cleared.

Define target host system is a job definition compatible parameter created for Release 4.0 and earlier R/3 systems. To define jobs for Release 4.5 or later R/3 systems, use Define target application server.

Note

If one of the following conditions is satisfied, and if you select the Define target host system check box, the specification in the Host name field becomes ineffective:

  • Neither Release job as soon as possible nor Release job immediately is selected as the release method in the Monitor dialog box.

  • You have registered the job normally, but have failed to release the job.

In this case, no target host is assigned to the job registered on the R/3 system.

To execute the job on the target system, release the job by specifying the target system using the -tgh or -tgs option in the jr3bjrel command. If you release the job without specifying a target system using the jr3bjrel command, the R/3 system will dynamically select the target system on which the job will be executed.

Host name

Specify the host name of the application server that executes jobs.

From the list of host names displayed by the transaction SM51, select the host name assigned to the application server that offers a background processing service. Select one of the application servers that are running on the specified host and designate it as the target system on which the job will be executed.

This item corresponds to the -tgh option of the jr3bjcpy command.

Define target application server

To specify an application server or a job server group that executes the created R/3 jobs, select the Define target application server check box. If you do not specify an application server or a job server group in the text box, the created R/3 jobs are distributed among the application servers for execution.

When you select this check box, the Define target host system check box is cleared.

Note

If either of the following conditions is satisfied, the server specified in the Server name text box under the selected Define target application server check box is invalid:

  • If Release job as soon as possible or Release job immediately is not selected as the release method in the Monitor dialog box

  • If the job was successfully created but failed to be released

If either of these conditions applies, no execution destination server is set for the jobs created on R/3.

To execute these jobs on a specific execution destination, use the -tgh option or the -tgs option of the jr3bjrel command to specify the execution destination and then release the jobs. If you release the jobs without specifying an execution destination using the jr3bjrel command, the execution destination for the jobs is dynamically selected by the R/3 system.

Server name

Specify the name of the application server or the job server group that executes jobs. You can specify a character string of 1 to 20 bytes.

When you use an application server, you can specify one of the names (upper-case and lower-case characters are differentiated) that are assigned to the application servers for providing background processing services. These application server names are listed by transaction SM51. When you use a job server group, you can specify one of the names (upper-case and lower-case characters are differentiated) of job server groups containing the application servers that provide background processing services. These job server group names are listed by transaction SM61.

This item corresponds to the -tgs option of the jr3bjcpy command.

Monitor job release and completion

Specify whether or not to release the job after you register the job, or whether or not to monitor the completion of the released job.

  • Set button

    Use this button to browse or modify the existing settings in the Monitor dialog box that prompts you to specify whether or not to release the job after you register the job, or whether or not to monitor the completion of the released job.

Output results

Specify the message that JP1/AJS3 for EAP (program for executing custom jobs) outputs, or specify the method for obtaining logs of R/3 jobs whose termination is monitored.

To browse or modify the existing settings, click the Set button on the right.

  • Set button

    Use this button to browse or modify the existing settings in the Output Results dialog box that prompts you specify the method for obtaining messages JP1/AJS3 for EAP outputs or log where the completion of the R/3 job is monitored.

(e) Specifying the job release/completion monitoring method

To specify the job release/completion monitoring method, use the Monitor dialog box.

The Monitor dialog box opens when you click the Set button (for job release/completion monitoring) in the R/3 Job Definition dialog box.

The following figure shows the Monitor dialog box (for job release/completion monitoring).

Figure 3‒13: Monitor dialog box

[Figure]

The items to be defined in the Monitor dialog box are explained below.

Definition items

Monitor job release and completion

Specify whether to release a job after you copy the job, and whether to monitor the completion of the released job.

Do not release job

Select this option when you only want to copy the job without releasing the job. Next time you release this job, be sure to release the job on the R/3 system.

Release job as soon as possible

Starts the job as soon as possible after you copy the job. The system immediately sets the start conditions, and the R/3 system starts the job if a background process is available.

This item corresponds to the -rs option of the jr3bjcpy command.

Release job immediately

Immediately starts the copied job. If the system resource for executing the job is not allocated on the system, release of the job fails and the job is left registered.

This item corresponds to the -ri option of the jr3bjcpy command.

Monitoring completion of released job

Select this check box to monitor the completion of a released job.

This item corresponds to the -wait option of the jr3bjcpy command.

Include child jobs

Select Include child jobs to monitor the completion of all jobs, which includes the child jobs that are generated during the execution of the target job (completion monitoring of parent and child jobs).

This item corresponds to the -with_child option of the jr3bjcpy command.

Note

To select Include child jobs, JP1/AJS2 for EAP 07-50 or later must be installed on the execution destination host, and the XBP 2.0 interface and the parent and child function must be enabled in the connection destination R/3 system.

Set the query interval about job status

Select this check box to change the interval at which the R/3 system will be inquired about the job status.

Monitor every [ ] seconds

Specify the interval at which the R/3 system will be queried about the job status. You can specify 1 to 65,535 seconds.

The default query interval is the value specified in the environment settings file. (If a value is not specified in the environment settings file or that file was not created, the default value is 5 seconds.)

This item corresponds to the -ival option of the jr3bjcpy command.

Set monitoring time limit

Select this check box to enter the monitoring time. If the R/3 job does not stop within the specified monitoring time, execution of the custom job fails.

Monitor [ ] minutes

Specify the time for monitoring the job termination. You can specify 1 to 65,535 seconds. If no job termination monitoring time was specified, monitoring continues indefinitely.

This item corresponds to the -time option of the jr3bjcpy command.

Cancel R/3 job if timeout occurs during execution

Use this check box to cancel the executing R/3 job if the job does not terminate in the specified monitoring time.

You cannot cancel an inactive job such as a released or ready job. Alternatively, you cannot cancel a job that is executing an external program.

This item corresponds to the -cancel option of the jr3bjcpy command.

(f) Specifying the execution result output destination

To specify the execution result output destination, use the Output Results dialog box.

The Output Results dialog box opens when you click the Set button (for execution result output destination) in the R/3 Job Copy Definition dialog box.

The following figure shows the Output Results dialog box (for execution result output destination).

Figure 3‒14: Output Results dialog box

[Figure]

The items to be defined in the Output Results dialog box are explained below.

Definition items

Output results

Specify the method for obtaining the log of the messages JP1/AJS3 for EAP outputs and the log of R/3 jobs whose termination are monitored.

Output standard messages to specified file

Click this check box when you want to save the standard output messages of JP1/AJS3 for EAP to a specified file, and then enter the name of the destination file. Messages with the information level indicating the execution status of the program are output to the standard output. If the specified file does not exit, it is newly created and messages are always added in the file.

For details about the work directory of the program for executing the custom job, see the manual JP1/Automatic Job Management System 3 Administration Guide.

File (for standard output messages)

Use the full path to specify the name of the output destination file for storing the standard output messages of JP1/AJS3 for EAP. You can enter a character string of 1 to 259 bytes. You can include blank characters in the path.

If you do not specify the full path name for the destination file, the file is created in the JP1/AJS3 for EAP work directory that is specified in the environment setup file for job control. (If the JP1/AJS3 for EAP work directory is not specified in the environment setup file, the file is created in the work directory that is used when a JP1/AJS job is executed.)

For the file name, do not specify a device file, such as /dev/null. If a file for standard output messages is not needed, delete the file that is created.

You can also write standard output messages to this file.

This item corresponds to the -so option of the jr3bjcpy command.

Output standard error messages to specified file

Select this check box when you want to save the standard error output messages of JP1/AJS3 for EAP to a specified file, and then enter the name of the destination file. Messages with the caution and error level are output to the standard error output. If the specified file does not exit, it is newly created and messages are always added in the file.

For details about the work directory of the program for executing the custom job, see the manual JP1/Automatic Job Management System 3 Administration Guide.

File (for standard error output messages)

Use the full path to specify the name of the output destination file for storing the standard error output messages of JP1/AJS3 for EAP. You can enter a character string of 1 to 259 bytes. You can include blank characters in the path.

If you do not specify the full path name for the destination file, the file is created in the JP1/AJS3 for EAP work directory that is specified in the environment setup file for job control. (If the JP1/AJS3 for EAP work directory is not specified in the environment setup file, the file is created in the work directory that is used when a JP1/AJS job is executed.)

For the file name, do not specify a device file, such as /dev/null. If a file for standard error output messages is not needed, delete the file that is created.

You can also write standard output messages to this file.

This item corresponds to the -se option of the jr3bjcpy command.

Output the R/3 job log to specified file

Select this check box when you want to obtain the log of an R/3 job which ceased to be monitored, and then enter the name of the destination file. If the specified file does not exit, it is newly created and messages are always added in the file.

For details about the work directory of the program for executing the custom job, see the manual JP1/Automatic Job Management System 3 Administration Guide.

File (for R/3 job log)

Use the full path to specify the name of the output destination file for the R/3 job log. You can specify a character string of 1 to 259 bytes. You can include blank characters in the path.

If you do not specify the full path name for the destination file, the file is created in the JP1/AJS3 for EAP work directory that is specified in the environment setup file for job control. (If the JP1/AJS3 for EAP work directory is not specified in the environment setup file, the destination file is created in the work directory that is used when a JP1/AJS job is executed.)

For the R/3 job log file name, do not specify a device file, such as /dev/null. If the R/3 job log file is not needed, delete the file that is created.

You can also write the R/3 job log to this file.

If you specify YES for the JoblogAddToStderr key of the Command section of the environment settings file, you can output the R/3 job log to the specified file and to the standard error output at the same time. Therefore, if the Output standard error messages to specified file check box is not selected, you can use JP1/AJS - View to view the contents of the R/3 job log as follows:

  • When you specify an output destination file for standard error output messages

    You can output the R/3 job log to the specified output destination file for standard error output messages.

  • When you do not specify an output destination file for standard error output messages, but specify a standard error output file name in the Define Details - [Custom Job] dialog box of JP1/AJS - View

    You can view the content of the R/3 job log in the Execution Result Details dialog box in the Jobnet Monitor window of JP1/AJS - View.

This item corresponds to the -jo option of the jr3bjcpy command.

  • Get message type in R/3 job log#

    When you collect R/3 job logs, select the Get message type in R/3 job log check box if you also want to collect message types. The message type can be collected only if R/3 job logs are collected.

    This item corresponds to the -mt option of the jr3bjcpy command.

  • Search message type#

    Select this check box if you want to terminate a custom job command abnormally with the return value 4 when the specified character is contained in the message types of the collected R/3 job logs.

    This item corresponds to the -mts option of the jr3bjcpy command.

  • Search Target letters#

    Specify the search target character in the message types of the collected R/3 job logs as a character output to the message type.

    If you specify more than one character, the search means that any of the specified characters are contained. A character string of 1 to 8 bytes can be entered. You must specify it if you search the message types.

    This item corresponds to the message-type-character-string option specified in the -mts option of the jr3bjcpy command.

#: If JP1/AJS is configured not to monitor the completion of R/3 jobs in the Monitor job release and completion dialog box, or if R/3 job logs are not stored in a file, this item is inactive.

For details about the work directory that is used when JP1/AJS jobs are executed, see the manual JP1/Automatic Job Management System 3 System Design (Configuration) Guide.

(g) Defining environment variables

To add, edit, or delete environment variables, use the Environment Variable dialog box (for job control functionality).

To open the Environment Variable dialog box (for job control functionality) from the Environment Variables page, click the Add button. To open the Environment Variables page, click the Environment Variables tab.

The following figure shows the Environment Variables page.

Figure 3‒15: Environment Variables page - R/3 Job Copying Definition dialog box

[Figure]

The items to be defined in the Environment Variables page are explained below.

  • Definition items

Environment variables

An area used to specify environment variables for JP1/AJS3 for EAP.

Defined environment variables

A list control used to add, edit, and delete environment variable definitions for JP1/AJS3 for EAP. The names and values of the defined environment variables are displayed in the order of definitions.

You can define up to 10 environment variables whose total size is no more than 20,479 bytes.

Add

Opens an empty Environment Variable dialog box (for job control functionality).

A newly defined environment variable will be added before the environment variable selected when the Add button is clicked. (If nothing is selected, the variable will be added to the top.)

Edit

Applies the environment variable selected in the list control, and opens the Environment Variable dialog box (for job control functionality). (Double-clicking the environment variable selected in the list control also executes the same operation.)

If no environment variable is selected in the list control, this button is inactive.

Delete

Deletes the environment variable definition selected in the list control. (Pressing the Delete key also executes the same operation.)

If no environment variable is selected in the list control, this button is inactive.

The items to be defined in the Environment Variable dialog box (for job control functionality) are explained below.

  • Definition items

Environment variable

An area used to specify environment variables for JP1/AJS3 for EAP.

Variable name

Specify the name of an environment variable by using a character string of 1 to 259 bytes. Entering a value for this item is mandatory.

Variable value

Specify the value of an environment variable by using a character string of 1 to 2,047 bytes. Entering a value for this item is mandatory.

OK

Temporarily saves the specified items into the program, and then closes the dialog box. To save the settings into the definitions, in the main window, click the OK button to close the program. (If this button is highlighted, pressing the Enter key also executes the same operation.)

The specified environment variables are temporarily saved in the following format, which is the same as the storage format for job definitions:

environment-variable-name-1=value-1<linefeed>

environment-variable-name-2=value-2<linefeed>

If double quotation marks (") or hash marks (#) are contained in an environment variable, such symbols are escaped with a hash mark (#) as follows, and then the environment variable is temporary saved:

" -> #"

# -> ##

If the size of the defined environment variables exceeds 20,479 bytes, an error dialog box is displayed.

Cancel

Deletes the specified items, and then closes the dialog box. (Pressing the ESC key also executes the same operation.)