OpenTP1 Version 7




Summary of amendments

1. Introduction
1.1 Overview of OpenTP1
1.1.1 Distributed computing environment for transaction processing
1.1.2 Flexible system configuration
1.1.3 Achieving a large-scale system linked to a backbone system
1.1.4 Support for moving to open systems
1.1.5 Unrestricted
1.2 Examples of configurations possible with OpenTP1 systems
1.2.1 OpenTP1 in a LAN that uses client/server processing
1.2.2 OpenTP1 in front-end processors
1.2.3 OpenTP1 connected to a non-OpenTP1 system
1.3 OpenTP1 software products
1.3.1 List of OpenTP1 software products
1.3.2 OpenTP1 and the X/Open DTP model
1.4 OpenTP1 system services
1.4.1 Types of OpenTP1 services
1.4.2 OpenTP1 system services
1.4.3 OpenTP1 system definitions

2. Application Processing Modes
2.1 Overview of OpenTP1 communications
2.2 Processing in a client/server configuration
2.2.1 Communication via remote procedure calls
2.2.2 Using OpenTP1 client software on workstations and PCs
2.3 Processing in an MCF message-exchange configuration
2.3.1 Overview of MCF message exchange
2.3.2 Networks that can use MCF message exchange
2.3.3 MCF message-exchange configuration using the Extended Presentation facility
2.4 Processing in an MQA message-queuing configuration
2.4.1 Features of MQA message queuing
2.4.2 Overview of communication using MQA message queuing
2.4.3 Notes on use of the MQA message queuing
2.5 Other Hitachi software products usable with OpenTP1
2.5.1 Job Management Partner 1 Integrated System Operation Management Facilities
2.5.2 SEWB3 Software Engineering Workbench
2.6 User application programs in OpenTP1 systems
2.6.1 User application programs and types of processing
2.6.2 Overview of user application programs
2.6.3 Cooperation of user processes with SPPs and MHPs
2.6.4 UAP testing and debugging facilities
2.7 Processing in an Internet-based configuration

3. Functions
3.1 Transaction Control
3.1.1 Distributed transactions
3.1.2 RPCs, transaction branches, and global transactions
3.1.3 Commit and rollback operations
3.1.4 Two-phase commit
3.1.5 Transactions and UAPs
3.1.6 Transaction control based on the TX interface
3.1.7 Transaction control based on the XA resource service
3.1.8 XA interface
3.2 Processing in an OpenTP1 client/server configuration
3.2.1 Communication via RPCs that use the OpenTP1 library
3.2.2 Optional function for service information searches
3.2.3 Node management in OpenTP1
3.2.4 Communication via RPCs that use the XATMI interface
3.2.5 Communication via RPCs that use the TxRPC interface
3.3 Message Control
3.3.1 Overview of sending and receiving messages using MCF
3.3.2 Message structure
3.3.3 Application program structure and application name
3.3.4 Synchronous and asynchronous communication functions, and messages
3.3.5 Messages independent of the above communication modes
3.3.6 Message-control transactions
3.3.7 Starting user application programs
3.3.8 MCF message queues and the sending and receiving of messages
3.3.9 Message exchange by user application programs
3.3.10 Order of sending MCF messages
3.3.11 Partially changing the MCF communication service during operation of OpenTP1
3.3.12 MCF capabilities that are not supported in Windows
3.4 Scheduling
3.4.1 Scheduling requests to service-providing programs
3.4.2 Scheduling MCF messages to message-handling programs
3.4.3 Process control and the Multiserver facility
3.4.4 Saving shared memory in sharing a buffer area
3.4.5 Example of process control with the Multiserver facility
3.5 OpenTP1 client facility (TP1/Client)
3.5.1 Remote procedure calls of TP1/Client
3.5.2 MCF message exchange using the TCP/IP protocol
3.5.3 Communication with XDM/DCCM3
3.6 Client/server communications using OSI TP
3.6.1 OpenTP1's remote system
3.6.2 Route used for communication
3.6.3 Application programs used for communication
3.6.4 Overview of environment setup
3.6.5 In the event of a failure
3.7 Remote API facility
3.7.1 Example of using the remote API facility
3.7.2 Permanent connection
3.7.3 Connection mode
3.7.4 RAP-processing client manager
3.7.5 Definitions necessary for using the remote API facility
3.7.6 Prerequisites for using the XA resource service
3.8 Dynamic loading of service functions
3.8.1 Examples of using dynamic loading of service functions
3.8.2 Preparation required for using dynamic loading of service functions
3.9 Additional Features
3.9.1 Locking resources
3.9.2 Acquisition of a user journal
3.9.3 Journal maintenance facilities
3.9.4 Obtaining the message log
3.9.5 Reporting a message log
3.9.6 Controlling resource managers not provided by OpenTP1
3.9.7 Uptime statistics
3.9.8 Real-time statistics service
3.10 System operations using scenario templates
3.11 System monitoring using audit logs

