HULFT Transfer App

To use the transfer function of HULFT Transfer Application, you need to create a service in HULFT Transfer App.

The transfer function of HULFT Transfer Application enables you to transfer files with more detailed settings than HULFT Transfer services. Use them according to your work.

You can configure the HULFT Transfer App service settings from > SERVICES > HULFT Transfer App in the navigation menu.

The key points about creating and setting HULFT Transfer App services are explained in this section.

Points for settings

Grant permissions to the group that needs to operate the services. Change the operating environment of HULFT Transfer App services to match that of your system environment.

Note

To configure the HULFT Transfer App settings, one of the following permissions is required:

AppTransferServiceFullAccess
AppTransferServiceAdminAccess

This section explains the screen transitions from the HULFT Transfer App page and the functions such as creating, restarting, and deleting HULFT Transfer App services.

= Remarks =

For the names and functions of the basic UI elements and other items of HULFT Square, refer to the following topic:

Screen elements

HULFT Transfer App

To open this page, select > SERVICES > HULFT Transfer App in the navigation menu.

(1) Add

Select this icon to create and set up a new HULFT Transfer App service.

For the settings of HULFT Transfer App services, refer to HULFT Transfer App > Add New.

(2) List of settings

The information for HULFT Transfer App services that are already created is displayed in tabular form.

	This icon indicates that the service is started.
	This icon indicates that the service is stopped.
	This icon indicates that the service is starting.
	This icon indicates that the service is loading.

(3) Action menu

Select these icons to perform operations for HULFT Transfer App services that have been created.

Selecting shows the menu of operations below.

Information

Displays detailed information about the selected service. You can edit, restart, or delete the HULFT Transfer App service that is displayed.

When you select this menu item, HULFT Transfer App > HULFT Transfer App service name is opened.

Restart

Restarts the selected service.

Delete

Deletes the selected service.

Note

Before deleting HULFT Transfer Application, delete all HULFT Transfer App services.

HULFT Transfer App > Add New

On the HULFT Transfer App page, select Add to open this page.

To create a new HULFT Transfer App service, set information for the HULFT Transfer App service by following the wizard-style pages step by step.

General

Name

Specify the name of the HULFT Transfer App service.

Description

Specify comments to explain the HULFT Transfer App service that you set.

CPU

Select the allocation of CPU resources for the HULFT Transfer App service from the dropdown list.

Memory

Select the memory size to use for the HULFT Transfer App service from the dropdown list.

The options in the dropdown list change depending on the setting for CPU.

Scalability

Displays the scalability (the number of Pods) for the HULFT Transfer App service.

The scalability for any HULFT Transfer App service is "1". It can't be changed.

Assigned group

Specify the group to which to grant permissions to operate the service.

Next

Displays the next page.

Field list

Table 2.1 List of system environment settings
Field value <Field value in HULFT>			Tag name	Default value	Setting value	Remarks
Network
	Receive Port No.		rcvport	30000	1–65535
	Observe daemon port No. <Observe Port No.>		obsport	31000	1–65535
	Inbound
		Secure connection type		VPN	VPN, PrivateLink
		Secure connection			The value set in the VPN service or PrivateLink
	Outbound
		Secure connection type		VPN	VPN, PrivateLink
		Secure connection			The value set in the VPN service or PrivateLink
Transfer general
	MUX <Send Process Multiplex Level>		sndpsnum	10	1–9999
	DEMUX <Receive Process Multiplex Level>		rcvpsnum	0	0–9999	0: unlimited
Code Conversion
	Code encoding <Code Set for Transfer>		cs4trnsfr	The value set during the installation	EUC-JP SHIFT-JIS UTF-8 GB18030
	Japanese character set <Standard for Japanese>		jistype	83JIS	78JIS 83JIS
	Key mapping for Tab <Tab Code Mode>		tabchange	Space	Space Tab
	Key mapping to KEIS Em-size space <KEIS Em-size Space Mode>		keisspmode	0x4040	0x4040 0xA1A1
