Instant transfer

(1) Instant transfer

Instant transfer is the function that allows you to send a file only by specifying the names of the target file and the receiving-side host without using pre-registered management information entries.

 

To perform an instant transfer, the following needs to be performed in advance on the receiving-side host:

• Specify whether to accept requests for instant transfer in the Host Information (if the sending-side host is registered), or in the System Environment Settings (if not registered)

• Specify the root directory in or under which instant transfer is accepted in the System Environment Settings.

For details, refer to the description in the following sections.

(2) Available functions

Instant transfer is a simple transfer method that does not require management information. However, some functions cannot be used with instant transfer.

The following table provides important information about the availability of functions.

Table 2.4 Available functions for instant transfer

Function	Availability with instant transfer
Resending
Auto Resend	✓
Synchronous Transfer and Asynchronous Transfer	✓
Multicasting
Compressed Transfer	✓ (*1)
Generational Management
Code Conversion	✓ (*2)
Message Transmission
Job Start-up
Data Verification function	✓ (*3)
Transfer Group Check
Operation Log Output	✓
Encryption	✓ (*4)

✓	:	Available
Blank	:	Not available

*1	:	HULFT compresses files in the same way as the way it compresses files when you specify DEFLATE compression.
*2	:	For details, refer to (8) Code conversion.
*3	:	HULFT always verifies data for instant transfer.
*4	:	In instant transfer, the cipher key is generated automatically.

(3) Executing instant transfer

To execute instant transfer, run the Instant Transfer Send File Issuance command on the sending-side host.

(4) Behavior of operations in sending-side transferring

For sending-side transferring of instant transfer, HULFT always uses the same settings without referring to the management information.

HULFT behaves in the same way as the way it behaves when the following values are set in the Send Management Information and the Host Information. Note that for some fields, HULFT uses the settings that you specify in the parameters when you issue a Send File request for instant transfer.

Table 2.5 Send Management Information

Field Name	Setting Value
File ID	_INSTANT_TRANSFER_
Send File Name	Specified in a parameter
Transfer Type	Specified in a parameter (*1)
Format/Multi Format ID	(Omitted)
Compression Preference	DEFLATE
DEFLATE Level	Default
Code Conversion	(*2)
EBCDIC Set	(*2)
Send File Mode	Keep
Transfer Group ID	(Omitted)
Pre-send Job ID	(Omitted)
Successful Job ID	(Omitted)
Unsuccessful Job ID	(Omitted)
Interface DBID	(Omitted)
Transfer Interval	0
Transfer Priority	Specified in a parameter
Transfer Block Length	0
Transfer Block Count	0
Shiftcode Mode	Add
Cipher Key	Generated automatically

*1	:	You can specify only text transfer or binary transfer.
*2	:	For details, refer to (8) Code conversion.

Table 2.6 Host Information

Field Name	Setting Value
Host Type	Host type of the receiving-side host
Code Set for Transfer	(*1)
Standard for Japanese	83JIS
Receive Port No.	Specified in a parameter
Observe Port No.	(*2)
Connection Type	LAN
Send Process Multiplex Level by Host	(Omitted)
Use HULFT7 Comm. Mode	No
Proxy Server Name	(Omitted)
Proxy Port No.	(Omitted)
Allow Send Request/Resend Request	(*2)
Allow to View Post-receive Job Result	(*2)
Allow to Notify Job Result	(*2)
Allow to Execute Remote Job	(*2)
Allow Instant Transfer	(*2)
Notify User Details	No

*1	:	For details, refer to (8) Code conversion.
*2	:	These fields are not related to sending-side transferring.

(5) Behavior of operations in receiving-side transferring

For receiving-side transferring of instant transfer, HULFT always uses the same settings without referring to the management information.

HULFT behaves in the same way as when the following values are set in the Receive Management Information and Host Information. Note that for some fields, HULFT uses the settings that you specify in the parameters of the Instant Transfer Send File Issuance command.

Table 2.7 Receive Management Information

Field Name	Setting Value
File ID	_INSTANT_TRANSFER_
File Name	(*1)
Owner Name	(Omitted) (*3)
Group Name	(Omitted) (*3)
Permission	(Omitted) (*3)
Registration Mode	Replace
Error Handling	Keep
Receive Mode	Single
Generational Management	No
No. of Generations	0
EBCDIC Set	(*2)
Successful Job ID	(Omitted)
Unsuccessful Job ID	(Omitted)
Receive Completion Notification	Receive Completion
Transfer Group ID	(Omitted)
Verify Data	Yes
Cipher Key	Generated automatically

*1	:	For details, refer to (6) Receive file.
*2	:	For details, refer to (8) Code conversion.
*3	:	For details on the behavior when these fields are omitted, refer to the explanation of the Receive Management Information in Operation Manual.

Table 2.8 Host Information

Field Name	Setting Value
Host Type	Host type of the sending-side host
Code Set for Transfer	(*1)
Standard for Japanese	83JIS
Receive Port No.	(*2)
Observe Port No.	(*2)
Connection Type	(*2)
Send Process Multiplex Level by Host	(*2)
Use HULFT7 Comm. Mode	(*2)
Proxy Server Name	(*2)
Proxy Port No.	(*2)
Allow Send Request/Resend Request	(*2)
Allow to View Post-receive Job Result	(*2)
Allow to Notify Job Result	(*2)
Allow to Execute Remote Job	(*2)
Allow Instant Transfer	(*3)
Notify User Details	(*2)