4. File System
4.1 The OpenTP1 file system
4.1.1 Overview of the OpenTP1 file system
4.1.2 Creating an OpenTP1 file system
4.1.3 Backing up and restoring OpenTP1 file systems
4.1.4 Protecting OpenTP1 files
4.1.5 Assigning an OpenTP1 file system
4.2 System files
4.2.1 System files: status files
4.2.2 System files: system journal files
4.2.3 System files: checkpoint dump files
4.2.4 System files: transaction recovery journal file
4.2.5 System files: server recovery journal file
4.2.6 System files: archive journal files
4.3 Queue files
4.3.1 Queue files: MCF message queue file
4.3.2 Queue files: MQA message queue file
4.4 User data files
4.4.1 User files: DAM files (TP1/FS/Direct Access)
4.4.2 User files: TAM files (TP1/FS/Table Access)
4.4.3 IST service (TP1/Shared Table Access)
4.4.4 User files: ISAM files (ISAM and ISAM/B)
4.4.5 Accessing database management systems

5. Overview of Setup, Use, and Error Recovery
5.1 Setting up an OpenTP1 system
5.1.1 Overview of environment settings
5.1.2 Environment setup tasks
5.2 Operating an OpenTP1 system
5.3 Failure and error recovery
5.3.1 Recovering from OpenTP1 system failures
5.3.2 Recovering from UAP failures
5.3.3 Recovering from file errors
5.3.4 Recovering from network errors
5.3.5 OpenTP1 monitoring and trace facilities
5.3.6 Analyzing the cause of an error

6. Using Multiple Instances of OpenTP1
6.1 The System Switchover facility
6.1.1 Overview of the System Switchover facility
6.1.2 OpenTP1 system configuration for using the System Switchover facility
6.1.3 Procedure for system switching
6.1.4 Operating with the System Switchover facility
6.2 The Multinode facility
6.2.1 Overview of the Multinode facility
6.2.2 Available operations in the Multinode facility
6.2.3 Global Archive Journal facility
6.3 The MultiOpenTP1
6.3.1 MultiOpenTP1 configuration
6.4 Multi-homed host configuration

7. System Resources
7.1 OpenTP1 process structure
7.2 OpenTP1 memory structure
7.2.1 Local memory
7.2.2 Shared memory
7.3 TCP/IP resources that OpenTP1 uses
7.3.1 Port numbers used in OpenTP1
7.3.2 How RPCs use ports
7.3.3 Calculating the number of ports
7.3.4 Restricting the number of ports
7.3.5 Temporary closing and user tasks
7.3.6 Monitoring a temporary closing request
7.3.7 Checking an execution status of temporary closing
7.3.8 Changes in the size of a resource when the number of sockets increases
7.3.9 Tuning the network environment
7.3.10 Cautions required when using DNS and NIS

A. Communication Protocol Products for Use with TP1/Message Control
A.1 OpenTP1 communication protocol products
A.2 Systems connected to protocol products
B. Library Functions and Commands
C. Version Changes
C.1 Changes in 07-03
C.2 Changes in 07-02
C.3 Changes in 07-01
C.4 Changes in 07-00
D. Overview of Remote Procedure Call Processing
D.1 Overview of processing a remote procedure call to the local node
D.2 Overview of processing a remote procedure call to remote nodes
D.3 Overview of global search processing
D.4 Overview of service information registration and deletion processing
D.5 Overview of node-to-node forwarding processing
D.6 Overview of remote procedure call processing using the dcsvgdef definition command
E. Glossary