Tmax Administrator's Guide

Tmax v5.0 SP2 Fix #1

Restricted Rights Legend

All TmaxSoft Software (Tmax®) and documents are protected by copyright laws and international convention. TmaxSoft software and documents are made available under the terms of the TmaxSoft License Agreement and may only be used or copied in accordance with the terms of this agreement. No part of this document may be transmitted, copied, deployed, or reproduced in any form or by any means, electronic, mechanical, or optical, without the prior written consent of TmaxSoft Co., Ltd.

Nothing in this software document and agreement constitutes a transfer of intellectual property rights regardless of whether or not such rights are registered) or any rights to TmaxSoft trademarks, logos, or any other brand features.

This document is for information purposes only. The company assumes no direct or indirect responsibilities for the contents of this document, and does not guarantee that the information contained in this document satisfies certain legal or commercial conditions.

The information contained in this document is subject to change without prior notice due to product upgrades or updates. The company assumes no liability for any errors in this document.

Trademarks

Tmax®, Tmax WebtoB® and JEUS® are registered trademark of TmaxSoft Co., Ltd. Other products, titles or services may be registered trademarks of their respective companies.

Open Source Software Notice

Some modules or files of this product are subject to the terms of the following licenses: openssl-0.9.7.m, zlib-1.1.4, expat-2.0.0, netsnmp, DCE1.0, pthread, google-diff-match-patch, libevent, getopt.

Detailed Information related to the license can be found in the following directory: ${INSTALL_PATH}/license/oss_licenses.

Document Information

Document Name: Tmax Administrator's Guide

Document Created: 2016-03-31

Software Version: Tmax v5.0 SP2 Fix #1

Document Version: v2.1.5.1


Table of Contents

About This Document
1. Introduction
1.1. Overview
1.2. Tmax Architecture
1.3. System Architecture
1.4. System Administration
1.4.1. Static Management
1.4.2. Dynamic Management
1.5. Directory Structure
2. Environment Variables
2.1. Overview
2.2. Tmax Environment Variables
2.2.1. Tmax Server Configuration Variables
2.2.2. Tmax Client Environment Variables
2.3. Defining Tmax Environment Variables
2.3.1. Server Environment Variables
2.3.2. Client Environment Variables
2.4. Registering Multiple Servers
3. Environment Configuration
3.1. Overview
3.1.1. Environment File Format
3.1.2. Tmax Environment File
3.2. Basic Configuration
3.2.1. DOMAIN
3.2.2. NODE
3.2.3. SVRGROUP
3.2.4. SERVER
3.2.5. SERVICE
3.2.6. GATEWAY
3.2.7. ROUTING
3.2.8. RQ
3.2.9. HMS
3.2.10. Basic Configuration Example
3.3. Database Configuration Settings
3.3.1. SVRGROUP
3.3.2. Database Configuration Example
3.4. Distributed Transaction Settings
3.4.1. DOMAIN
3.4.2. NODE
3.4.3. SVRGROUP
3.5. Load Balancing Settings
3.5.1. System Load Management
3.5.2. Data Dependent Load Balancing
3.6. Reliable Queue Settings
3.6.1. SVRGROUP
3.6.2. RQ
3.7. HMS Settings
3.7.1. DOMAIN
3.7.2. NODE
3.7.3. SVRGROUP
3.7.4. HMS
3.8. Fault Tolerance Settings
3.8.1. Hardware Failure
3.8.2. Software Failure
3.9. Security Settings
3.9.1. Security Levels
3.9.2. Other Security Settings
3.10. Multi Domain Settings
3.10.1. DOMAIN
3.10.2. NODE
3.10.3. SVRGROUP
3.10.4. SERVER
3.10.5. SERVICE
3.10.6. GATEWAY
3.10.7. ROUTING
3.11. Compiling Tmax Configuration File
3.12. Creating Service Table
3.13. tmapm
4. Starting Up and Shutting Down
4.1. Starting Up Tmax
4.1.1. racd
4.1.2. tmboot
4.2. Shutting Down Tmax
4.2.1. tmdown
5. Tmax Management
5.1. Overview
5.2. tmadmin
5.3. Configuration Information Commands
5.3.1. tmaxinfo(ti)
5.3.2. history
5.3.3. config(cfg)
5.3.4. configopt(cfgopt)
5.4. Status Information Commands
5.4.1. stat(st)
5.4.2. gwinfo
5.4.3. txgwinfo / nontxgwinfo
5.4.4. jgwinfo / ajgwinfo
5.4.5. wsgwinfo
5.4.6. smtrc
5.4.7. clhsinfo
5.4.8. tmmsinfo
5.4.9. repeat(r)
5.4.10. clientinfo(ci)
5.4.11. svrinfo(si)
5.4.12. txquery(txq)
5.4.13. rqstat(rqs)
5.5. Administrative Commands
5.5.1. suspend(sp)
5.5.2. resume(rs)
5.5.3. Advertise/Unadvertise
5.5.4. restat
5.5.5. rebootsvr(rbs)
5.5.6. cfgadd(ca)
5.5.7. set
5.5.8. setopt
5.5.9. qpurge(qp)
5.5.10. discon(ds)
5.5.11. logstart / logend
5.5.12. chtrc
5.5.13. chlog
5.5.14. txcommit / txrollback
5.5.15. wsgwreload
5.5.16. restart
5.5.17. notify_reconnect_clh
6. IPv6 Configuration
6.1. Overview
6.1.1. IPv6
6.1.2. IPv6 Conversion Technologies
6.2. Tmax IPv6
6.2.1. IPv6 Supported Features
6.2.2. Additional Features
A. CLOPT Options for Gateway
A.1. Tmax
A.1.1. Transaction Domain Gateway
A.1.2. Non Transaction Domain Gateway
A.2. Java
A.2.1. JEUS Gateway
A.2.2. JEUS Async Gateway
A.3. Tuxedo
A.3.1. Tuxedo Gateway
A.3.2. Tuxedo Async Gateway
B. Notes on Using Tmax
B.1. Using multiple CLHs
B.1.1. ASQCOUNT
B.1.2. Concurrent Scheduling
B.2. Domain Gateway COUSIN Setting
B.2.1. SVRGROUP
B.2.2. GATEWAY
B.3. Intelligent Routing of Domain Gateway
B.3.1. Existing Domain Gateway Routing
B.3.2. New Domain Gateway Routing
B.3.3. Gateway that Supports Intelligent Routing Function
B.4. Version-specific FD Calculation
Index

List of Figures

[Figure 1.1] Features of Tmax
[Figure 1.2] Tmax Engine Architecture
[Figure 1.3] Passing a Request between Two Nodes
[Figure 1.4] Tmax System Architecture
[Figure 3.1] Relationships between the Elements of Tmax System
[Figure 3.2] MINCLH = 2
[Figure 3.3] TRB
[Figure 3.4] If LOAD is Set to -1
[Figure 3.5] If LOAD is Set to -2
[Figure 3.6] If LOAD > 0
[Figure 3.7] Relationships between TMS, server groups, and databases
[Figure 3.8] Distributed Transaction Architecture
[Figure 3.9] Two-Phase Commit
[Figure 3.10] System Load Management
[Figure B.1] Existing Domain Gateway Routing
[Figure B.2] New Domain Gateway Routing (1)
[Figure B.3] New Domain Gateway Routing (2)