*1	:	For details, refer to (8) Code conversion.
*2	:	These fields are not related to receiving-side transferring.
*3	:	If the relevant host is registered in the Host Information, HULFT uses the setting value of this field. If the relevant host is not registered in the Host Information, HULFT uses the setting value of Allow Instant Transfer from Unregistered Host in the System Environment Settings.

(6) Receive file

In instant transfer, you can specify information about receive files in the System Environment Settings or as parameters specified when the Instant Transfer Send File request is issued.

For details on the parameters to be set when you issue a Send File request for instant transfer, refer to Operation Manual.

(7) Specifying the directory under which files can be received

In instant transfer, because both save destination and name of the receive file can be specified, the following possibilities exist:

• Important files might be overwritten on the receiving-side host.

• A specified save destination or name of the receive file might deviate from operational rules used in the business.

To avoid such a situation when you perform instant transfer, specify a directory under which files can be received on the receiving-side host in advance.

The request for receiving-side transferring is accepted only when the save destination for the receive file specified on the sending-side host is located in or under the specified root directory.

The root directory for instant transfer receive locations is specified as Instant Transfer Receive Root Directory (insttrnsroot) in the System Environment Settings.

 

If the save destination for the receive file is omitted on the sending-side host, the root directory specified as Instant Transfer Receive Root Directory is used as the default destination for the receive file.

If Instant Transfer Receive Root Directory is omitted, requests for instant transfer are always rejected.

 

For details on the System Environment Settings, refer to System Environment Settings.

(8) Code conversion

For instant transfer, specify the information on code conversion for the following fields in the System Environment Settings.

 

HULFT uses the code set information of the remote host that HULFT receives from the remote host during transfer.

Refer to Code Conversion Manual for details about the how code conversion works and other points to be noted.

(9) Observe setting functions for instant transfer

You can use instant transfer to send a file if you only know the host name and port number of the receiving-side host.

On the receiving-side host, you can refuse instant transfer from unintended sending-side hosts.

(10) Notes on instant transfer

The following are points to be noted on instant transfer.

• HULFT automatically assigns a file ID of "_INSTANT_TRANSFER_" to the transfer that you execute by issuing a Send File request for instant transfer.

  You cannot use this file ID to execute the following operations:

  • Issuance of a Send File request

  • Issuance of a Resend File request

  • Issuance of a Send Request request

  • Issuance of a Resend Request request

  • Registration of the Send Management Information

  • Registration of the Receive Management Information

  For records for transfer status and transfer logs with the file ID "_INSTANT_TRANSFER_", you can execute the following operations as in the case of the conventional file IDs:

  • Inquiry and deletion of Send Log records

  • Inquiry and deletion of Receive Log records

  • Cancelation of sending-side transferring

  • Cancelation of receiving-side transferring

  • Change of the Unsent Status Queue

• Even if you specify "0" (Disable Dynamic Specification) for Dynamic Parameter Specification (dynparam) in the System Environment Settings, you can specify the send file name and the name of the receiving-side host in the parameters of the Instant Transfer Send File Issuance command.

• For details on errors related to the Instant Transfer Send File Issuance command, and the status codes and detail codes that are output to records for the transfer status and transfer logs for instant transfer, refer to Error Codes and Messages.

• The level of security differs between a regular transfer based on management information and an instant transfer as follows.

  Table 2.10 Security on the sending-side host

  	Regular transfer based on management information	Instant transfer
  File ID	Sending-side transferring is performed only when the same ID is registered on the receiving-side host	Sending-side transferring is performed regardless of whether the ID is registered in the Send Management Information
  Host name	Sending-side transferring is performed only when the destination host is registered in the Host Information	Sending-side transferring is performed against any arbitrary destination host
  Multiplex level by host	The value set in the Host Information is applied and multiple sending-side transferring instances can run only up to the multiplicity of the value	No limit on multiplicity of transferring instances can be set
  Multiplex level of entire system	The value set in the System Environment Settings is applied and multiple sending-side transferring instances can run up to the multiplicity of the value	The value set in the System Environment Settings is applied and multiple sending-side transferring instances can run up to the multiplicity of the value

  Table 2.11 Security on the receiving-side host

  	Regular transfer based on management information	Instant transfer
  File ID	Receiving-side transferring is performed only when the same ID is registered on the sending-side host	Receiving-side transferring is performed regardless of whether the ID is registered in the Send Management Information
  Host name	Receiving-side transferring is performed only when the sending-side host is registered in the Host Information	Receiving-side transferring is performed only when the sending-side host is allowed to send files in the Host Information (or against any arbitrary unregistered host if set so) (*1)
  Save location for the receive file	Receive files can be stored only in file names specified in the Receive Management Information.	Receive files can be stored only to directories specified as Instant Transfer Receive Root Directory.
  Receive file name		Receiving-side transferring is performed in any arbitrary destination file name
  Multiplex level of entire system	The value set in the System Environment Settings is applied and multiple receiving-side transferring instances can run up to the multiplicity of the value	The value set in the System Environment Settings is applied and multiple receiving-side transferring instances can run up to the multiplicity of the value

  *1

  :

  By default, the option of allowing an arbitrary host to perform transferring is not selected.

When you use the instant transfer function, please take note of the above and specify appropriate settings in the Host Information and for the instant transfer receive root directory.