3.1.1 Defining an environment for JP1/FTP

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.)

Increasing the number of log entries to be retained:

If you increase the number of log entries to be retained, it might take longer to display logs, depending on the CPU and hardware performance as well as on the amount of memory that is installed. If you want to retain log information over a long period of time, we recommend that you copy the following log information file and then store the copy.

Log information file:

• /var/opt/jp1_fts/sys/history

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

1. No. of retries (When connecting to a host) ((0 to 100,000)) <<5>>

   If you specify 0, no retries will be attempted.

2. Retry interval (When connecting to a host) ((0 to 86,400 seconds)) <<2 seconds>>

   If you specify 0, retries are attempted immediately (without any interval between retry attempts).

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

• Size of sending buffer/Size of receiving buffer ((512 to 262,144 bytes)) <<40,960 bytes>>

  Specifies the size of the buffer (memory) for file transmission (sending) at both the server and the client. You might want to change this value if the amount of memory is limited or when you want to improve transmission efficiency. Note that various factors affect transmission efficiency, such as the line speed, usage status, and CPU performance. Specify values as appropriate for the system being used.

  The maximum memory size that we recommend you allocate for the transmission buffer equals specified buffer size x maximum number of concurrent transmissions. Buffers for sending and receiving are not allocated at the same time. Allocation occurs only during transmission. If the allocation fails, the transmission terminates abnormally.

• Time-limit for idle connection ((30 to 7,200 seconds)) <<900 seconds>>

  If there is no request from the client for a specific period of time, the server releases the connection with the client. This item specifies the amount of time before the connection is to be released.

• File creation mask ((octal number from 000 to 777)) <<027>>

  Specifies the file mode creation mask for a receive file. This setting is used when a new file is created. If a file with the same name already exists, its file mode remains unchanged.

  Example:

  To create a file with user=rw, group=rw, and other=r: 113

  To create a file with user=r, group=r, and other=r: 333

  For details about the mode, see the documentation that explains the umask and chmod commands. Note that a file with execution permission (x) cannot be created.

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:

• KDJF2001-I

• KDJF2002-E

• KDJF2003-W

• KDJF3001-I

• KDJF3002-E

• KDJF3003-W

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.