File Transfer
	Multi receiving threads for a file <Receive Open Mode>		rcvfilewait	Wait	Treat as error Wait
	Verify Host group Info <Transfer Group Check>		tgrpchk	Don't verify any	Don't verify any Don't verify existing host group info set in receive configs Verify existing host group info set in receive configs
	Retry when the other peer exceeds DEMUX limit <Receive Multiplex Level Over Retry>		rcvover_rty	Off	Off On
	Policy in failing to clear/delete sending file <Send Transfer Error Recovery>		enderrmode	Treated as failure in sending	Treated as failure in sending Treated as success
	Dequeuing policy in resending queue <Criteria to Delete Resend Queue>		resenddel	Dequeue in case the record has the same transfer name and host info	Dequeue in case the record has the same transfer name and host info Dequeue in case the record has the same transfer name, host info, and file name
	Maximum file size in receiving <Criteria to Delete Resend Queue>		rcvmaxfilesize	0	0–(*1)	0: unlimited
	Hostname alias <Local Host Name>		myhostname	Specify a host name that uniquely distinguishes this service. Register this host name in the Host configuration (Host Information) in HULFT on the communication destination.		(*2)
Connection layer
	Retry count for establishing connection <Connect Retry Count>		retrycnt	5	0–9999
	Retry Interval <Connect Retry Interval>		retrytime	20	0–9999
	Retry count for auto resending <Auto Resend Retry Count>		sockerr_autoretry	0	0–9
	Socket timeout for sending/receiving <Socket Timeout>		socktime	3600	10–259200	999999: unlimited
	Socket buffer size for sending <Socket Buffer Size for Data Sending>		sndsocksize	0	0,4096–2147483647
	Socket buffer size for receiving<Socket Buffer Size for Data Receiving>		rcvsocksize	0	0,4096–2147483647
	Socket timeout for observe daemon <Observe Timeout>		obssocktime	86400	10–259200	999999: unlimited
	Transferring strategy <Framed Message Transfer Type>		proctranstype	Send/Receive: Speed	Send/Receive: Error detection Send: Speed / Receive: Error detection Send: Error detection / Receive: Speed Send/Receive: Speed
Security
	Mandate longer encryption key length <Forced Strong Key mode>		strongkeymode	Off	Off, On	(Available beginning 2025/4/20)
Advanced
	Timeout on job execution <Job Timeout>		jobwtimeout	999999	10–259200	999999: unlimited
	Threshold of recording lines to delete logs <Log Rotation Record Count>		logdelcount	0	0–999999
Reporting
	Trace log format <Trace Output Version>		tlogver	ver. 8	(*3)
	Reduce log size <Log Size Reduction Mode>		logreduction	Off	Off On
	Trace log level <Output to Trace Logs>		tracelog	Info	(*3)
Service events
	Workspace to save
	Author
Fields that can't be set in HULFT Square
Startup
	Work File Generation Path		tmpdir
	Send Daemon Communication Method		sddrequestmethod
	Command Acknowledge Port No.		sddport
	Pid File Generation Path		piddir
Code Conversion
	Use Custom Character Table		gaijifile
	Handling of Unregistered Custom Characters		gaijierr
	Code Conversion Mode		codechangemode
	Instant Transfer Code Converting Side		insttranscodcnv
Attribute Conversion
	Pack Zone Conversion		pschg
	Sign for ASCII		psascii
	Sign for EBCDIC		psebcdic
	X Type Conversion		xmode
Send and Receive
	Encryption Scheme		ciphertype
	Dynamic Parameter Specification		dynparam
	Message Dynamic Parameter Specification		msgdynparam
Communication
	IP Version		ipversion
Security
	Management Console Security		admcheck
	Password Check		passwdcheck
	Operation Log Output Option		oplselect
	Operation Log Rotate Size		oplchangesize
	Operation Log Generations		oplgenerationcount
	Allow Send/Resend Request from Unregistered Host		allowsndreq
	Allow Post-Receive Job Result Inquiry from Unregistered Host		allowpostrjobrslt
	Allow Job Result Notification Request from Unregistered Host		allowjobrsltntfy
	Allow Remote Job Execution Request from Unregistered Host		allowrmtjobexe
	Allow Instant Transfer from Unregistered Host		allowinsttrans
	Instant Transfer Receive Root Directory		insttransroot
Global Settings
	HULFT Operation Language		hullang
	Date Format		datefmt
