AP Recompilation Guide by Upgrade Type

1. Overview

When upgrading Tmax and the operation system, you must check whether the Tmax application (hereafter "AP") needs to be recompiled. This is essential to ensure stable system operation and prevent unexpected errors.

The following describes AP recompilation requirements for each major case.

Case	Recompilation
Tmax Major/SP Upgrade	Required
Tmax Fix Upgrade	Recommended
Static Library Usage	Required
OS Major Upgrade	Recommended
OS Minor Upgrade	Not Required (only for backward-compatible)
Upgrade from Tmax 4 to Tmax 5	Required (some functions may not be available if not performed)

Case

Recompilation

Tmax Major/SP Upgrade

Required

Tmax Fix Upgrade

Recommended

Static Library Usage

Required

OS Major Upgrade

Recommended

OS Minor Upgrade

Not Required (only for backward-compatible)

Upgrade from Tmax 4 to Tmax 5

Required (some functions may not be available if not performed)

After the upgrade, you must recompile the AP in a test environment, verify the key functions, and then apply it to the production environment. Additionally, check the library linking method according to the latest Tmax guidelines.

2. AP Recompilation for Tmax Upgrade

The following describes AP recompilation requirements for each Tmax upgrade case.

Case	Recompilation	Description
Major or SP Upgrade	Required	Internal structures or libraries are likely to change, which may cause a malfunction of existing APs.
Fix Upgrade	Recommended	Although existing APs may still function, recompilation is recommended to apply any changes due to Fix upgrade.
Static Library Usage	Required	Static libraries do not reflect changes in new library.

Case

Recompilation

Description

Major or SP Upgrade

Required

Internal structures or libraries are likely to change, which may cause a malfunction of existing APs.

Fix Upgrade

Recommended

Although existing APs may still function, recompilation is recommended to apply any changes due to Fix upgrade.

Static Library Usage

Required

Static libraries do not reflect changes in new library.

3. AP Recompilation for OS Upgrade

The following describes AP recompilation requirements for each OS upgrade case.

Case	Recompilation	Description
Major Version Upgrade	Recommended	For major version upgrades (example: AIX 6.1 → AIX 7.1), Tmax is recommended to be reinstalled for the upgraded OS version, and APs must be recompiled to ensure compatibility and reliability.
Minor Version Upgrade	Not Required	For minor version upgrades (example: RHEL 7.5 → RHEL 7.9), recompilation is not required if the OS ensures backward-compatibility.

Case

Recompilation

Description

Major Version Upgrade

Recommended

For major version upgrades (example: AIX 6.1 → AIX 7.1), Tmax is recommended to be reinstalled for the upgraded OS version, and APs must be recompiled to ensure compatibility and reliability.

Minor Version Upgrade

Not Required

For minor version upgrades (example: RHEL 7.5 → RHEL 7.9), recompilation is not required if the OS ensures backward-compatibility.

4. AP Recompilation for Upgrade from Tmax 4 to Tmax 5

When upgrading from Tmax 4 to Tmax 5, APs must be recompiled due to different architectures and library structures.

If APs are not compiled, some functions may not work, or unexpected errors may occur.

'tmadmin function' unavailable

Errors occur because tmadmin-related structures have been changed in Tmax 5.
TDL function malfunction

If recompilation is not performed on the Server or Client, invoking TDL function may cause malfunction or failure.

In Tmax 5, do not link libsvr* and libcli* libraries together with libtdlcall*.
TCPGW unavailable

In Tmax 5, libtcpgw and libtmaxgw must be linked together. The TCPGW programs configured the same way as in Tmax 4 do not function properly in Tmax 5.