4.2.1 The procedure of definition of a DH Custom Job

The following procedure shows how to define a DH Custom Job.

Display the map area of the [Jobnet Editor] window of JP1/AJS3 - View.
Choose a tab of [Custom Job], and select [Exclusive edit] check box.

Drag a job icon [ [Figure] ] of JP1/DH - AJE and drop it in the map area.

Figure 4‒3: The [*Jobnet Editor*] window

When the Job execution program is for Linux, the indication of the icon of DH custom job is [ [Figure] ].

Note:

In the case of the system that both DH custom job for Windows and DH custom job for Linux are available, do not choose a wrong icon.

The Custom Job of JP1/DH - AJE is added in a map area of Jobnet, and the [Define Details - [Cstom Job]] dialog box is displayed.

Figure 4‒4: The [*Define Details - [Custom Job]*] dialog box

Define the definition items of the common items of the [Define Details - [Custom Job]] dialog box as follows.

Table 4‒1: The common items of [*Define Details - [Custom Job]*] dialog box
Item name	Definition method	Designation
[Unit name]	The unit name of custom job. Use a character string of up to 30 bytes.	mandatory
[Comment]	The comment of custom job. Specify a character string of up to 80 bytes.	optional
[Exec-agent]	Job Execution Agent Name that execute the Custom Job. Specify a character string of up to 255 bytes.	mandatory

Define the definition items of the Definition page of the [Define Details - [Custom Job] dialog box as follows.

Table 4‒2: The items of the Definition page of the [*Define Details - [Custom Job]*] dialog box
Item name		Definition method	Designation
[Priority]		Choose the priority of the custom job execution. You can set None, or 1 to 5.	optional
[Standard output]		Specify the name of the standard output file to be used for job execution. Use a character string of up to 511 bytes. Specify a full path file name.	optional
[Standard error]		Specify the name of the standard error output file to be used for job execution. Use a character string of up to 511 bytes. Specify a full path file name.	optional
[End judgment]	Rule	Choose conditions for end judgment.	optional
	Warning	When you choose [Judgment by threshold] in [End judgment], specify the warning threshold of a return code in the range of 0 to 2,147,483,647.	optional
	Abnormal	When you choose [Judgment by threshold] in [End judgment], specify the abnormal threshold of a return code in the range of 0 to 2,147,483,647.	optional
	File name	When you choose [Normal if specified file exists] or [Normal if file was updated] in [End judgment], specify the file name. You can use a character string of up to 511 bytes for the file name.	optional
[Retry on abnormal end]		Select whether to retry execution when the program ends in an error.	optional
[Return code]		If Yes is selected for Retry on abnormal end, specify the range of return codes for which to retry jobs. The value you can specify is in the range of 1 to 4,294,967,295.	optional
[Maximum retry times]		When Yes is selected for Retry on abnormal end, specify the maximum number of times a job can be retried. You can specify a value in the range from 1 to 12.	optional
[Retry interval]		When Yes is selected for Retry on abnormal end, specify how long the system waits between the error occurring and retrying the job. You can specify a value in the range from 1 to 10 (minutes).	optional
[User name]		Specify the name of OS user of host for job execution. Use a character string of up to 63 bytes.	optional
[Define detailed info]		When you click Details button, displays [DH Custom Job Definition] window.	mandatory

Define the definition items of the Attributes page of the [Define Details - [Custom Job] dialog box as follows.

Table 4‒3: The items of the attributes page of the [*Define Details - [Custom Job]*] dialog box
Item name	Definition method	Designation
[Hold]	Specify whether to place the unit in the hold status in advance.	optional
[Type]	Set the unit type to Normal or Recovery.	optional
[Set timeout period]	Select whether to set a time-out period for the Custom Job execution.	optional
[Timeout period]	When you choose [yes] in [Set timeout period], specify the timeout period in minutes. The value that you can specify is in the range of 1 to 1,440 minutes. Specify Timeout period carefully. If it isn't enough, processing of Custom job will be terminated in halfway.	optional
[Delayed end]	Specify whether to monitor delayed end of jobs based on time required for execution. Select the Time-required-for-execution check box to monitor delayed end of jobs. When you select the Time-required-for-execution check box, specify the time required for execution for a job in the range of 1 to 1,440 minutes.	optional
[Owner]	Specify the Unit owner. Use a character string of up to 31 bytes.	optional
[JP1 resource groups]	Specify The JP1 resource group name. Use a character string of up to 63 bytes.	optional
[Executed by]	Select the user who executes the job. You can select either of the following. [User who registered] The JP1 user who registered the custom job executes the custom job. [User who owns] The JP1 user who owns the custom job executes the job. The default value is [User who registered].	optional

After definition of each items of the [Define Details - [Custom Job]] window, click Details button of the Definition page on the [Define Details - [Custom Job]] window, then displays [DH Custom Job Definition] window.

Figure 4‒5: The [*DH Custom Job Definition*] window

For definition of a Send Custom Job or a Receive Custom Job by using the [DH Custom Job Definition] window, see the following table and define items of each window.

Table 4‒4: Items that is needed for definition of Send Custom Job or Receive Custom Job
Window name	Send Custom Job	Receive Custom Job
[Transmission Setting (Send)] window	Need to define	N/A
[Transmission Setting(Receive)] window	N/A	Need to define
[Base Setting] window	Need to define	Need to define

Note:

If the language that job definition program uses is English, don't use multi-byte characters for definition of DH custom job. If you do so, the data transfer command may be failed because the multi-byte characters will be change to the invalid characters. Do not specify surrogate pairs characters for definition of DH Custom Job. If you do so, might be changed to the invalid characters because the character is not recognized correctly. It is not checked whether it is the characters which it cannot use.
When the [DH Custom Job Definition] window doesn't be displayed by an error (e.g. The invalid config.xml is specified), OK button on the [Define Details - [Custom Job]] window will be enabled. In this case, click Cancel button and close the [DH Custom Job Definition] window. Then, define a custom job by using the [DH Custom Job Definition] window again. If you click OK button in the above case, invalid DH Custom Job will be registered and you can't edit it. If you made such Custom Job, delete it.

Click OK button on the [DH Custom Job Definition] window, and returns to the [Define Details - [Custom Job]] window. Check the specified contents, and click OK button on the [Define Details - [Custom Job]] window. The custom job for JP1/DH - AJE is defined on the [Jobnet Editor] window.

To Page Top