OpenTP1 Version 7 Description

[Contents][Glossary][Index][Back][Next]

Preface

This manual provides a general overview of the OpenTP1 software product.

Products described in this manual, other than those for which the manual is released, may not work with OpenTP1 Version 7 products. You need to confirm that the products you want to use work with OpenTP1 Version 7 products.

TP1/Message Queue is implemented based on the specifications of the MQI, MQFAP, and MQ clusters in WebSphere MQ (formerly MQSeries) under license from International Business Machines Corporation.

Intended readers

This manual is intended as a general overview that can be used by the following types of readers:

Organization of this manual

This manual is organized into the following chapters and appendixes:

1. Introduction
This chapter provides a general overview of OpenTP1 and online transaction processing.

2. Application Processing Modes
This chapter describes the modes of application processing that can be performed in OpenTP1, related products, and the types of user application programs used in an OpenTP1 system.

3. Functions
This chapter describes the service functions provided by OpenTP1.

4. File System
This chapter describes the OpenTP1 file system, files (such as OpenTP1 files and user files), and the IST service.

5. Overview of Setup, Use, and Error Recovery
This chapter describes the actions taken by OpenTP1 or users when setting up or using OpenTP1, or when recovering from some failure or error.

6. Using Multiple Instances of OpenTP1
This chapter describes the OpenTP1 features that can be used when constructing systems that require multiple instances of OpenTP1.

7. System Resources
This appendix describes OpenTP1 process structure and memory structure.

A. Communication Protocol Products for Use with TP1/Message Control
This appendix describes the OpenTP1 program products that support specific communication protocols, required for communication based on message exchange.

B. Library Functions and Commands
This appendix lists and describes the library functions and commands available in OpenTP1.

C. Version Changes
This appendix describes the changes in definitions, functions, and commands between OpenTP1 versions.

D. Overview of Remote Procedure Call Processing
This appendix provides an overview of remote procedure call processing.

E. Glossary
The glossary defines terms and phrases used in this manual.

Related publications

This manual is part of a related set of manuals. The manuals in the set are listed below (with the manual numbers):

OpenTP1 products

Other OpenTP1 products

Other related products

For OpenTP1 protocol manuals, please check whether English versions are available.

#
If you want to use this manual, confirm that it has been published. (Some of these manuals might not have been published yet.)

Conventions: Abbreviations for product names

This manual uses the following abbreviations for product names:

