OpenTP1 Version 7 Operation
In addition to the OpenTP1 files, the OS files listed below are required in order to run OpenTP1.
The following files must be created by users:
The files list above are created under user-created directories. The $DCDIR/aplib and $DCDIR/conf directories are created during OpenTP1 installation.
The following table lists the files and directories that are created by users.
Table 1-4 User-created files and directories
Name | Directory | File name | File type | |
---|---|---|---|---|
User program file | $DCDIR/aplib/#1 | Name of execution form program#2 | Execution form file | |
MCF communication process program file and MCF application startup process program file | $DCDIR/lib/servers/ | Name of the executable program | Executable file | |
Definition files | System environment definition | $DCDIR/conf/ | env | Text file |
Definitions other than system environment definition | $DCCONFPATH/ | Name of definition file | Text file | |
System service information definition file | $DCDIR/lib/sysconf/ | Name of system service information definition file | Text file | |
System service common information definition#3 | $DCDIR/lib/sysconf/ | mcf | Text file |
The files listed below must be created during installation.
The files listed above are created under directories created by OpenTP1.
The directories that are created when OpenTP1 is installed or cataloged into the OS are:
The following table lists the files and directories that are created when OpenTP1 is installed or cataloged into the OS.
Table 1-5 Files and directories created at installation or cataloging into OS
Name | Directory | File name | |
---|---|---|---|
OpenTP1 program file | OpenTP1 servers | $DCDIR/lib/servers/ | --# |
Commands | $DCDIR/bin/ | -- | |
Header file | $DCDIR/include/ | -- | |
Archive file | $DCDIR/lib/ | -- | |
Definition analysis file | $DCDIR/lib/sysconf/ | --# | |
$DCDIR/lib/sysdef/ | -- | ||
Message object file | $DCDIR/lib/ | emsgtxt, jmsgtxt | |
User program file directory | $DCDIR/aplib/ | None | |
Definition file directory | $DCDIR/conf/ | None | |
System management information directory | $DCDIR/etc | -- | |
Core file directory | $DCDIR/spool/save/ | None | |
Command log directory | $DCDIR/spool/cmdlog/ | -- | |
Deadlock information file directory | $DCDIR/spool/dclckinf/ | None | |
Transaction information directory | $DCDIR/spool/dctrninf/ | None | |
Journal information directory | $DCDIR/spool/dcjnlinf/errinf/ | None | |
Process service information directory | $DCDIR/spool/dcprcinf/ | None | |
Transaction journal directory | $DCDIR/spool/dctjlinf/ | -- | |
Server recovery journal directory | $DCDIR/spool/dcsjl/ | -- | |
Directory for storing transaction control objects | $DCDIR/spool/trnrmcmd/userobj/ | None | |
Directory for online testers | $DCDIR/spool/uto/ | None | |
Directory for system internal lock control | $DCDIR/spool/olkfifs/ | -- | |
Directory for system internal synchronization control | $DCDIR/spool/olkrsfs/ | -- |
The files listed below are created dynamically by OpenTP1 during online execution.
The files listed below are created during normal OpenTP1 operation.
The current working directory for the system service and user server is also created during OpenTP1 execution.
During execution, OpenTP1 creates files in directories it has created. The following table lists the files and directories created in the course of OpenTP1 operation.
Table 1-6 Files and directories created during normal operation
Name | Directory | File name |
---|---|---|
Message log file | $DCDIR/spool/ | dclog1 and dclog2 |
MCF trace file#1 | $DCDIR/spool/ | mcftAXXZZ#2 |
Scheduling queue information file | $DCDIR/spool/ | scdqid1 and scdqid2 |
RPC trace file | $DCDIR/spool/ | rpctr1 and rpctr2#3 |
Trace information dump file | $DCDIR/spool/save/ | dcmtrdpl and dcmtrdp2 |
Performance verification trace information file | $DCDIR/spool/dcprfinf/ | prf_nnn#4 |
Backup file for performance verification trace information file | $DCDIR/spool/save/ | prf_nnn.bk1#5, and prf_nnn.bk2#5 |
XAR performance verification trace information file | $DCDIR/spool/dcxarinf/ | _xr_nnn#4 |
Backup file for XAR performance verification trace information file | $DCDIR/spool/save/ | _xr_nnn.bk1#5, and _xr_nnn.bk2#5 |
JNL performance verification trace information file | $DCDIR/spool/dcjnlinf/prfinf/ | _jl_nnn#4 |
Backup file for JNL performance verification trace information file | $DCDIR/spool/save/ | _jl_nnn.bk1#5, and _jl_nnn.bk2#5 |
LCK Performance verification trace information file | $DCDIR/spool/dclckinf/prf/ | _lk_nnn#4 |
Backup file for LCK performance verification trace information file | $DCDIR/spool/save/ | _lk_nnn.bk1#5, and _lk_nnn.bk2#5 |
MCF performance verification trace information file | $DCDIR/spool/dcmcfinf/ | _mc_nnn#4 |
Backup file for MCF performance verification trace information file | $DCDIR/spool/save/ | _mc_nnn.bk1#5, and _mc_nnn.bk2#5 |
TRN event trace information file | $DCDIR/spool/dctrninf/trace/prf/ | _tr_nnn#4 |
Backup file for TRN event trace information file | $DCDIR/spool/save/ | _tr_nnn.bk1#5, and _tr_nnn.bk2#5 |
NAM event trace information file | $DCDIR/spool/dcnaminf/ | _nm_001, _nm_002, and _nm_003 |
Backup file for NAM event trace information file | $DCDIR/spool/save/ | _nm_nnn.bk1#5, and _nm_nnn.bk2#5 |
Process service event trace information file | $DCDIR/spool/dcprcinf/ | _pr_001, _pr_002, and _pr_003 |
Backup file for process service event trace information file | $DCDIR/spool/save/ | _pr_nnn.bk1#5, and _pr_nnn.bk2#5 |
FIL event trace information file | $DCDIR/spool/dcfilinf/ | _fl_001, _fl_002, and _fl_003 |
Backup file for FIL event trace information file | $DCDIR/spool/save/ | _fl_nnn.bk1#5, and _fl_nnn.bk2#5 |
RTS log file | $DCDIR/spool/dcrtsinf/#6 | rtslog[1] to rtslog[10]#6, #7 |
MCF statistics file | $DCDIR/spool/#8 | mcfstc#8 |
Current working directory#9 | $DCDIR/tmp/home/server-name.ID#10/ | -- |
UAP trace data file | $DCDIR/tmp/home/server-name.ID | dcuat.map |
Backup file for UAP trace data file | $DCDIR/spool/save/trc/#11 | server-namen.uatmap#12, and server-name_n.uatmap#12 |
The files listed below are created when errors occur.
All files created during OpenTP1 execution are placed under an OpenTP1-created directory. The following table lists the files and directories that are created when an error occurs.
Table 1-7 Filesand directories created when an error occurs
Name | Directory | File name |
---|---|---|
Shared memory dump file | $DCDIR/spool/ |
|
Core file | $DCDIR/spool/save/ | server-namen#2 |
Deadlock and timeout information file | $DCDIR/spool/dclckinf/ | file-name#3 |
MCF dump file#4 | $DCDIR/spool/ | mcfdKAXXNN#5 |
MCF shared memory dump file#4 | $DCDIR/spool/ | mcfsAXXY#6 |
Undecided-transaction information file | $DCDIR/spool/dctrninf/ | file-name#7 |
Incorrect journal information file | $DCDIR/spool/dcjnlinf/ errinf/ | r_n#8 |
Copy file of input/output queue contents | $DCDIR/spool/ | file-name#9 |
UAP trace edit output file | $DCDIR/spool/save | server-namen#10.uat |
OpenTP1 debug information file | $DCDIR/spool/save | server-namen#10.deb |
In addition to the files listed in (a) and (b) above, files for OpenTP1 internal processing are placed under $DCDIR/spool/ and $DCDIR/tmp/. Users must not change these files without authorization. All files placed under $DCDIR/tmp/ for internal processing are cleared when OpenTP1 is started.
OpenTP1 uses /dev/console and /dev/null for standard input and output. Do not change the permissions for /dev/console and /dev/null. The operation may not be assured if the permissions are changed.
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.