OpenTP1 Version 7 Programming Guide

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

8.3.3 Work for using OpenTP1

After modifying the system definition, start with the work for using OpenTP1.

Organization of this subsection
(1) Setting up OpenTP1
(2) Activating the OpenTP1 system and user server
(3) List of files in OpenTP1 file system
(4) Exchanging a sample UAP

(1) Setting up OpenTP1

Setup an OpenTP1 using the dcsetup command. The dcsetup command is placed in the /BeTRAN/bin/ directory.

A command input example is given below:

% /BeTRAN/bin/dcsetup OpenTP1-home-directory-name <CR>

The OpenTP1 administrator is responsible for this work. Specify the full path name with the dcsetup command only when using the sample for the first time. It is unnecessary to execute the dcsetup command specifying the full pathname to setup the sample again. For details on the dcsetup command, see the manual OpenTP1 Operation.

(2) Activating the OpenTP1 system and user server

The procedure for activating the OpenTP1 system by using the created sample UAP and system definition for the sample is given below.

(a) Start the OpenTP1 system

Start the OpenTP1 system using the dcstart command.

A command input example is given below:

% dcstart <CR>
(b) Start user servers (UAPs)

Start the created UAPs using the dcsvstart command. First start the server UAP (SPP), then start the client UAP (SUP).

A command input example is given below:

% dcsvstart -u damspp <CR>

A message log is output to indicate that damspp becomes online.

% dcsvstart -u damsup <CR>

A message log is output to indicate that damsup becomes online.

How the user server process proceeds is indicated by the message log.

The server UAP (SPP) can also be activated automatically when the OpenTP1 system starts if so specified in the user service configuration definition.

(3) List of files in OpenTP1 file system

After the dam_mkfs command, an OpenTP1 file system creation tool, is executed, an OpenTP1 file system is created under the $DCDIR/examples/dam/betranfile/ directory. The table below lists the files contained in the created OpenTP1 file system.

Table 8-6 List of files in OpenTP1 file system (DAM sample)

File name Purpose Record length# Number of records
jn1f01 System journal file 4096 bytes 100
jn1f02 System journal file 4096 bytes 100
jn1f03 System journal file 4096 bytes 100
stsfi101 Status file 4608 bytes 64
stsfi102 Status file 4608 bytes 64
stsfi103 Status file 4608 bytes 64
stsfi104 Status file 4608 bytes 64
cpdf01 Checkpoint dump file 4096 bytes 100
cpdf02 Checkpoint dump file 4096 bytes 100
cpdf03 Checkpoint dump file 4096 bytes 100
smplfile DAM file 512 bytes# 11 blocks

#
This value indicates the DAM file block length.

(4) Exchanging a sample UAP

To exchange a sample UAP:

  1. Terminate the OpenTP1 system.
  2. Execute the dcsetup command with -d option to remove the OpenTP1 from the OS temporarily.
  3. Specify the desired sample UAP following the procedure in 8.3 How to use DAM sample.
  4. Execute the UAP.