OpenTP1 Version 7 Programming Guide

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

8.2.3 Tasks for using OpenTP1 (when using a stub)

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 pathname 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 and user server 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 basespp <CR>

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

% dcsvstart -u basesup <CR>

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

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

The server UAP (SPP) can also be started 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 base_mkfs command, an OpenTP1 file system creation tool, is executed, an OpenTP1 file system is created under the $DCDIR/examples/base/betranfile file. The table below lists the files contained in the created OpenTP1 file system.

Table 8-2 List of files in OpenTP1 file system (Base sample)

File name Purpose Record length# Number of records
jn101 System journal file 4096 bytes 50
jn102 System journal file 4096 bytes 50
jn103 System journal file 4096 bytes 50
stsfi101 Status file 4608 bytes 50
stsfi102 Status file 4608 bytes 50
stsfi103 Status file 4608 bytes 50
stsfi104 Status file 4608 bytes 50
cpdf01 Checkpoint dump file 4096 bytes 256
cpdf02 Checkpoint dump file 4096 bytes 256
cpdf03 Checkpoint dump file 4096 bytes 256

#
This record length is a default value.

(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 by following the procedure in 8.2 How to use Base sample.
  4. Execute the UAP.