Transfer Test
	Transfer Preference		ttmode
	Result Handling of Receiving		ttrcvomit
	Output Receive File		ttrcvfiloutput
	Execute Pre-send Job		ttpresndjob
	Execute Post-send Job		ttsndjob
	Execute Post-receive Job		ttrcvjob
	Output Results to Transfer Logs		ttsndrcvlog
Others
	Timeout on transmit request <Utility Timeout>		utlwait
	HULFT Script Port No.		hsport
	Status Display Selection		statusdisplay
	HULFT Identifier		hulcharacter
	Trace Output File Size		tlogsize
Logs
	Trace Output File Name		tlogfile
	Output to System Logs		syslog
Settings for HULFT Cross-Product Sharing
	Local File Lock Mode		localfile_lockmode
	Path to Location for Cross-Product Sharing		hulsharepath

*1	:	9,223,372,036,854,769,999
*2	:	There is no default value for HULFT for NSK.
*3	:	For details on the field, refer to Reporting.

Note

As a general rule, if the tag value is invalid or is omitted, the default value is used. However, the tags shown in Table 2.2 use the default values listed in the same table.

Table 2.2 List for the default values for system environment settings
Field name	Tag name	Default value
Receive Port No.	rcvport	None
Observe daemon port No.	obsport	None
Code encoding	cs4trnsfr	None
Hostname alias	myhostname	Local host
Trace log format	tlogver	ver. 8

Network

Receive Port No. (rcvport)

Specify the port number used by the Receive daemon when it waits and accepts the data sent from other hosts.

Make sure this port number doesn't overlap with the numbers reserved by your operating system or the numbers used by other daemons of HULFT.

Note

Don't specify a value in an ephemeral port range that is reserved by operating system.

Observe daemon port No. (obsport)

Specify the port number used for the Observe daemon to acknowledge requests from other hosts.

Make sure this port number doesn't overlap with the numbers reserved by your operating system or the numbers used by other daemons of HULFT.

Note

Don't specify a value in an ephemeral port range that is reserved by operating system.

Secure connection type (common to Inbound/Outbound)

Specify the type of the secure connection.

VPN
PrivateLink

Secure connection (common to Inbound/Outbound)

When you select VPN for Secure connection type, select a VPN service that has already been created.

When you select PrivateLink for Secure connection type, select a PrivateLink connection that has already been created.

Next

Displays the next page.

Transfer general

MUX (sndpsnum)

Specify the maximum number of the Send processes that the Send daemon can start at a time.

For send processing, the greater the number of simultaneous Send processes, the heavier the workload of the system and communication lines becomes.

Specify an appropriate value for this field in line with the state of the system in use.

DEMUX (rcvpsnum)

Specify the maximum number of the Receive processes that can be started at a time.

If the number of Receive processes exceeds the set value, the excess processes are not accepted.

Specifying 0 means there is no limit.

Specify an appropriate value for this field in line with the state of the system in use.

Next

Displays the next page.

Code Conversion

Code encoding (cs4trnsfr)

Specify the character code of the system in use.

EUC-JP
SHIFT-JIS
UTF-8
GB18030

Japanese character set (jistype)

Specify the Japanese standard for the character code of the system in use.

Table 2.3 Japanese character set
Standard for Japanese	Setting value
JIS78	78JIS
JIS83	83JIS

Key mapping for Tab (tabchange)

Specify how to handle a tab code, whether to treat the code as a space code (0x20) or a tab code (0x09), in text transfer to the Type MF-IBMi hosts.

Space
Tab

Note

The code after conversion complies with the conversion rules of EBCDIC set.

Key mapping to KEIS Em-size space (keisspmode)

Specify conversion rules for the em-size (double-byte) space code.

0x4040
0xA1A1

Next

Displays the next page.

File Transfer

Multi receiving threads for a file (rcvfilewait)

Specify the exclusive control processing of the receive file.

Treat as error
Wait

Verify Host group Info (tgrpchk)

Specify host group check processing when receiving.

The host name of the sending side is checked against the host name registered for the host group ID (Senders (GRPID)) in the Receive configurations. You can choose to have an error thrown if this field is not registered.

Don't verify any

A verification isn't performed.
Don't verify existing host group info set in receive configs

