OpenTP1 Version 7 Programming Guide

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

8.1.2 Sample program directory configuration

This section explains the files that are used with OpenTP1 samples. The figure below shows the directories containing OpenTP1 samples. $DCDIR is the OpenTP1 home directory.

Figure 8-1 Configuration of directories for storing samples

[Figure]

#1
$DCDIR is an environment variable indicating the OpenTP1 home directory. If you have copied the OpenTP1 samples to a directory other than the default OpenTP1 home directory, $DCDIR is the name of that directory. If not, the examples/ directory is placed under $DCDIR.

#2
betranfile is created when a sample command for tools is executed. betranfile does not exist at initial time.

#3
The directory for installation of OpenTP1 depends on the OS.
Organization of this subsection
(1) Contents of examples/ directory under $DCDIR
(2) Contents of rts_template/ directory under $DCDIR
(3) Contents of jp1_template/ directory under the installation directory

(1) Contents of examples/ directory under $DCDIR

The examples/ directory under $DCDIR contains the directory used with the sample. Files in the examples/ directory are listed below with a brief explanation.

base/
Directory that contains files for the Base sample

dam/
Directory that contains files for the DAM sample

tam/
Directory that contains files for the TAM sample

tools/
Directory that contains tools commonly used by all samples (tool directory)

mcf/
Directory that contains files for the message control facility (MCF) sample

COBOL/
Directory that contains COBOL language templates
(a) Contents of base/, dam/, and tam/ directories

Directories and files in the base/, dam/, and tam/ directories are listed below with a brief explanation.

aplib/
Directory that contains sample UAPs

c/
Directory that contains source files (in the C language) of UAPs in the sample

cobol/
Directory that contains source files (in the COBOL language) of UAPs in the sample

conf/
Directory that contains definition files of the sample

betranfile
OpenTP1 file system for the sample (the contents of this file are created by the tools in the tools/ directory)
(b) Contents of tools/ directory

Files in the tools/ directory are listed below with a brief explanation.

base_mkfs
Shell file that creates an OpenTP1 file system for the Base sample

dam_mkfs
Shell file that creates an OpenTP1 file system for the DAM sample

apbat
File that creates a DAM file for the DAM sample (used by dam_mkfs). This file is created when a UAP executable file is created using the make command. For details on how to create an executable file, see 8.3.2(1)(b) Create a UAP executable file.

tam_mkfs
Shell file that creates an OpenTP1 file system for the TAM sample

tamdata
Data file used to create a TAM table for dam_mkfs

chconf
Command that modifies a definition file (used to change $DCDIR to the actual OpenTP1 home directory)

bkconf
Command that restores a definition file modified by chconf to its original state

delvcmd
Command that delivers a command to nodes in Multi-OpenTP1 mode. For details on the delvcmd command, see 8.7 Samples to be used to dispatch multi OpenTP1 command.
(c) Contents of mcf/ directory

For details on the configuration of the mcf/ directory, see 8.6 How to use MCF sample.

(d) Contents of COBOL/ directory

For details on the configuration of the COBOL/ directory, see 8.8 COBOL language templates.

(2) Contents of rts_template/ directory under $DCDIR

The rts_template/ directory under $DCDIR directory contains the directory used with the real-time statistical information service. Files in the rts_template/ directory are listed below with a brief explanation.

(a) Contents of examples/ directory

Directories in the examples/ directory are listed below with a brief explanation.

conf/
Directory that contains the real-time acquisition item definition files for the real-time statistical information service
  • base_itm
    Real-time acquisition item definition file for BASE
  • dam_itm
    Real-time acquisition item definition file for DAM
  • tam_itm
    Real-time acquisition item definition file for TAM
  • all_itm
    Real-time acquisition item definition file for all statistical information
  • none_itm
    Real-time acquisition item definition file for no statistical information
  • mcfs_itm
    Real-time acquisition item definition file for the MCF (acquired for the entire system or for each server or service)
  • mcfl_itm
    Real-time acquisition item definition file for the MCF (acquired for each logical terminal)
  • mcfg_itm
    Real-time acquisition item definition file for the MCF (acquired for each service group)

(3) Contents of jp1_template/ directory under the installation directory

The jp1_template/ directory under the installation directory contains the directory used with the sample scenario template. Files in the jp1_template/ directory are listed below with a brief explanation.

examples/
Directory that contains the files used with the scale-out sample scenario template
(a) Contents of examples/ directory

Directories in the examples/ directory are listed below with a brief explanation.

aplib/
Directory that contains the load module (load module for the source file under the source/ directory) for the sample program of the scenario template

conf/
Directory that contains the definition file for the sample scenario template

tools/
Directory that contains the shell file used for the sample scenario template
dcjset_conf
Shell file that sets the OpenTP1 environment for the sample scenario template
dcj_mkfs
Shell file that creates an OpenTP1 file system for the sample scenario template
dcjmk_dcdir
Shell file that creates an OpenTP1 directory for the sample scenario template

source/
Directory that contains the sample program (UAP) of the scenario template. The sample scenario template uses the Base sample as the sample program. For details on the specifications of the Base sample, see 8.5 Specifications of sample programs.