OpenTP1 Version 7 Programming Guide

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

8.2.5 Tasks for using OpenTP1 (when using dynamic loading of service functions)

After modifying the system definition, begin the tasks required for using OpenTP1.

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

(1) Setting up OpenTP1

Set up OpenTP1 by executing the dcsetup command. The dcsetup command is located in the /BeTRAN/bin/ directory.

A command input example is given below:

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

The setup task must be performed by an OpenTP1 system administrator. Specify the dcsetup command as an absolute path only when using the sample for the first time. You do not need to specify the absolute path for the dcsetup command the next time you set up the sample. For details on the dcsetup command, see the manual OpenTP1 Operation.

(2) Activating the OpenTP1 system and user servers

The procedure for activating the OpenTP1 system and user servers is given below.

(a) Start the OpenTP1 system

Start the OpenTP1 system by 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. Start the server UAP (SPP) first, and then the client UAP (SUP).

A command input example is given below:

% dcsvstart -u basespp2 <CR>

A message log is output to indicate that basespp2 is online.

% dcsvstart -u basesup2 <CR>

A message log is output to indicate that basesup2 is online.

The processing activity of the user servers (UAPs) is output to the message log.

The server UAP (SPP) can also be set to start automatically when the OpenTP1 system starts by making the appropriate setting in the user service configuration definition.

(3) List of files in the OpenTP1 file system

When you execute the base_mkfs command to create the OpenTP1 file system, the 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-4 List of files in the OpenTP1 file system (Base sample)

File name Purpose Record length# Number of records
jnl01 System journal file 4096 bytes 50
jnl02 System journal file 4096 bytes 50
jnl03 System journal file 4096 bytes 50
stsfil01 Status file 4608 bytes 50
stsfil02 Status file 4608 bytes 50
stsfil03 Status file 4608 bytes 50
stsfil04 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

#
These record lengths are default values.

(4) Replacing a sample UAP

To replace a sample UAP:

  1. Shut down the OpenTP1 system.
  2. Execute the dcsetup command with the -d option specified to temporarily remove OpenTP1 from the OS.
  3. Specify the new sample UAP that you want to use by following the procedure in 8.2 How to use Base sample.
  4. Execute the UAP.