3.1.1 Defining an environment for JP1/FTP
The default values are set during installation. We recommend that you change these values only if necessary.
This section describes how to use the Environment Definition dialog box and the ftsutil command to define an environment for JP1/FTP.
- Organization of this subsection
(1) Using the Environment Definition dialog box
To use the Environment Definition dialog box to define an environment for JP1/FTP:
-
Change settings as desired in the Environment Definition dialog box, and then click OK.
After you have changed the settings, restart the service as instructed in the displayed message.
The following table lists and describes each item in the Environment Definition dialog box.
Item |
Setting |
---|---|
No. of file transmissions to log ((0 to 1,000,000)) <<2,000>>) |
Specifies the number of log entries to retain. One file transmission is counted as one entry. When the number of files transmitted exceeds the number of entries being retained, the oldest information is overwritten. Because the size of one entry is 1,500 bytes, the required file size equals number of retained entries x 1,500 bytes. (In Linux (IPF version), the size of one entry is 1,536 bytes, so the required file size equals number of retained entries x 1,536 bytes.)
|
Size of protocol trace file ((4 to 10,000 KB)) <<50 KB>>) |
Specifies the size of the file to be used to collect FTP protocol trace information. The protocol trace file enables you to check command operation at the FTP level. When the amount of trace information exceeds the specified size, the oldest information is overwritten. The required disk capacity equals specified size x maximum number of concurrent transmissions x 2. For details about the maximum number of concurrent transmissions, see ftsutil - changes and displays environment information in 6. Commands. You can use a text editor to view the trace file. |
Size of module trace file ((4 to 10,000 KB)) <<50 KB>>) |
Specifies the size of the file to be used to collect module trace information. A module trace is collected as maintenance information. When the amount of trace information exceeds the specified size, the oldest information is overwritten. The required disk capacity equals specified size x maximum number of concurrent transmissions x 2 + specified size x 10. For details about the maximum number of concurrent transmissions, see ftsutil - changes and displays environment information in 6. Commands. The module trace file cannot be viewed. |
No. of retries (When connecting to a host) Retry interval (When connecting to a host) |
Specifies the number of and interval for retries when connection for file transmission cannot be established (for a reason such as busy status). Retries are attempted at a server whenever a connect system call results in an error, and at a client when a connect system call results in one of the following errors: ETIMEDOUT, ECONNREFUSED, ENETUNREACH, EADDRINUSE, EINPROGRESS, EALREADY, ENOBUFS, ENETDOWN
|
Time-limit waiting to send data ((1 to 3,600 seconds)) <<60 seconds>> |
Specifies the amount of time to wait for the sending buffer to become available after a package has been sent during data transmission. If the buffer is still not available when the specified amount of time elapses, the transmission terminates abnormally. |
Time-limit waiting to receive data ((1 to 3,600 seconds)) <<60 seconds>> |
Specifies the amount of time to wait for a packet to be received during data reception (a packet is transmitted by a remote target). If no data is received after the specified amount of time has elapsed, the transmission terminates abnormally. |
Server/Client |
|
Link with JP1/IM |
Specifies that JP1 events are to be issued. If you select this item, JP1 events will be issued when the service status changes and when transmission ends. During transmission as a superuser, events are issued with superuser permissions. During transmission as an ordinary user, events are issued as ordinary user permissions. If you link to JP1/IM, you can monitor the status on JP1/IM. For details about linkage with JP1/IM, see 5.2 Linking to JP1/IM. The default is that this item is not selected. |
Output transmission result to system log |
Specifies that the result of file transmission (normal, error, warning) is to be output to the system log. When this item is selected, messages with the following message IDs are output:
Messages with all other message IDs are always output to the system log, regardless of this setting. The default is that this item is not selected. |
Default |
Clicking this button resets all environment definition settings to their default values. |
- Note about the values for "No. of file transmissions to log", "Size of protocol trace file", and "Size of module trace file"
-
If you specify a value that is smaller than the current setting, the corresponding information files will be deleted when the service is restarted. This means that information in these files before the restart will be deleted. The log information file is backed up to the following file:
-
/var/opt/jp1_fts/sys/history.old
-
(2) Using the ftsutil command
The following figure shows an example of a command for changing definitions:
This command changes the following information:
-
-EH: Changes the number of log entries to be retained to 10,000
-
-EL: Selects the Output transmission result to system log option
The new settings take effect when the JP1/FTP daemon is restarted.
For details about the ftsutil command, see ftsutil - changes and displays environment information in 6. Commands.