Abbreviation Full name or meaning
AIX AIX 5L V5.1
AIX 5L V5.2
AIX 5L V5.3
AIX V6.1
Client .NET TP1/Client for .NET Framework uCosminexus TP1/Client for .NET Framework
Connector .NET TP1/Connector for .NET Framework uCosminexus TP1/Connector for .NET Framework
DPM JP1/ServerConductor/Deployment Manager
HI-UX/WE2 HI-UX/workstation Extended Version 2
HP-UX HP-UX (IPF) HP-UX 11i V2 (IPF)
HP-UX 11i V3 (IPF)
HP-UX (PA-RISC) HP-UX 11i V1 (PA-RISC)
HP-UX 11i V2 (PA-RISC)
IPF Itanium(R) Processor Family
Java JavaTM
JP1 JP1/AJS2 JP1/AJS2 - Agent JP1/Automatic Job Management System 2 - Agent
JP1/AJS2 - Manager JP1/Automatic Job Management System 2 - Manager
JP1/AJS2 - View JP1/Automatic Job Management System 2 - View
JP1/AJS2 - Scenario Operation JP1/AJS2 - Scenario Operation Manager JP1/Automatic Job Management System 2 - Scenario Operation Manager
JP1/AJS2 - Scenario Operation View JP1/Automatic Job Management System 2 - Scenario Operation View
JP1/NETM/Audit JP1/NETM/Audit - Manager
Linux Linux(R)
Linux (AMD64/Intel EM64T/x86) Red Hat Enterprise Linux AS 4 (AMD64 & Intel EM64T)
Red Hat Enterprise Linux AS 4 (x86)
Red Hat Enterprise Linux ES 4 (AMD64 & Intel EM64T)
Red Hat Enterprise Linux ES 4 (x86)
Red Hat Enterprise Linux 5 (AMD/Intel 64)
Red Hat Enterprise Linux 5 (x86)
Red Hat Enterprise Linux 5 Advanced Platform (AMD/Intel 64)
Red Hat Enterprise Linux 5 Advanced Platform (x86)
Linux (IPF) Red Hat Enterprise Linux AS 4 (IPF)
Red Hat Enterprise Linux 5 (Intel Itanium)
Red Hat Enterprise Linux 5 Advanced Platform (Intel Itanium)
MS-DOS Microsoft(R) MS-DOS(R)
NETM/DM JP1/NETM/DM Client
JP1/NETM/DM Manager
JP1/NETM/DM SubManager
Oracle Oracle 10g
Oracle9i
Solaris Solaris 8
Solaris 9
Solaris 10
TP1/Client TP1/Client/J uCosminexus TP1/Client/J
TP1/Client/P uCosminexus TP1/Client/P
TP1/Client/W uCosminexus TP1/Client/W
uCosminexus TP1/Client/W(64)
TP1/EE uCosminexus TP1/Server Base Enterprise Option
uCosminexus TP1/Server Base Enterprise Option(64)
TP1/Extension 1 uCosminexus TP1/Extension 1
uCosminexus TP1/Extension 1(64)
TP1/FS/Direct Access uCosminexus TP1/FS/Direct Access
uCosminexus TP1/FS/Direct Access(64)
TP1/FS/Table Access uCosminexus TP1/FS/Table Access
uCosminexus TP1/FS/Table Access(64)
TP1/High Availability uCosminexus TP1/High Availability
uCosminexus TP1/High Availability(64)
TP1/LiNK uCosminexus TP1/LiNK
TP1/Message Control uCosminexus TP1/Message Control
uCosminexus TP1/Message Control(64)
TP1/Message Control/Tester uCosminexus TP1/Message Control/Tester
TP1/Message Queue uCosminexus TP1/Message Queue
uCosminexus TP1/Message Queue(64)
TP1/Message Queue - Access uCosminexus TP1/Message Queue - Access
uCosminexus TP1/Message Queue - Access(64)
TP1/Messaging uCosminexus TP1/Messaging
TP1/Multi uCosminexus TP1/Multi
TP1/NET/HDLC uCosminexus TP1/NET/HDLC
TP1/NET/High Availability uCosminexus TP1/NET/High Availability
uCosminexus TP1/NET/High Availability(64)
TP1/NET/HSC uCosminexus TP1/NET/HSC
TP1/NET/Library uCosminexus TP1/NET/Library
uCosminexus TP1/NET/Library(64)
TP1/NET/NCSB uCosminexus TP1/NET/NCSB
TP1/NET/OSAS-NIF uCosminexus TP1/NET/OSAS-NIF
TP1/NET/OSI-TP uCosminexus TP1/NET/OSI-TP
TP1/NET/SLU - TypeP2 TP1/NET/Secondary Logical Unit - TypeP2 uCosminexus TP1/NET/Secondary Logical Unit - TypeP2
TP1/NET/TCP/IP uCosminexus TP1/NET/TCP/IP
uCosminexus TP1/NET/TCP/IP(64)
TP1/NET/UDP uCosminexus TP1/NET/User Datagram Protocol
TP1/NET/User Agent uCosminexus TP1/NET/User Agent
TP1/NET/X25 uCosminexus TP1/NET/X25
TP1/NET/X25-Extended uCosminexus TP1/NET/X25-Extended
TP1/NET/XMAP3 uCosminexus TP1/NET/XMAP3
TP1/Offline Tester uCosminexus TP1/Offline Tester
TP1/Online Tester uCosminexus TP1/Online Tester
TP1/Resource Manager Monitor uCosminexus TP1/Resource Manager Monitor
TP1/Server Base uCosminexus TP1/Server Base
uCosminexus TP1/Server Base(64)
TP1/Shared Table Access uCosminexus TP1/Shared Table Access
TP1/Web uCosminexus TP1/Web
Windows 2000 Microsoft(R) Windows(R) 2000 Advanced Server Operating System
Microsoft(R) Windows(R) 2000 Datacenter Server Operating System
Microsoft(R) Windows(R) 2000 Professional Operating System
Microsoft(R) Windows(R) 2000 Server Operating System
Windows Server 2003 Microsoft(R) Windows Server(R) 2003, Datacenter Edition
Microsoft(R) Windows Server(R) 2003, Enterprise Edition
Microsoft(R) Windows Server(R) 2003, Standard Edition
Windows Server 2003 R2 Microsoft(R) Windows Server(R) 2003 R2, Enterprise Edition
Microsoft(R) Windows Server(R) 2003 R2, Standard Edition
Windows Server 2003 x64 Editions Microsoft(R) Windows Server(R) 2003, Datacenter x64 Edition
Microsoft(R) Windows Server(R) 2003, Enterprise x64 Edition
Microsoft(R) Windows Server(R) 2003, Standard x64 Edition
Windows Server 2003 R2 x64 Editions Microsoft(R) Windows Server(R) 2003 R2, Enterprise x64 Edition
Microsoft(R) Windows Server(R) 2003 R2, Standard x64 Edition
Windows Server 2008 Microsoft(R) Windows Server(R) 2008 Datacenter (x86)
Microsoft(R) Windows Server(R) 2008 Enterprise (x86)
Microsoft(R) Windows Server(R) 2008 Standard (x86)
Windows Server 2008 x64 Editions Microsoft(R) Windows Server(R) 2008 Datacenter (x64)
Microsoft(R) Windows Server(R) 2008 Enterprise (x64)
Microsoft(R) Windows Server(R) 2008 Standard (x64)
Windows Vista Microsoft(R) Windows Vista(R) Business (x86)
Microsoft(R) Windows Vista(R) Enterprise (x86)
Microsoft(R) Windows Vista(R) Ultimate (x86)
Windows Vista x64 Editions Microsoft(R) Windows Vista(R) Business (x64)
Microsoft(R) Windows Vista(R) Enterprise (x64)
Microsoft(R) Windows Vista(R) Ultimate (x64)
Windows XP Microsoft(R) Windows(R) XP Professional Operating System

