4.2.3 The [Transmission Setting (Receive)] window

Transfer type

Select the type of custom job that you want to define. Select "Receive".

No

mandatory

Receive folder

Specify the receive folder name on the agent host carrying out DH custom job.

Specify an absolute path name for this item.

This item must be a string of from 1 to 255 characters.

Double quote are prohibited characters for this item.

Yes

mandatory

Behavior for receiving the same name file / folder

Select the behavior of the DH custom job when the DH custom job received the same file or folder that is included in the "Receive folder".

• When "Do not overwrite" is selected:

  The receiving of the file or the folder will be skipped when the same file or folder exists in the "Receive folder".

• When "Overwrite" is selected:

  The receiving of the file or the folder won't be skipped and overwrite the file or folder in the "Receive folder".

No

mandatory

Behavior in the state without a file / folder to receive

Select the behavior of the DH custom job when the DH custom job received nothing.

• When "Ended normally" is selected:

  When the DH custom job received nothing, the DH custom job returns normal end (Return code: 0).

• When "Ended with Warning" is selected:

  When the DH custom job received nothing, the DH custom job returns warning (Return code: 1).

No

mandatory

Behavior when other job is executing

Select the behavior of DH custom job from the following two types.

• [Ended Immediately]

  When a DH custom job runs during other DH custom job is running, the DH custom job ends immediately.

• [Wait for the end of other job]

  When a DH custom job runs during other DH custom job is running, the DH custom job waits for the end of previous DH custom job in seconds that you specified.

  If timeout occurred, the DH custom ends without anything.

If you select [Wait for the end of other job], specify seconds from 0 to 86,400.

Furthermore, the DH custom job will be ended with the return code 8 when the previous running DH custom job is a "Receive Custom Job" even though you selected "Ended Immediately" or "Wait for the end of other job".

No

mandatory

Supplementary note:

• AJS macro variable is a function of JP1/AJS3 for automating the task that includes tasks that changed values during executing jobs. See Job Management Partner 1/Automatic Job Management System 3 Overview.

Note:

• Specify the following folder as the "Receive folder".

  - A folder that already exists.

  - A folder that can read or write by OS user who runs the DH custom job.

  If you don't specify a folder like the above, the execution of the Receive Custom Job will fail.

• The DH custom job returns code 4 when the following conditions are satisfied.

  1. "Do not overwrite" is selected in "Behavior for receiving the same name file / folder".

  2. There is one or more same files in the "Receive folder" when the DH custom job

  For example, there is the file B in the "Receive folder".

  And then, you execute a Receive Custom Job that receives the file A, the file B, and the file C.

  In this case, the Receive Custom Job will receive the file A and the file C, but the Receive Custom Job will skip receiving of the file B.

  The Receive Custom Job will return code 4.

  If you don't want to recognize the above case as an error, modify the threshold value of End judgment of the [Define Details - [Custom Job]] dialog box.

• Do not specify, as the file name or the folder name, a path beginning with a network drive name. A network drive is reconnected after a user logs on to Windows. If the user does not log on to Windows, the system may not be able to recognize the path name of the execution file. Specify a path beginning with a computer name such as \\computer-name\shared-folder\folder-name. Do not use a path beginning with a network drive name.

• You can specify a string of from 1 to 255 as "Receive folder". But, when the DH custom job receives a file or a folder, the length of a file name will be:

  The length of "Receive folder name" + the length of "a file name that the DH custom job received"

  So, if the length of file name over the limit of OS, the execution of a DH custom job will be failed.

  Specify "Receive folder" with considering the length of received filename.

• When a folder is included in contents to receive, the length of the following folders name is necessary: the length of "<Installation folder of JP1/DH - AJE (Job Execution)>\bin\DWClient\work" which is specified as the [Transmission Setting (Receive)] window + the length of "a folder name that the DH custom job received". So, if the length of file name over the limit of OS, the execution of a DH custom job will be failed. When you do the transmission and reception that appointed a folder, specify folder name of the transmission and reception with considering the length of the folder name.

• By the reception for Linux, reception file / folder is made using umask level 000.