If the host group ID (Senders (GRPID)) is set in the Receive configurations, a verification is performed. If not set, a verification isn't performed.
Verify existing host group info set in receive configs

If the host group ID (Senders (GRPID)) is set in the Receive configurations, a verification is performed. If not set, it is considered an error.

Retry when the other peer exceeds DEMUX limit (rcvover_rty)

Specify whether or not to retry connection when an error occurs due to excess in the receive multiplicity in the socket connection from a local host to the Receive process of a remote host.

Regarding the retry count and retry interval for reconnections, the values set for Retry count for establishing connection (retrycnt) and Retry Interval (retrytime) are used.

Policy in failing to clear/delete sending file (enderrmode)

Specify how to treat the send result if clearing the send file or deleting the send file terminates unsuccessfully.

Treated as failure in sending
Treated as success

The setting of this field is applied in the following conditions:

When you specified Clear for Send File Mode (CLEAR) in the Send configurations, but clearing has terminated unsuccessfully
When you specified Delete for Send File Mode (CLEAR) in the Send configurations, but deletion has terminated unsuccessfully

Dequeuing policy in resending queue (resenddel)

Specify the conditions to delete the records from the resending queue when sending is requested for an existing transfer name in the resending queue and when a transfer terminates unsuccessfully.

Dequeue in case the record has the same transfer name and host info
Dequeue in case the record has the same transfer name, host info, and file name

Maximum file size in receiving (rcvmaxfilesize)

Specify the maximum file size that can be received in the receive processing.

Note

The setting of this field is disabled when the product version of the host on the sending side is lower than HULFT5 or when direct transfer from Mainframe is performed.
Due to code conversion, the size of the receive file may be larger than the size of the send file.

In this case, receiving may end successfully even if the size of the receive file exceeds the maximum receive file size that you specify here.

For details on the conditions that cause the receive file size to increase due to code conversion, refer to Code Conversion Manual.

Hostname alias (myhostname)

Specify the local host name when you intend to use a different name from the node name (hostname) of UNIX/Linux system, which is usually used as the local host name, due to an administrative reason on the remote host or the like.

There is no default value.

Next

Displays the next page.

Connection layer

Retry count for establishing connection (retrycnt)

Specify the retry count for reconnection when the socket connection has failed.

When "0" is set, reconnection isn't performed.

Retry Interval (retrytime)

Specify in seconds the retry interval for reconnection that is used when the socket connection has failed. In addition, specify the wait time before auto resending.

Retry count for auto resending (sockerr_autoretry)

Specify the number of attempts to execute auto resending when a communication error occurs during the send processing or the receive processing.

When "0" is set, auto resending isn't performed.

Socket timeout for sending/receiving (socktime)

Specify the time-out period in seconds when there's no response from a remote host during socket communication. If a time-out occurs, the state is regarded as a communication error, and communication is cut off. Because this field specifies the time range to detect network errors, specify a suitable value for the network in use.

Socket buffer size for sending (sndsocksize)

Specify the buffer size for data sending that is applied in socket communication.

When you specify "0", the value configured in the environment (operating system) is used.

Note

Send processing ends unsuccessfully when the upper limit of the maximum socket buffer size (OS) is changed to a smaller value than the one of Socket buffer size for sending (sndsocksize) after the Send daemon starts.

Socket buffer size for receiving (rcvsocksize)

Specify the buffer size for data receiving that is applied in socket communication.

When you specify "0", the value configured in the environment (operating system) is used.

Note

Send processing ends unsuccessfully when the upper limit of the maximum socket buffer size (OS) is changed to a smaller value than the one of Socket buffer size for receiving (rcvsocksize) after the Send daemon starts.

Socket timeout for observe daemon (obssocktime)

Specify the timeout for a response to a request in the Observe processing in seconds.

If the Observe processing times out, the state is regarded as no reply, and the processing terminates.

Transferring strategy (proctranstype)

Specify a data transfer method.

Send/Receive: Error detection

Data is transferred in error detection priority mode during sending and receiving both. The data transfer method, the timing for the error detection, and the timing of cancellation acknowledgment are the same as those of HULFT lower than Ver.7.
Send: Speed / Receive: Error detection

