jAgent is a utility supplied with jBASE that runs as an application or service.
jAgent can only be used for connections to jBASE. jAgent is the recommended Connection Type for jBASE when Linkar SERVER is running over Windows, though Terminal connections can also be used in that environment.
jAgent can only be used when Linkar SERVER is installed over Windows. When Linkar SERVER is installed over Linux or macOS, the Terminal connection type must be used.
EntryPoints connect to jBASE via jAgent using jremote.dll. This library is available only for Windows Operating Systems.
To connect to jBASE with this library, jBASE must be running jAgent. EntryPoints connect with jBASE using jAgent with one of the three authentication modes supported by jAgent: anonymous, user, or account.
In user or account authentication modes, a username and password are required, and the user must have permissions to access data for the jAgent utility. These permissions are defined in a file called JAGENT_USER.
As much as we at Kosday try to help with connection issues, ultimately it is the responsibility of the developer/administrator to install and configure the platform-specific connectivity tools. Kosday supports the Linkar product, and our ability to "support" usage of other products is limited. Therefore, our recommendation for all connection types, is for the developer to install and test the tools according to the guidelines provided by the vendors. When successful connections have been confirmed, configure Linkar to work with that environment.
(Screenshots on this page show the bottom part of EntryPoint Configuration)
In Linkar MANAGER, properties with a green label do not need a restart of the EntryPoint after a change.
Database Host
|
Display Only |
|
Shows the database server host from the Profile. |
Database Port |
Mandatory
|
|
TCP port on which jAgent is listening. By default, this is 20002 or 20003. |
Timeout in Database Answers
|
Mandatory |
hot-change New received requests |
The maximum time in seconds to wait for a response from the database. The operation is canceled and an error is returned to the Linkar Client when there is no response after this time period. The Database Session remains until closed by the client or other normal processes. If an expiration time of 0 is defined, requests default to never timeout. It would therefore be strongly recommended to set a timeout in the Linkar CLIENT application code.
|
Database Username |
Mandatory
|
|
The jBASE database user that opens the connection. (Possibly OS user.) |
Database Password (URL)
|
Mandatory |
|
Password for the jBASE/OS User. Or URL to obtain the password via REST web service |
Database Account
|
Mandatory |
|
Data account on which the requests will be executed. The data account must already be enabled for use with Linkar SERVER. |
jAgent Authentication Mode |
Mandatory |
|
Allows selecting the authentication mode used with the jAgent. Depending on the selected mode, the required text boxes will be enabled to provide data for each authentication mode.
Anonymous: No data is required. User: jAgent Username and Password must be provided. (*) Account: jAgent Username, Password and Account must be provided. (*)
(*) Any user and password that exists in the JBASE_USER file.
|
jAgent Username |
|
|
jAgent user name |
jAgent Password (URL) |
|
|
jAgent user password. Or URL to obtain the password via REST web service |
jAgent Account |
|
|
jAgent account |
