System Environment Settings
This topic explains how to register the environment settings for the client.
You can view and modify this information on HULFT-HUB Manager Management screen.
| [Note] | The screen structures vary depending on the version and host type of the client. |
List of Fields
1. Basic Settings
<Table> System Environment Settings (Basic Settings)
| No. | Field Name | Default Value | Setting Value | Specification | Remarks |
|---|---|---|---|---|---|
| A1 | Work File Generation Path | /usr/tmp | Alphanumeric characters | Mandatory | Within 50 bytes |
| A2 | Command Acknowledge Port No. | From 1 to 65535 | Optional | ||
| A3 | Send Process Multiplex Level | 10 | From 1 to 9999 | Mandatory | |
| A4 | Receive Process Multiplex Level | 0 | From 0 to 9999 | Mandatory | 0: No Limit |
| A5 | Receive Port No. | 30000 | From 1 to 65535 | Mandatory | *1 |
| A6 | Request Acknowledge Port No. | 31000 | From 1 to 65535 | Mandatory | *1 |
| A7 | PPP Acknowledge Port No. | 32000 | From 1 to 65535 | Mandatory | |
| A8 | JIS Year | 83JIS | *2 | Mandatory | *1 |
| A9 | Kanji Code Type | SHIFT-JIS | *2 | Mandatory | *1 |
| A10 | Space Character Mode | Mode 1 | *2 | Mandatory |
| *1: | This is located in the Basic Settings of the Registered Client settings on the Management screen. |
| *2: | Select an option from the list that is shown on the screen. |
2. Extension Settings
<Table> System Environment Settings (Extension Settings)
| No. | Field Name | Default Value | Setting Value | Specification | Remarks |
|---|---|---|---|---|---|
| B1 | Connect Retry Count | 5 | From 0 to 9999 | Mandatory | |
| B2 | Connect Retry Interval | 20 | From 0 to 9999 | Mandatory | Unit: second |
| B3 | Socket Buffer Size | 12288 | 0, from 4096 to 65520 | Mandatory | Unit: byte |
| B4 | Socket Timeout | 3600 | From 10 to 259200 | Mandatory | Unit: second |
| B5 | Request Acknowledge Timeout | 86400 | From 10 to 259200 | Mandatory | Unit: second |
| B6 | Utility Timeout | 60 | From 10 to 259200 | Mandatory | Unit: second |
3. Extension2 Settings
<Table> System Environment Settings (Extension2 Settings)
| No. | Field Name | Default Value | Setting Value | Specification | Remarks |
|---|---|---|---|---|---|
| C1 | Status Display Selection | Display All | *1 | Mandatory | |
| C2 | Pack Zone Conversion | Mode 0 | *1 | Mandatory | |
| C3 | Sign for ASCII | Mode 1 | *1 | Mandatory | |
| C4 | Sign for EBCDIC | Mode 1 | *1 | Mandatory | |
| C5 | Auto Resend Retry Count | 0 | From 0 to 9 | Mandatory | |
| C6 | Log Switch Count | 0 | From 0 to 999999 | Mandatory | Unit: record |
| C7 | Send Transfer Error Recovery | Unsuccessful Mode | *1 | Mandatory | |
| C8 | External Character Table Mode | No | *1 | Mandatory | |
| C9 | Process when External character has not been Registered | Default Value | *1 | Mandatory | |
| C10 | Receive Multiplex Level Over Retry | Do Not Retry | *1 | Optional | |
| C11 | KEIS Em-size Space Mode | Mode 0 | *1 | Optional | |
| C12 | Criteria to Delete Resend Queue | Mode 1 | *1 | Optional | |
| C13 | HULFT-SAN Ver.5 Product | HULFT-SAN(H) | *1 | Optional | |
| C14 | Code Conversion Mode | Mode 0 | *1 | Mandatory | |
| C15 | Request Acknowledge Host Check | No | *1 | Mandatory | |
| C16 | Framed Message Transfer Type | Send and Receive Speed Priority Mode | *1 | Mandatory | |
| C17 | Send Daemon Communication Method | *1 | Mandatory |
| *1: | Select an option from the list that is shown on the screen. |
4. Others
<Table> System Environment Settings (Others)
| No. | Field Name | Default Value | Setting Value | Specification | Remarks |
|---|---|---|---|---|---|
| D1 | Job Timeout | 999999 | From 10 to 259200 | Mandatory | Unit: second |
| D2 | FIFO Path | /tmp | Alphanumeric characters | Mandatory | Within 50 bytes |
| D3 | FIFO Identification Number | 10 | From 1 to 99 | Mandatory | |
| D4 | Receive Open Mode | Mode 1 | *1 | Mandatory | |
| D5 | Tab Code Mode | Space | *1 | Mandatory |
| *1: | Select an option from the list that is shown on the screen. |
5. Inter-HULFT Settings
<Table> System Environment Settings (Inter-HULFT Settings)
| No. | Field Name | Default Value | Setting Value | Specification | Remarks |
|---|---|---|---|---|---|
| E1 | Path to Inter-HULFT Common Environment | Optional | Within 200 bytes | ||
| E2 | Local File Lock Mode | Mode 0 | *1 | Mandatory |
| *1: | Select an option from the list that is shown on the screen. |
| [Legend] | |
| Default Value | Default value that is set when you install HULFT |
| Specification | Whether the specification is mandatory or optional when you update the management information record on a screen |
Explanation of Each Field
The following describes each field in the Basic Settings.
(A1) Work File Generation Path
This field specifies the directory for the work file that HULFT creates temporarily.
HULFT processes data to be sent or received and creates a work file temporarily to contain the data, when necessary. Therefore, confirm that there is sufficient unused area in the partition when configuring this setting.
(A2) Command Acknowledge Port No.
This field specifies the port number that the Send daemon uses to acknowledge requests.
Ensure that this port number is not the same as a port number that is reserved by the operating system, or a port number that is used by another HULFT daemon.
| [Note] | You can specify this field if the client is HULFT for UNIX/Linux Ver.7.2 or higher, and you specify 'Socket' for the Send Daemon Communication Method. |
(A3) Send Process Multiplex Level
This field specifies the maximum number of Send processes that can be run simultaneously by the Send daemon.
The load on the system and lines grows heavier as the number of simultaneous Send processing increases. Set a value that is appropriate for the conditions of the system that you are currently using.
(A4) Receive Process Multiplex Level
This field specifies the maximum number of Receive processes that can be started simultaneously.
When the number of instances of the Receive processing exceeds the value that you set for this field, HULFT does not acknowledge instances of the Receive processing that exceed the value. Set a value that is appropriate for the conditions of the system that you are currently using.
This field specifies the port number at which the Receive daemon waits and accepts data sent from another host.
Ensure that this port number is not the same as a port number that is reserved by the operating system, or a port number that is used by another HULFT daemon.
| [Remarks] | If you want to view and modify this field on the Management screen, you can find it in the Registered Client Information. |
(A6) Request Acknowledge Port No.
This field specifies the port number at which the Request Acknowledge daemon acknowledges requests from another host.
Ensure that this port number is not the same as a port number that is reserved by the operating system, or a port number that is used by another HULFT daemon.
| [Remarks] | If you want to view and modify this field on the Management screen, you can find it in the Registered Client Information. |
This field specifies the port number that the PPP Server uses.
This field specifies the JIS year of the Kanji code type of the system on which HULFT is operating.
<Table> Setting Values for JIS Year
| On-screen Options |
Description |
|---|---|
| 78JIS | 78 JIS |
| 83JIS | 83 JIS |
| [Remarks] | If you want to view and modify this field on the Management screen, you can find it in the Registered Client Information. |
This field specifies the Kanji code type of the system on which HULFT is operating.
<Table> Setting Values for Kanji Code Type
| On-screen Options |
Description |
|---|---|
| EUC | EUC |
| SHIFT-JIS | SHIFT-JIS |
| UTF-8 | UTF-8 |
| [Remarks] | |
| - | If you want to view and modify this field on the Management screen, you can find it in the Registered Client Information. |
| - | You can select 'UTF-8' in HULFT7 or higher. |
This field specifies the conversion rules for space codes.
<Table> Setting Values for Space Character Mode
| On-screen Options |
Description |
|---|---|
| Mode 0 | Carry out the same conversion as the previous method (Ver.3.x.x). |
| Mode 1 | Use ASCII code 0x2020 as a single-byte space for conversion, unlike the previous method. |
For details about space code conversion rules, refer to Administration Manual for the client.
The following describes each field in the Extension Settings.
This field specifies the number of times to try reconnecting if socket connection to the host on the receiving side fails.
When '0' is specified, reconnection is not carried out.
This field specifies the interval to wait to try reconnecting to the host on the receiving side if socket connection fails.
Specify the wait time before HULFT carries out auto resending, in seconds.
This field specifies the input/output size for socket communication.
If you specify '0,' HULFT applies the value that is configured in the environment (operating system).
This field specifies the time-out duration before communication is stopped due to no response from the remote host.
If you set '999999,' HULFT waits for a response without any time limit.
(B5) Request Acknowledge Timeout
This field specifies the time-out duration when communication during the Request Acknowledge processing is interrupted due to no response from the remote host.
If you set '999999,' HULFT waits for a response without any time limit.
This field specifies the time-out duration when one of the following utilities issues a request to HULFT daemons:
- utlsend
- utlrecv
- utlscan
- utlschange
- utlkillsnd
- utlalivecheck
- utltriggerconf
If you set '999999,' HULFT waits for a response without any time limit.
The following describes each field in the Extension2 Settings.
This field specifies the types of transfer status that are displayed on the Send and Receive Status List screen.
<Table> Setting Values for Status Display Selection
| On-screen Options |
Description |
|---|---|
| Display Only Send | Display only the Send status |
| Display All | Display the Send status and Receive status |
This field specifies the conversion rules for Signed Internal Decimal (P) and Signed External Decimal (S) during format transfer or multi format transfer.
<Table> Setting Values for Pack Zone Conversion
| On-screen Options |
Description |
|---|---|
| Mode 0 | For details about pack zone conversion rules, refer to Administration Manual for the client. |
| Mode 1 | |
| Mode B | |
| Mode F | |
| Mode 9 | |
| Mode S | |
| Mode N |
This field specifies the sign part when Signed Internal Decimal (P) and Signed External Decimal (S) are converted to ASCII data during format transfer or multi format transfer.
This setting becomes effective when you specify 'Mode S' for the Pack Zone Conversion.
<Table> Setting Values for Sign for ASCII
| On-screen Options |
Zone | Sign | |
|---|---|---|---|
| Positive | Negative | ||
| Mode 1 | 3 | 4 | 5 |
| Mode 2 | 3 | 3 | 7 |
This field specifies the sign part when Signed Internal Decimal (P) and Signed External Decimal (S) are converted to EBCDIC data during format transfer or multi format transfer.
This setting becomes effective when you specify 'Mode S' for the Pack Zone Conversion.
<Table> Setting Values for Sign for EBCDIC
| On-screen Options |
Zone | Sign | |
|---|---|---|---|
| Positive | Negative | ||
| Mode 1 | F | C | D |
| Mode 2 | F | F | D |
This field specifies the number of times to try auto resending when a communication error occurs during the Send processing and the Receive processing.
If you specify '0,' HULFT does not attempt auto resending.
This field specifies the timing for the auto deletion of the Send Log records, the Receive Log records, and the Request Acknowledge Log records.
When the number of log records in each log file exceeds the specified value, log file switching is carried out.
If you specify '0' for this field, HULFT does not carry out log file switching.
(C7) Send Transfer Error Recovery
This field specifies how to handle the situation when clearing or deleting the Send file ends unsuccessfully.
HULFT clears or deletes the Send file when the Send processing or the Receive processing has ended successfully.
<Table> Setting Values for Send Transfer Error Recovery
| On-screen Options |
Description |
|---|---|
| Unsuccessful Mode | Treat as unsuccessful end and execute the unsuccessful job |
| Successful Mode | Treat as successful end and execute the successful job |
(C8) External Character Table Mode
This field specifies how to handle external character table conversion.
<Table> Setting Values for External Character Table Mode
| On-screen Options |
Description |
|---|---|
| No | Convert all external character codes to '□' without using the external character table. |
| Yes | Refer to the external character table, and convert external character codes as appropriate. |
| Priority | Give priority to the external character table, and convert codes as appropriate. |
For details about the external character table, refer to Administration Manual for the client.
(C9) Process when External Character has not been Registered
This field specifies the handling of codes which are not listed in JIS Level 1 and JIS Level 2, nor registered in the external character table.
<Table> Setting Values for Process when External character has not been Registered
| On-screen Options |
Description |
|---|---|
| Default Value | Convert to the default code |
| Error | Treat as an external character conversion error |
(C10) Receive Multiplex Level Over Retry
This field specifies whether to retry a connection if an error occurs due to exceeding of the Receive Multiplex Level during socket connection to the host on the receiving side.
<Table> Setting Values for Receive Multiplex Level Over Retry
| On-screen Options |
Description |
|---|---|
| Check box not selected | Treat as an error without retrying a connection |
| Check box selected | Retry a connection |
HULFT uses the Connect Retry Count and the Connect Retry Interval for the retry count and the wait time for reconnecting.
This field specifies the conversion rules for KEIS em-size (double-byte) space codes. This field is valid only if you have selected 'Mode 1' for the field that is described in "(A9) Space Character Mode."
<Table> Setting Values for KEIS Em-size Space Mode
| On-screen Options |
Description |
|---|---|
| Mode 0 | Convert em-size (double-byte) space codes to 0x4040 |
| Mode 1 | Convert em-size (double-byte) space codes to 0xA1A1 |
(C12) Criteria to Delete Resend Queue
This field specifies the criteria for deleting records from the Resend Queue when the Send processing is requested for a file ID that already exists in the Resend Queue and when transfer ends unsuccessfully.
<Table> Setting Values for Criteria to Delete Resend Queue
| On-screen Options |
Description |
|---|---|
| Mode 1 | Delete the record with the same file ID and host name |
| Mode 2 | Delete the record with the same file ID, host name, and file name |
This field specifies the product that is installed on the host on the sending side when a local host that is running HULFT-SAN Ver.6 is the receiving host and the sending host is running HULFT-SAN Ver.5. You cannot use this field if the host on the sending side is running a version other than HULFT-SAN Ver.5.
<Table> Setting Values for HULFT-SAN Ver.5 Product
| On-screen Options |
Description |
|---|---|
| HULFT-SAN(H) | HULFT-SAN(H) Ver.5 is installed on the host on the sending side. |
| HULFT-SAN(F) | HULFT-SAN(F) Ver.5 or HULFT-SAN plus Ver.5 is installed on the host on the sending side. |
If you omit this field or specify an invalid value, HULFT-HUB sets 'HULFT-SAN(H).'
The default value is 'HULFT-SAN(H).'
| [Remarks] | After a version upgrade installation, HULFT-HUB sets 'HULFT-SAN(H)' if you were using HULFT-SAN(H), and sets 'HULFT-SAN(F)' if you were using HULFT-SAN(F). |
This field specifies how to handle conversion of external characters.
<Table> Setting Values for Code Conversion Mode
| On-screen Options |
Description |
|---|---|
| Mode 0 | Convert external characters with the destination code of conversion at a fixed length (other than UTF-8 code) |
| Mode 1 | Convert external characters with the destination code of conversion at a variable length |
(C15) Request Acknowledge Host Check
This field specifies how to handle requests from hosts that are not registered in the Host Information.
Specify how HULFT behaves if the host that is issuing a request is not registered in the Host Information when a service request is acknowledged. This applies to the following services: the Send Request (SEND), the Resend Request (RESEND), the Post-receive Job Result Inquiry Request (HULJOB), the Job Execution Result Notification (HULSNDRC), and the Remote Job Execution (HULRJOB).
<Table> Setting Values for Request Acknowledge Host Check
| On-screen Options |
Description |
|---|---|
| No |
Do not perform the Request Acknowledge Host Check (Acknowledge requests from hosts that are not registered in the Host Information) |
| Yes |
Perform the Request Acknowledge Host Check (Reject requests from hosts that are not registered in the Host Information) |
(C16) Framed Message Transfer Type
This field specifies the data transfer method.
<Table> Setting Values for Framed Message Transfer Type
| On-screen Options |
Description |
|---|---|
| Error Detection Priority Mode | Always transfer data in the Error Detection Priority Mode |
| Send Speed Priority Mode | Transfer data in the Transfer Speed Priority Mode for sending, and transfer data in the Error Detection Priority Mode for receiving |
| Receive Speed Priority Mode | Transfer data in the Error Detection Priority Mode for sending, and transfer data in the Transfer Speed Priority Mode for receiving |
| Send and Receive Speed Priority Mode | Always transfer data in the Transfer Speed Priority Mode |
(C17) Send Daemon Communication Method
This field specifies the communication method that is used when the Send daemon acknowledges requests.
<Table> Setting Values for Send Daemon Communication Method
| On-screen Options |
Description |
|---|---|
| FIFO | Use FIFO to acknowledge requests |
| Socket | Use socket to acknowledge requests |
The following describes each field in the Others settings.
This field specifies the job time-out.
This setting is valid for the execution of the Pre-send Job, the successful job on the receiving side when the Notification is 'Successful Job Completion,' and remote jobs. For the execution of other jobs, HULFT waits without any time limit for the job to end.
If you set '999999,' HULFT waits for the job to end without any time limit.
For details about cases where the Job Timeout is valid, refer to Administration Manual for the client.
This field specifies the directory for the fifo file that is used when a request is issued to the Send system.
(D3) Fifo Identification Number
This field specifies the key that is used for communication between the Send daemon and Send processes.
When multiple Send daemons are running on the same system, make sure that the keys are not the same.
This field specifies how to handle exclusive control of the file to be received.
<Table> Setting Values for Receive Open Mode
| On-screen Options |
Description |
|---|---|
| Mode 0 | Treat as an error if the Receive file is locked |
| Mode 1 | Wait until the lock is released |
This field specifies whether to handle a tab code (0x09) as a space code (0x20) or as a tab code (0x09) during text transfer to a EBCDIC-type host with sending side conversion.
<Table> Setting Values for Tab Code Mode
| On-screen Options |
Description |
|---|---|
| Space | Handle as a space code |
| Tab | Handle as a tab code |
The following describes each field in the Inter-HULFT Settings.
You can configure the Inter-HULFT Settings only for clients that are running HULFT7 for UNIX/Linux-EX.
(E1) Path to Inter-HULFT Common Environment
This field is used to carry out exclusive control for the same files as HULFT that is installed on another host, in an environment where HULFT7 for UNIX/Linux-EX is installed. You must specify a path that indicates the same directory for all HULFT systems that carry out exclusive control of the same files.
If you omit this specification, HULFT-HUB sets 'HULPATH.' For details about HULPATH, refer to Administration Manual for the client.
This field specifies the lock system to be used for local files when HULFT7 for UNIX/Linux-EX is installed.
<Table> Setting Values for Local File Lock Mode
| On-screen Options |
Description |
|---|---|
| Mode 0 | Do not use networked file locking for local files |
| Mode 1 | Use networked file locking for local files |
For details about networked file locking, refer to Administration Manual for the client.