3.11.1 Creating a definition file

Create a definition file as shown below.

Organization of this subsection

(1) Creating a definition file
(2) Contents of the definition file
(3) Note

(1) Creating a definition file

Create a definition file with the following path name:

JP1/FTP-installation-directory\HOSTINFO.INI

To Page Top

(2) Contents of the definition file

Specify information in the format of a Windows initialization file (.ini), as shown below:

[Figure]

The following table lists and describes the sections, keys, and values that can be specified.

Table 3‒13: Contents of the definition file (HOSTINFO.INI)
Section	Key	Value	Description
`[CSHOST]`	`CSHost`	`YES\|NO` <<`NO`>>	At the FTP client, specifies whether the `ftstran` command's `/H` specification and the `fts_ftp_open_ex()` function's `hostname` specification are to be effective: `YES`: Set the FTP client's source address to the IP address of the host that is specified in `/H` in the `ftstran` command or in `hostname` in the `fts_ftp_open_ex()` function. If you specify `YES` but `/H` is omitted in the `ftstran` command, the physical host name is assumed. Also, if you specify `YES` but `NULL` is specified in `hostname` in the `fts_ftp_open_ex()` function, the physical host name is assumed. `NO`: Set the FTP client's source address to the value that is assigned automatically by the OS.
`[RSPMSG]`	`Reverse`	`YES\|NO\|`(omitted) <<omitted>>	Specifies the output format for the FTP server's host name in a response message that is sent from the FTP server: `YES`: Output the host name obtained by converting the connected IP address. `NO`: Output the connected IP address. Omitted: Output the physical host name.
`[JP1EVENT]`	`HostName`	`host-name\|IP-address` `\|` (omitted) <<omitted>>	Specifies the destination for output of JP1 events: `host-name\|IP-address`: Specifies the destination for JP1 events that report the start and stop of services (client, server, log, or agent). When you specify an IP address, you can specify an IPv4 or IPv6 address. The destination (logical or physical address) of a JP1 event that is generated during termination of a transmission is set to the host that executed the transmission. Omitted: Send all JP1 events to the physical host.
	`AgentIsSame`	`YES\|NO` <<`YES`>>	Specifies whether to set the destination of the JP1 events reporting the start and stop of the agent service to the host specified in `HostName`. `YES`: Set the destination of JP1 events to the host specified in `HostName`. `NO`: Set the destination of JP1 events to the physical host.
	`TransIsSame`	`YES\|NO` <<`NO`>>	Specifies whether to set the destination of the JP1 events reporting the end of transmission to the host specified in `HostName`. `YES`: Set the destination of JP1 events to the host specified in `HostName`. `NO`: Set the destination of JP1 events to the host that executed the transmission.

The following table shows the destination of the JP1 events reporting the end of transmission, as determined on the basis of the combination of defined specification values.

Table 3‒14: Destination of the JP1 events reporting the end of transmission, as determined on the basis of the combination of defined specification values
`HostName`	`TransIsSame`	Destination of the JP1 events reporting the end of transmission
Specified	`YES`	Host specified by `HostName`
Specified	`NO`	Host that executed the transmission
Not specified	`YES`	Physical host
Not specified	`NO`	Physical host

Example

This example enables the /H specification in the ftstran command and the hostname specification in fts_ftp_open_ex() function.
This example sets the host name obtained by converting the connected IP address as the FTP server's host name in the FTP server's response message.
This example sets the destination of JP1 events reporting the start and stop of services (client, server, log, or agent) or the end of transmission to Host1 (logical host name = Host1).

To Page Top

(3) Note

If there is no definition file, these functions are disabled (they operate on the basis of the default values).

To Page Top