Transfer Test

The Transfer Test function checks the file transfer operation while suppressing functions that affect business operation, such as job execution or output of logs. The test does not affect business operation, so you can check the file transfer operation in the actual operating environment.

Use the Transfer Test function to check the following:

  • Whether a transfer can be performed or not

  • In the case of a transfer error, the cause of the error, determined from the Status Code (when the Send Log and the Receive Log are not suppressed)

  • Code Conversion result for the Receive file, and the data size (when creation of the Receive file is not suppressed)

  • Estimates of the time required for the transfer and the transfer rate (when the Send Log and the Receive Log are not suppressed)

  • Compression ratio (When the Send Log is not suppressed)

Note

You can use the Transfer Test function if HULFT8 or higher is installed. If checking the operation of file transfers using both the host on the sending side and the host on the receiving side, HULFT8 or higher must be installed on both sides.

An execution example of the Transfer Test function is shown below:

 

  • System Environment Settings on a sending host

    • Execute Post-send Job: No

    • Output Results to Transfer Logs: Yes

  • System Environment Settings on a receiving host

    • Output Receive File: No

    • Execute Post-receive Job: No

    • Output Results to Transfer Logs: Yes

Figure 2.51 Transfer Test function

Functions that can be suppressed during Transfer Test

The following functions can be suppressed using the Transfer Test function. Specify the functions you want to suppress in the System Environment Settings. For details, refer to System Environment Settings.

  • Execution of Pre-send Job

  • Execution of Post-send Job

  • Execution of Post-receive Job

  • Creation of Receive file

  • Output of Send Log and Receive Log

Note

  • If a sending host is in the Test-priority Mode, execution of file transfer during the test operation that works with a receiving host does not suppress the execution of the Pre-send Job, even if the relevant field of the System Environment Setting is configured otherwise.

  • If a sending host is in the Test-priority Mode, execution of file transfer during the test operation that works with a receiving host may not suppress the following operations, even if the relevant fields of the System Environment Setting is configured otherwise:

    • Execution of Post-send Job

    • Execution of Post-receive Job

    • Output of Send Log and Receive Log

  • If you configure the relevant field of the System Environment Settings so as to suppress the output of the Receive files, you cannot check the operations that assume the presence of the Receive files such as subsequent jobs. In such a case, transfer may fail in normal operation despite the successful result in test operation.

    Meanwhile, HULFT passes file names to subsequent jobs and logs in a similar manner to the case where it creates a Receive file. However, HULFT outputs a file name without generation file number, even if you enable the Generation File for a Receive file.

Operations in File Transfer

The file transfer in HULFT8 works in either of the following operations:

  • Normal operation

    This mode transfers file according to parameter definitions using functions such as jobs and log output, which affect business operation.

  • Test operation

    This mode transfers files while suppressing functions such as jobs and log output, which affect business operation. Specify the functions that you want to suppress in the System Environment Settings.

 

The Transfer Preference (TTMODE) of the System Environment Settings specifies whether the file transfer should work in normal operation or test operation.

You must specify either of the following options for the Transfer Preference (TTMODE).

  • Test-run Mode

    This mode lets file transfer work in test operation.

  • Test-priority Mode

    This mode lets file transfer work in test operation only when either a sending host or a receiving host is in Test-run Mode.

If you want to execute file transfer in normal operation, specify 'Test-priority Mode' on both a sending host and a receiving host.

 

The file transfer operation for the Transfer Test function may vary depending on the combination of the values of the Transfer Preference that are specified on a sending host and on a receiving host.

The following table shows the relation between the combination of the values for the Transfer Preference and operations of individual hosts:

Table 2.18 Behavior depending on Transfer Preference on the sides

 

Sending host

HULFT8

Lower than HULFT8

Use HULFT7 Comm. Mode
"No"

Use HULFT7 Comm. Mode
"Yes"

-

Test-Priority mode

Test-Run mode

Test-Priority mode

Test-Run mode

-

Receiving
host

HULFT8

Test-Priority mode

Sending host:
regular
Receiving host:
regular

Sending host: test
Receiving host:
test

Sending host:
regular
Receiving host:
regular

Sending host:
test
(*2)
Receiving host:
(*3)

Sending host:
regular
Receiving host:
regular

Test-Run mode

Sending host:
test
(*4)
Receiving host:
test

Sending host:
test
Receiving host:
test

Sending host:
regular
(with error)
(*4)
Receiving host:
(*1)

Sending host:
test
(*2)
Receiving host:
(*3)

Sending host:
regular
(with error)
Receiving host:
(*1)

Lower than
HULFT8

-

Sending host: regular
Receiving host:
regular

Sending host:
test
(*2)
Receiving host:
(*3)

Sending host:
regular
Receiving host:
regular

Sending host:
test
(*2)
Receiving host:
(*3)

Sending host:
regular
Receiving host:
regular

-

:

Function not available

*1

:

An error (Status Code=517) occurs on the host on the receiving side.

*2

:

Behavior on the sending side depends on Result Handling of Receiving (TTRCVOMIT) in the System Environment Settings

*3

:

HULFT does not transfer a file to the host on the receiving side.

*4

:

Cannot suppress execution of pre-send jobs. Pre-send jobs are started before the change to Test-Run mode when the receiving host is connected.
Note

  • If a transfer error occurred in test operation, information of the failed Send file is written in the Send Control file. In such a case, delete the unnecessary records from the Send Queue or the Resend Queue.

  • Note that it is not possible to distinguish error messages that are output in test operation from those that are output in normal operation.