Data is transferred in the transfer speed priority mode for sending, and data is transferred in the error detection priority mode for receiving. With this option, utilization of resources during sending varies more widely than the conventional transfer method of HULFT lower than Ver.7, which may cause delays in the error detection timing and cancellation acknowledgment. When HULFT on the receiving side isn't in the transfer speed priority mode, data is transferred in the error detection priority mode.
Send: Error detection / Receive: Speed

Data is transferred in the transfer speed priority mode for receiving, and data is transferred in the error detection priority mode for sending. With this option, utilization of resources during receiving varies more widely than the conventional transfer method of HULFT lower than Ver.7, which may cause delays in the error detection timing and cancellation acknowledgment. When HULFT on the sending side isn't in the transfer speed priority mode, data is transferred in the error detection priority mode.
Send/Receive: Speed

Data is transferred in transfer speed priority mode during sending and receiving both. With this option, utilization of resources during sending and receiving varies more widely than the conventional transfer method of HULFT lower than Ver.7, which may cause delays in the error detection timing and cancellation acknowledgment. When the HULFT on the other side isn't in the transfer speed priority mode, data is transferred in the error detection priority mode.

Next

Displays the next page.

Security

Mandate longer encryption key length (strongkeymode)

Specify whether to forcibly use a longer encryption key length.

Off

Disables Mandate longer encryption key length.
On

Enables Mandate longer encryption key length.

Mandate longer encryption key length is a mode that forces the following two things:

Use of AES for encryption
Specification of a 64-digit hexadecimal number for the encryption key

Next

Displays the next page.

Advanced

Timeout on job execution (jobwtimeout)

Specify the timeout for job termination in seconds.

The setting is valid for pre-send jobs, successful jobs on the receiving side where Notification (JOBWAIT) is set to Successful Job Completion, remote jobs, and jobs started by the File Trigger function.

For other job execution, the system waits for job termination indefinitely.

Threshold of recording lines to delete logs (logdelcount)

Specify the deletion timing by the number of log records when the Send Log, the Receive Log, or the Observe Log is automatically deleted.

When the number of log records in a log file exceeds the specified value, the log file is switched over to a new file.

When 0 is specified, switchover of the log isn't performed.

Next

Displays the next page.

Reporting

Trace log format (tlogver)

Specify the version of the log that keeps the status of the send, the receive, and the observe operations.

ver. 8.4
ver. 8
ver. 7
ver. 6

For details about common header areas, refer to "3.2.1.1 Common header area" in HULFT8 UNIX/Linux Error Codes and Messages.

Reduce log size (logreduction)

Specify whether to output all the fields or only the fields in the common header area when messages are output to the trace log.

For details about common header areas, refer to "3.2.1.1 Common header area" in HULFT8 UNIX/Linux Error Codes and Messages.

Trace log level (tracelog)

Specify whether to output log (message) records to the trace log. Log (message) records that you specify are output.

Info
Info, Warning
Info, Warning, Error

For details on message types, refer to "3.2.1.1 Common header area" in HULFT8 UNIX/Linux Error Codes and Messages.

Next

Displays the next page.

Service events

Workspace to save: Select a workspace to store logs.

= Remarks =
Create a workspace in advance to output logs to, and specify it for Workspace to save to.
Author: From the registered users of the workspace specified for Workspace to save, select the user who will be the author of log files.
Next: Displays the next page.

HULFT Transfer App > HULFT Transfer App service name

On the HULFT Transfer App page, select Information from the action menu in the list of settings to open this page.

You can view detailed information about the selected HULFT Transfer App service.

(1) Service name

In Service name, the name of the HULFT Transfer App service is displayed.

(2) Settings menu

The settings configured when the HULFT Transfer App service is created are displayed.

Select a menu name to display the settings for each category.

(3) External HULFT transfer app user

The number of external users who can access the HULFT Transfer App server is displayed.

When you select the link, HULFT Transfer App > HULFT Transfer App service name > External Users is opened.

(4) Status

The CPU status information for the HULFT Transfer App service is displayed.

(5) Edit

You can reconfigure and update information for the displayed HULFT Transfer App service.

Note

If you change the HULFT Transfer App service settings, it may take some time to apply the settings to the service.

(6) Restart

Restarts the displayed HULFT Transfer App service.

(7) Delete

Deletes the displayed HULFT Transfer App service.