For Windows Systems

OpenTP1 Version 7

User's Guide

3000-3-D64(E)


Contents

Notices
Preface

1. Positioning of This Manual
1.1 Relationship to other OpenTP1 series manuals
1.2 How to use this manual

2. Description of Functions
2.1 List of functions
2.2 Functions for checking standard output and standard error
2.2.1 Standard output redirect facility
2.2.2 Console output facility for standard output redirect files
2.2.3 OpenTP1 console output facility
2.2.4 Relationships among system definitions
2.3 Permission control facility

3. Programming
3.1 List of code-level functions
3.2 Compiling and linking UAPs
3.2.1 Creating UAPs in C language
3.2.2 Creating UAPs for Visual Studio projects
3.2.3 Creating UAPs in COBOL2002
3.2.4 Creating UAPs by using Net Express
3.3 Programming notes specific to OpenTP1 for Windows
3.4 Sample programs
3.5 Handling of UAP shared libraries when using dynamic loading of service functions

4. Environment Setup
4.1 Environment setup procedure
4.2 Registering the OpenTP1 administrator
4.3 Creating OpenTP1 system definition information
4.3.1 Creating definition files
4.3.2 Changing definitions
4.3.3 Setting the runtime library path
4.4 Environment variable settings
4.5 Configuring an OpenTP1 file system
4.5.1 OpenTP1 file system
4.5.2 Configuring the OpenTP1 file system by applying the raw I/O facility
4.6 Settings for linking databases
4.6.1 Linking with HiRDB
4.6.2 Linking with Oracle
4.6.3 Linking with SQL Server
4.7 OS settings
4.8 MultiOpenTP1 settings

5. System Definitions
5.1 Lists of system definitions
5.2 Format of system definition explanations
definition-name (definition-command)
5.3 Details of system definitions
System environment definition
System common definition
Process service definition (prcsvpath)
Journal service definition
Client service definition
RAP-processing listener service definition
User service default definition
User service definition
Definition of system service information

6. Operations
6.1 Overview of OpenTP1 for Windows operations
6.2 Starting OpenTP1
6.2.1 Starting OpenTP1 from the Windows Services dialog box
6.2.2 Starting OpenTP1 with a command
6.2.3 Starting OpenTP1 with the GUI
6.2.4 Determining the startup mode
6.3 Terminating OpenTP1
6.3.1 Terminating OpenTP1 from the Windows Services dialog box
6.3.2 Terminating OpenTP1 with a command
6.3.3 Terminating OpenTP1 with the GUI
6.3.4 Notes about OpenTP1 termination
6.4 MultiOpenTP1 operations
6.5 System operations using scenario templates
6.5.1 Registering scenarios
6.5.2 Scale-out operation
6.5.3 Using scenario templates
6.5.4 Details of scenario templates
6.6 Troubleshooting
6.6.1 Error events and causes
6.6.2 Action to be taken in the event of an application exception
6.6.3 Action to be taken in the event of a shortage of ports (tuning the number of TCP/IP ports)
6.6.4 Using the information acquired in the event of a failure
6.7 GUI provided by OpenTP1 for Windows
6.7.1 GUI for environment setup
6.7.2 GUI for starting and terminating OpenTP1

7. Operation Commands
List of operation commands
Format of command explanations
Details of commands common to OpenTP1 for Windows and OpenTP1 for UNIX
dcpplist (displays product information)
dcrasget (acquires maintenance data)
fills (displays the contents of the OpenTP1 file system)
jnlcolc (collects journals required for file recovery)
jnlcopy (copies unload journal files)
jnledit (edits and outputs unload journal files or global archive unload journal files)
jnlmcst (outputs MCF statistics)
jnlrput (outputs records from unload journal files or global archive unload journal files)
jnlsort (sorts and merges unload journal files and global archive unload journal files in time order)
jnlstts (outputs statistical information)
jnlunlfg (unloads journal files)
rpcdump (outputs RPC trace information)
rpcmrg (merges RPC trace information)
trnlnkrm (registers resource managers)
trnmkobj (creates a transaction control object file)
Details of the commands specific to OpenTP1 for Windows
dcdls (checks the setup status of multiOpenTP1s)
dcmakecon (creates a multiOpenTP1 console)
dcsetupml (sets up a multiOpenTP1 or cancels setup of a multiOpenTP1)
njsmkdll (creates a transaction control DLL)
ntbstart (starts OpenTP1)
ntbtail (outputs the contents of a specified file to the console)
tp1console (outputs the standard output redirect file to the console)

Appendix
A. Lists of OpenTP1 Processes

Index