Explanation of Each Field
CLI Information Settings
- cli.apiKey
-
An API key to be used in CLI
Specify an API key that is issued on the API Key Management screen of Management Console.
This field is mandatory.
- cli.agent.id
-
The ID that identifies CLI
This field is mandatory and case-sensitive.
NoteIf you intend to connect to HULFT8 for IBMi, do not use lowercase characters for cli.agent.id for the following reasons:
-
This setting value is used for Host Name in the Host Information on HULFT.
-
In HULFT8 for IBMi, you cannot use lowercase characters in the management information settings.
-
- cli.hostname
-
The host name that executes CLI
This field is mandatory.
NoteIf you intend to connect to HULFT8 for IBMi, do not use lowercase characters for cli.hostname for the following reasons:
-
This setting value is used for Host Name in the Host Information on HULFT.
-
In HULFT8 for IBMi, you cannot use lowercase characters in the management information settings.
-
Connection Information Settings
- connection.id
-
The ID to be used when connecting to HULFT-WebConnect
The ID must be unique within the HULFT-WebConnect service.
This field is mandatory.
Note-
Connection IDs must be registered on Management Console in advance.
-
CAUTION When you use CLI of the version lower than 2.2.0, confirm whether or not IP Filter is set to the Connection ID defined in the CLI configuration file. If it is set to the Connection ID, you cannot perform file transfer using the Connection ID.
-
If you intend to connect to HULFT8 for IBMi, do not use lowercase characters for connection.id for the following reasons:
-
This setting value is used for Host Name in the Host Information on HULFT.
-
In HULFT8 for IBMi, you cannot use lowercase characters in the management information settings.
-
- connection.password
-
The password to be used when connecting to HULFT-WebConnect
This field is mandatory.
NoteConnection Passwords must be registered on Management Console in advance.
- service.accesspoint
-
The access point to the HULFT-WebConnect service
Do not modify the value of this field.
Proxy Information Settings
- proxy.host
-
The host name or domain name (IP address) of the proxy server
This field is considered as a comment and disabled upon installation.
To enable the field, delete the single byte number sign (#) at the beginning of the line, and then specify the value for the field.
The field is not case-sensitive.
- proxy.port
-
The port number for the proxy server
This field is considered as a comment and disabled upon installation.
To enable the field, delete the single byte number sign (#) at the beginning of the line, and then specify the value for the field.
- proxy.username
-
The user name for the proxy server that requires user authentication
This field is considered as a comment and disabled upon installation.
To enable the field, delete the single byte number sign (#) at the beginning of the line, and then specify the value for the field.
The field is case-sensitive.
- proxy.password
-
The password for the proxy server that requires user authentication
This field is considered as a comment and disabled upon installation.
To enable the field, delete the single byte number sign (#) at the beginning of the line, and then specify the value for the field.
The field is case-sensitive.
CLI Update Settings
- update.action
-
The settings for the update notification to be displayed when executing CLI
Specify 'update', 'alert' or 'none' for this field. The field is case-sensitive.
When 'update' or 'alert' is specified, CLI will notify you about whether or not there is an update. You must update CLI manually.
= Remarks ='update' is deprecated. It will be obsolete in future versions.
Example: Update Available
I600029 - The update check succeeded. Message:[You can update to latest version X.X.X from Y.Y.Y.]
Example: No Available Update
I600029 - The update check succeeded. Message:[You do not have to update: latest version X.X.X.]
- update.action.onError
-
The settings for whether the CLI execution process should continue or be aborted if the update fails
Only when 'update.action' is set to 'update' or 'alert', the setting value of this field is valid.
Specify 'continue' or 'abort' for this field. The field is case-sensitive.
When 'continue' is specified, the CLI execution process is continued even if the update fails.
When 'abort' is specified, the CLI execution process is aborted if the update fails.
System Operation Settings
- directory.work
-
The work directory for CLI
The work directory is a directory that stores temporary files created during the file transfer.
- io.file.overwrite
-
The specification of whether to overwrite the receive file that is used when the file is transferred by using the GET method
Specify 'true' when you want to overwrite the file.
When 'false' is specified, the file is not overwritten.
If nothing is specified, the default value is 'false'.
- io.session.timeout
-
The non communication time-out setting
Specify the value from '0' to '60' (Unit: seconds).
When '0' is specified, the time-out processing is not performed.
If nothing is specified, the default value is '60'.
- jvm.options
-
The startup options for Java to be used when executing CLI
To specify multiple options, separate the options by using half-width spaces.
The field is case-sensitive.
Example: Allocation of Memory
jvm.options=-Xms32M -Xmx32M
Example: Language Settings
# Set to English. jvm.options=-Duser.language=en # Set to Japanese. jvm.options=-Duser.language=ja
NoteThe available format and values that can be specified might vary depending on the version of Java.
Configuration File Version Settings
- configuration.version
-
The version of the CLI configuration file
Do not modify the value of this field.
No |
Key Name |
Explanation |
Default Value |
Value When Omitted |
Mandatory |
Setting Value |
Remarks |
---|---|---|---|---|---|---|---|
1 |
cli.apiKey |
API key to be used in CLI |
|
|
✓ |
Alphanumeric characters |
Case-sensitive |
2 |
cli.agent.id |
ID that identifies CLI |
|
|
✓ |
Alphanumeric characters Particular symbols(*1) |
Within 25 bytes, case-sensitive |
3 |
cli.hostname |
Host name that executes CLI |
|
|
✓ |
Alphanumeric characters Particular symbols(*1) |
Within 25 bytes, case-sensitive |
4 |
connection.id |
Connection ID |
|
|
✓ |
Alphanumeric characters Particular symbols(*1) |
Within 16 bytes, case-sensitive |
5 |
connection.password |
Connection Password |
|
|
✓ |
Alphanumeric characters Particular symbols |
From 8 to 256 bytes Case-sensitive |
6 |
service.accesspoint |
Service access point |
service-ap.tokyo.webconnect.hulft.com |
|
✓ |
|
Cannot be modified |
7 |
proxy.host |
Proxy server host name |
|
|
|
Alphanumeric characters Particular symbols |
Within 255 bytes, case-insensitive |
8 |
proxy.port |
Proxy server port number |
|
|
|
From 1 to 65535 |
|
9 |
proxy.username |
Proxy server user name |
|
|
|
Half width characters |
Within 256 bytes, case-sensitive |
10 |
proxy.password |
Proxy server password |
|
|
|
Half width characters |
Within 256 bytes, case-sensitive |
11 |
update.action |
CLI update settings |
alert |
alert |
|
update | alert | none |
Case-sensitive |
12 |
update.action.onError |
CLI execution settings on the update failure |
continue |
continue |
|
continue | abort |
Case-sensitive |
13 |
directory.work |
Work directory for CLI |
. |
. |
|
|
|
14 |
io.file.overwrite |
Specification of whether to overwrite the receive file |
false |
false |
|
true, false |
Case-sensitive |
15 |
io.session.timeout |
Session time-out |
60 |
60 |
|
From 0 to 60 |
|
16 |
jvm.options |
Java startup options |
-Xms32M -Xmx32M |
|
|
Half width characters |
Case-sensitive |
17 |
configuration.version |
Configuration file version settings |
|
|
✓ |
|
Cannot be modified |
*1 |
: |
If you intend to connect to HULFT8 for IBMi, do not use lowercase characters. |
The specifiable symbols for 'cli.agent.id', 'cli.hostname' and 'proxy.host' are hyphens (-) and periods (.).