Connection
The settings for controlling the connection to the HSM are detailed below.
| Variable | Quick Description |
|---|---|
HSM_MAX_SOCKET_RETRIES |
Maximum number of retries to open a TCP socket. |
HSM_CONNECT_TIMEOUT |
Wait time (in milliseconds) for connection establishment before failing. |
HSM_MAX_CONNECT_RETRIES |
Maximum number of retries to connect to the HSM. |
HSM_RECV_TIMEOUT |
Wait time (in milliseconds) for receiving a network packet before failing. |
HSM_SEND_TIMEOUT |
Wait time (in milliseconds) for a network packet transmission before failing. |
Socket Open Attempts
Environment variable to be set: HSM_MAX_SOCKET_RETRIES
| Value | Socket Open Attempts |
|---|---|
| Not defined | 03 attempts. |
| n | number of retries, minimum of 0 (zero) and maximum of 16 (sixteen). |
In some situations, the server running the application may have a very small number of local communication ports (known as sockets), which prevents or hinders communication between the application and the HSM.
Connection Timeout
Environment variable to be set: HSM_CONNECT_TIMEOUT
| Value | Connection Timeout |
|---|---|
| Not defined (or 0) | uses the operating system's default timeout and a blocked socket. |
| n | time in milliseconds (ms) that the library must wait before giving up on closing the connection. |
Note: available from version 4.7.18 of the library.
Attempts to connect to the HSM
Environment variable to be set: HSM_MAX_CONNECT_RETRIES
| Value | Attempts to connect to the HSM |
|---|---|
| Not defined | 03 attempts. |
| n | number of retries, minimum of 0 (zero) and maximum of 16 (sixteen). |
Receive Timeout
Environment variable to be set: HSM_RECV_TIMEOUT
| Value | Receive Timeout |
|---|---|
| Not defined | default time used in the operating system's TCP/IP protocol stack. Consult the documentation for your particular operating system about this value. |
| n | time in milliseconds (ms) that the library must wait before it stops receiving data. |
Send Timeout
Environment variable to be set: HSM_SEND_TIMEOUT
| Value | Send Timeout |
|---|---|
| Not defined | default time used in the operating system's TCP/IP protocol stack. Consult the documentation for your particular operating system about this value. |
| n | time in milliseconds (ms) that the library must wait before giving up receiving data/ |