Conventions: Acronyms

This manual also uses the following acronyms:

Acronym Full name or meaning
ANSI American National Standards Institute
AP Application Program
API Application Programming Interface
C/S Client/Server
CGI Common Gateway Interface
CPU Central Processing Unit
CRM Communication Resource Manager
CUP Client User Program
DAM Direct Access Method
DB Database
DBMS Database Management System
DCE Distributed Computing Environment
DHCP Dynamic Host Configuration Protocol
DID Distributed Identifier
DML Data Manipulation Language
DNS Domain Name System
DPM ServerConductor/DeploymentManager
DPOS Distributed Data Processing Operating System
DTP Distributed Transaction Processing
EX Exclusive
FDDI Fiber Distributed Data Interface
FEP Front End Processor
FIFO First-In-First-Out
FRC File Recovery
GUI Graphical User Interface
HA High Availability
HDLC-NRM HDLC-Normal Response Mode
HTML Hyper Text Markup Language
I/O Input/Output
ID Identifier
IDL Interface Definition Language
IP Internet Protocol
ISAM Indexed Sequential Access Method
IST Internode Shared Table
J2EE Java 2 Enterprise Edition
JCA J2EE Connector Architecture
JDBC Java DataBase Connectivity
LAN Local Area Network
MCF Message Control Facility
MHP Message Handling Program
MIA Multivendor Integration Architecture
MQA Message Queue Access
MQI Message Queue Interface
MSDTC Microsoft Distributed Transaction Coordinator
NIF/HNA Network Interface Feature/Hitachi Network Architecture
NIF/OSI Network Interface Feature/OSI
NIS Network Information Service
OLTP Online Transaction Processing
OS Operating System
OSI Open Systems Interconnection
OSI TP Open Systems Interconnection Transaction Processing
PC Personal Computer
PR Protected Retrieve
PRF Performance
PVC Permanent Virtual Circuit
RI Recovery Information
RM Resource Manager
RPC Remote Procedure Call
RTS Real Time Statistic
SCSI Small Computer Systems Interface
SNA Systems Network Architecture
SPP Service Providing Program
SRF Server Recovery Journal File
STDL Structured Transaction Definition Language
SUP Service Using Program
TAM Table Access Method
TCO Total Cost of Ownership
TCP/IP Transmission Control Protocol/Internet Protocol
TP Transaction Processing
TRF Transaction Recovery journal File
UAP User Application Program
UOC User Own Coding
VM Virtual Machine
WAN Wide Area Network
WS Workstation
WWW World Wide Web
XA Extended Architecture
XAR Extended Architecture Resource

