ftsutil - changes and displays environment information

Organization of this page

Format
Function
Arguments
Return values

Format

Changing environment information:

ftsutil -C environment-information-option transmission-option-parameter

Displaying environment information:

ftsutil -L

To Page Top

Function

The ftsutil command changes or displays environment information.

To Page Top

Arguments

`-C` `environment-information-option` `transmission-option-parameter`

Changes the environment information in accordance with the specified environment information options.

To change environment information, you need superuser permissions.

The new settings take effect when you restart the JP1/FTP daemon.

The table below lists and describes the environment information options. For details about the transmission option parameters, see 3.1.1 Defining an environment for JP1/FTP.

Table 6‒2: Environment information options
Option name	Transmission option parameter	Value
`-EH`	Number of log entries to retain	((0 to 100,000))
`-EP`	Size of the protocol trace file	((4 to 1,000))
`-EM`	Size of the module trace file	((4 to 1,000))
`-ER`	Number of retries when connecting to a host	((0 to 100,000))
`-EY`	Retry interval when connecting to a host	((0 to 86,400))
`-EO`	Time-limit for waiting to send data	((1 to 3,600))
`-EU`	Time-limit for waiting to receive data	((1 to 3,600))
`-ES`	Size of the send buffer at the server	((512 to 262,144))
`-EB`	Size of the receive buffer at the server	((512 to 262,144))
`-ET`	Time-limit for idle connection at the server	((30 to 7,200))
`-EV`	File creation mask at the server	Octal value ((000 to 777))
`-EF`	Size of the send buffer at the client	((512 to 262,144))
`-EE`	Size of the receive buffer at the client	((512 to 262,144))
`-EK`	File creation mask at the client	Octal value ((000 to 777))
`-EI`	Link to JP1/IM (`CHECK` or `UNCHECK`)	`CHECK\|UNCHECK`
`-EL`	Output transmission result to system log (`CHECK` or `UNCHECK`)	`CHECK\|UNCHECK`
`-EC`	Maximum number of concurrent transmissions^#1	64 to 128 <<64>>
`-EA`	File size for the access log^#2	((0 to 100))
`-EX`	FTP connection response message control (`CHECK` or `UNCHECK`)^#3	`CHECK\|UNCHECK`

#1

Specify the permitted maximum number of concurrent transmissions. This is the same as the permitted maximum number of concurrent FTP connections (control). Any transmission requests in excess of this value will be rejected. For details about rejection of transmission, see G. Transmission Rejection Messages.

If you have changed the maximum number of concurrent transmissions, the following settings are initialized the next time you start the JP1/FTP daemon:

[Figure] Transmission log

[Figure] Transmission number

[Figure] Connection number

[Figure] Protocol trace

[Figure] Module trace

When settings are initialized, their previous status is deleted. Therefore, we recommend that you back up any needed information before you start the JP1/FTP daemon. For details about the information to back up, see (2) Log information in 3.7.1 Information that can be saved and recovered. When you restore from the backup, make sure that the maximum number of concurrent transmissions is set to the same value as when the backup was created. If the maximum number of concurrent transmissions at the time the backup was made does not match the number at the time of recovery, the JP1/FTP daemon will not start.

When you restore from initialized status, the JP1/FTP daemon might be delayed temporarily. To avoid this delay, delete the above settings beforehand. The deletion tool enables you to do this easily. For details about the deletion tool, see H. Log Information Deletion Tool after Changing the Maximum Number of Concurrent Transmissions.

#2

Specify the size of the file to use for storing access logs. You can use access logs to obtain information about invalid accesses due to login errors during connection at the FTP server. When the access log exceeds the specified size, the old information is backed up and a new file is created. The value is in megabytes and the initial value is 0. You need a maximum disk capacity of double the specified size (including the backup files). You can use a text editor to view the access logs. For details about the access logs, see 3.16 Collecting access logs.

#3

If the setting for FTP connection response message control is set to UNCHECK, a response message is displayed as follows during FTP connection:

[Figure]

If the setting is set to CHECK, a response message is displayed as follows during FTP connection:

[Figure]

The default is UNCHECK. When you set CHECK, you can also specify a desired character string for the response message that is sent during FTP connection. For details about the FTP connection response message control function, see 3.17 FTP connection response message control function.

`-L`

Displays environment information.

Example of display:

[Figure]

#

If you have changed the maximum number of concurrent transmissions, a number in parentheses might be displayed in the maximum number of concurrent transmissions column. This number indicates the maximum number of concurrent transmissions that were in effect at that point and is displayed when a new maximum number of concurrent transmissions is different from the maximum number of concurrent transmissions that was in effect when the information was displayed.

The following example shows a change in the maximum number of concurrent transmissions from 64 to 128:

Maximum number of concurrent transmissions: 128 (64)

To Page Top

Return values

`0`	Normal termination
`62`	Abnormal termination during change
`64`	Abnormal termination during display
`91`	Abnormal termination due to a syntax error in a command parameter

To Page Top