Getting TIBCO Patterns Servers Version Information (lkt_svrversion)
The following command is used to get the server version and configuration information:
dvkerr_t lkt_svrversion( lpar_t host, lpar_t *version );
lkt_svrversion returns information that can identify the particular version of the server that is running and information on its current configuration.
Input
host (required)
For more information, see Communicating with TIBCO Patterns Servers.
Output
version (required)
is a list containing the following lpars:
|
•
|
SVR_LPAR_BLK_DEVKITINFO this holds the version information on the DevKit used to build the server. It is a free form string containing build and feature selection information. |
|
•
|
SVR_LPAR_BLK_SERVERINFO this holds version information on the server. It is structured as an XML snippet with the following form: |
<server_info>
<product_name>official product name</product_name>
<version>full version number</version>
<build_date>time and date built</build_date>
<who_built>ID of who ran build</who_built>
</server_info>
Where official product name is the official name for this version of the server, for example, TIBCO Patterns, full version number is the 3 place version number, for example, 5.3.0, time and date built is what it says, a date stamp for when the build for this server was performed, and ID of who ran build is also what is says, the ID of who ran the build.
|
•
|
LPAR_INT_PLAINTEXT_PORT The port the server is listening on for plaintext communications. If plaintext communications are disabled, -1 is reported. |
|
•
|
LPAR_INT_ENCRYPTED_PORT The port the server is listening on for encrypted communications. If encrypted communications are disabled, -1 is reported. |
|
•
|
LPAR_BOOL_DBGIPFILTER True if the GIP prefilter is enabled. |
|
•
|
LPAR_BOOL_DBSORTFILTER True if the SORT prefilter is enabled. |
|
•
|
LPAR_BOOL_DBPSIFILTER True if the PSI prefilter is enabled. |
|
•
|
LPAR_INT_MAXTHREADS Maximum number of command processing threads that runs in parallel. |
|
•
|
LPAR_STR_CHECKPOINTDIR The path name of the directory used for checkpoint/restore. If checkpoint/restore is not enabled, this is the string “(not-enabled)”. |
|
•
|
LPAR_BOOL_AUTORESTORE True if the server was started with the auto-restore flag. |
|
•
|
LPAR_STR_GATEWAYCFG The path name of the cluster configuration file for a gateway process. If this is not a gateway server, this is the string "(not a gateway)". |
|
•
|
LPAR_INT_MAXMEMKB The memory cap in K-Bytes. This is zero if no memory cap was set. |
|
•
|
LPAR_BOOL_DBRLINKFILTER This is true if the TIBCO Patterns Machine Learning Platform is enabled on this server. |
|
•
|
LPAR_INT_TRAN_IDLETIME the maximum transaction idle time out value, in seconds. |
|
•
|
LPAR_STR_TRAN_CLOSE_ACT is the action taken against transactions that exceed the time out limit. One of: “a” abort it, “e” abort if it has errors, commit otherwise, “c” forcibly commit the transaction, even if it has errors, “n” do nothing, “ “ no change. |
|
•
|
LPAR_BOOL_DBGIPGPU is true if GIP GPU acceleration is enabled, false otherwise. |
|
•
|
LPAR_LST_GPU_DEVICE_INFOS is output if LPAR_BOOL_DBGIPGPU is true and there is at least one known GPU device. This list contains one or more LPAR_LST_GPU_DEVICE_INFO lists. Each of these contains the following: |
|
—
|
LPAR_INT_GPU_DEVICE_ID the numeric id for the GPU device. |
|
—
|
LPAR_STR_GPU_DEVICE_NAME the name for the GPU device. |
|
—
|
LPAR_INT_GPU_DEVICE_USAGE a set of bit flags indicating the state of the device. The flags used are: (1) This is a recommended device, (2) This device does not meet minimum specifications, (4) this is a default device, (8) this device is used only on explicit request. |
For more information about the configuration settings, see the TIBCO® Patterns Installation guide.
Error codes and items returned by lkt_svrversion
|
IPCERR
|
(none)
|
|
IPCTIMEOUT
|
(none)
|
|
IPCEOF
|
(none)
|
|
HANDSHAKE
|
(none)
|