Conventions: Diagrams

This manual uses the following conventions in diagrams:

[Figure]

Conventions: Differences in installation directory paths

This manual uses the notation /BeTRAN to indicate the OpenTP1 installation directory. The actual installation directory differs depending on the operating system. Use the following table to determine the actual installation directory for your OS.

As written in this manual Actual directory for each OS
AIX, HP-UX, and Solaris Linux Windows
/BeTRAN /BeTRAN /opt/OpenTP1 The directory in which OpenTP1 was installed

Conventions: Fonts and symbols

The following table explains the fonts used in this manual:

Font Convention
Bold Bold type indicates text on a window, other than the window title. Such text includes menus, menu options, buttons, radio box options, or explanatory labels. For example:
  • From the File menu, choose Open.
  • Click the Cancel button.
  • In the Enter name entry box, type your name.
Italics Italics are used to indicate a placeholder for some actual text to be provided by the user or system. For example:
  • Write the command as follows:
    copy source-file target-file
  • The following message appears:
    A file was not found. (file = file-name)
Italics are also used for emphasis. For example:
  • Do not delete the configuration file.
Code font A code font indicates text that the user enters without change, or text (such as messages) output by the system. For example:
  • At the prompt, enter dir.
  • Use the send command to send mail.
  • The following message is displayed:
    The password is incorrect.

The following table explains the symbols used in this manual:

Symbol Convention
| In syntax explanations, a vertical bar separates multiple items, and has the meaning of OR. For example:
A|B|C means A, or B, or C.
{ } In syntax explanations, curly brackets indicate that only one of the enclosed items is to be selected. For example:
{A|B|C} means only one of A, or B, or C.
[ ] In syntax explanations, square brackets indicate that the enclosed item or items are optional. For example:
[A] means that you can specify A or nothing.
[B|C] means that you can specify B, or C, or nothing.
... In coding, an ellipsis (...) indicates that one or more lines of coding are not shown for purposes of brevity.
In syntax explanations, an ellipsis indicates that the immediately preceding item can be repeated as many times as necessary. For example:
A, B, B, ... means that, after you specify A, B, you can specify B as many times as necessary.

Conventions: KB, MB, GB, and TB

This manual uses the following conventions:

Conventions: Platform-specific notational differences

For the Windows version of OpenTP1, there are some notational differences from the description in the manual. The following table describes these differences.

Item Description in the manual Change to:
Environment variable $aaaaaa
Example: $DCDIR
%aaaaaa%
Example: %DCDIR%
Path name separator Colon (:) Semicolon (;)
Directory name separator Slash (/) Backslash (\)
Absolute path name A path from the root directory
Example: /tmp
A path name from a drive letter and the root directory
Example: C:\tmp
Executable file name File name only (without an extension)
Example: mcfmngrd
File name with an extension
Example: mcfmngrd.exe
make command make nmake

Conventions: Version numbers

The version numbers of Hitachi program products are usually written as two sets of two digits each, separated by a hyphen. For example:

The version number might be shown on the spine of a manual as Ver. 2.00, but the same version number would be written in the program as 02-00.