OpenTP1 Version 7

System Definition

3000-3-D52-30(E)


Contents

Notices
Summary of amendments
Preface

1. Overview
1.1 Definition set
1.2 Composition of definitions
1.2.1 Composition of system service definitions
1.2.2 Composition of network communication definitions
1.2.3 Composition of message queue definitions
1.2.4 Composition of network library definitions
1.3 Procedures to create definitions
1.4 Definition rules
1.4.1 Basic items
1.4.2 Notational formats
1.4.3 Explanation of symbols

2. Overview of the System Service Definitions
2.1 Overview
2.1.1 System service definitions and file names
2.2 Types of definitions

3. System Service Definitions
System environment definition
System service configuration definition
dcsvstart (start system service)
User service configuration definition
dcsvstart (start user server)
System common definition
dcbindht (Specify host name for OpenTP1 communication or for using system switchover facility)
Lock service definition
Timer service definition
Name service definition
Process service definition
prcsvpath (Specify user server path)
Schedule service definition
scdbufgrp (Specify message-storing buffer pool to be shared)
scdmulti (Specify information about multi-scheduler daemons)
Transaction service definition
trnstring (Specify character string or extension for access to resource manager)
XA resource service definition
xarfile (Specify XAR file)
Interval service definition
Status service definition
Journal service definition
jnldfsv (Specify journal related files)
System journal service definition
jnladdfg (Define system journal file group name and attributes)
jnladdpf (Define physical files making up system journal file group)
Checkpoint dump service definition
jnladdfg (Define checkpoint dump file group name and attributes)
jnladdpf (Define physical files making up checkpoint dump file group)
Log service definition
Multinode configuration definition
dcmarea (Specify multinode area or subarea node identifier)
Multinode physical definition
dcprcport (Specify the host name and port number of a host in a multinode configuration)
Global archive journal service definition
jnldfsv (Specify the names of resource groups for the global archive journal service)
Archive journal service definition
jnladdfg (Define archive journal file group name and attributes)
jnladdpf (Define archive journal physical file)
DAM service definition
damcache (Specify the boundary for reusing cache blocks)
damchlmt (Specify a threshold for the number of cache blocks)
damfile (Specify logical file)
TAM service definition
tamtable (Specify TAM table attribute)
Client service definition
IST service definition
istdef (table name definition of IST service)
RMM service definition
Monitored RM definition
Extended RM registration definition
trnlnkrm (Register resource managers provided by other than OpenTP1)
XATMI communication service definition
xatsrvadd (Specify names of services provided by the remote system)
Message queue service definition
quegrp (Specify message queue file)
User service network definition
dcsvgdef (Specify the service information of the destination)
RAP-processing listener service definition
RAP-processing client manager service definition
Performance verification trace definition
XAR performance verification trace definition
JNL performance verification trace definition
LCK performance verification trace definition
TRN event trace definition
Real-time statistics service definition
rtsput (Specify the statistics acquisition service)
Real-time statistics acquisition-item definition
User service default definition
trnrmid (Specify resource manager extension)
scdbufgrp (Specify schedule buffer group)
scdmulti (Specify multi-scheduler facility)
scdsvcdef (Specify operation of the schedule service on a service basis)
User service definition
trnrmid (Specify resource manager extension)
scdbufgrp (Specify schedule buffer group)
scdmulti (Specify multi-scheduler facility)
scdsvcdef (Specify the schedule service operation on a service basis)
Specification of operands in user service definition for UAPs

4. Overview of the Network Communication Definitions
4.1 Overview
4.1.1 Network communication definitions and file names
4.1.2 Relationship of MCF services to definitions
4.1.3 Relation between MCF operation mode and definitions
4.1.4 Relationship between network communication definitions and system service definitions
4.1.5 Relationship between application names and service names
4.1.6 Network communication definition commands
4.2 Types of definitions
4.3 Creation of definition object file
4.3.1 mcfxxxx (MCF definition object creation utility startup commands)
4.3.2 mcflink (MCF definition linkage utility startup command)
4.3.3 mcfxxxx (MCF definition object analysis commands)

5. Network Communication Definitions
MCF manager definition
mcfmenv (MCF manager environment definition)
mcfmcomn (MCF manager common definition)
mcfmcname (Communication service definition)
mcfmuap (UAP common definition)
mcfmqgid (I/O queue definition)
mcfmexp (Extended reservation definition)
mcfmsts (Status inherit definition)
mcfmsmsg (Suppressing the output of log messages definition)
mcfmsvg (Service group attribute definition)
MCF communication configuration definition
mcftenv (MCF environment definition)
mcftcomn (MCF communication configuration common definition)
mcfttred (Maximum processing multiplicity definition)
mcfttim (Timer definition)
mcfttrc (Trace environment definition)
mcftsts (Status inherit definition)
mcftbuf (Buffer group definition)
mcftpsvr (Start application startup environment definition)
mcftalcle (Definition of a logical terminal for starting applications)
mcftped (End application startup environment definition)
MCF application definition
mcfaenv (Application environment definition)
mcfaalcap (Application attribute definition)
MCF performance verification trace definition
System service information definition
System service common information definition

6. Definitions of Multi-OpenTP1 System
6.1 Definition processing

7. Changing OpenTP1 System Definitions
7.1 Procedures
7.2 Definitions changeable at restart
7.3 Definitions affected by OpenTP1 system reconfiguration
7.3.1 When a user server is added
7.3.2 When the degree of parallelism for user servers is changed
7.3.3 When a node is added
7.3.4 When a journal file group is added
7.3.5 When a host name or IP address is changed

8. Definition Examples
8.1 Examples of defining an OpenTP1 system configuration
8.2 Examples of defining the real-time statistics items that are to be acquired

Appendixes
A. Relationship between UAPs and OpenTP1 System Environment
A.1 OpenTP1 definitions related to UAPs
A.2 Time monitoring for transactions
A.3 Time to wait for a service response
A.4 Applicable range of the maximum time interval in a permanent connection
A.5 Application program shutdown
B. Estimating Shared Memory Requirements
B.1 Estimating the shared memory requirements for TP1/Server Base
B.2 Estimating the shared memory requirements for the MCF service
C. Definition for Acquiring Audit Events
D. Details of Definition Checking
E. Notes on Migrating from Earlier Products
E.1 Migrating from Version 5 or Earlier

Index