Nonstop Database, HiRDB Version 9 Installation and Design Guide

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

1.2.1 Initial files that are created

Organization of this subsection
(1) Directories and files that the HiRDB administrator creates
(2) Directories and files that HiRDB creates

(1) Directories and files that the HiRDB administrator creates

The following table lists the directories and files that the HiRDB administrator creates.

Table 1-3 Organization of directories and files that the HiRDB administrator creates

File or directory name Description
%PDDIR%\conf\pdsys File for storing system common definitions
%PDDIR%\conf\pdutsys File for storing unit control information definitions
%PDDIR%\conf\pdsvrc File for storing server common definitions
%PDDIR%\conf\server-name File for storing each server definition
%PDDIR%\conf\pduapenv Directory for storing UAP environment definitions
%PDDIR%\conf\chgconf Directory for storing system reconfiguration definition files

(2) Directories and files that HiRDB creates

The following table lists the directories and files that HiRDB creates.

Table 1-4 Directories and files that HiRDB creates

File or directory name Description
%PDDIR%\bin Directory for storing HiRDB commands and utilities
%PDDIR%\lib Directory for storing HiRDB's shared libraries and message text files
%PDDIR%\lib\sysconf Directory for storing a file that is used to analyze HiRDB system definitions
%PDDIR%\lib\sysdef
%PDDIR%\lib\servers Directory for storing HiRDB server and XDS executable files and libraries
%PDDIR%\lib\chinese Directory for storing EUC Chinese character code parser libraries
%PDDIR%\lib\chinese-gb18030 Directory for storing Chinese character code parser libraries
%PDDIR%\lib\lang-c Directory for storing single-byte character code parser libraries
%PDDIR%\lib\sjis Directory for storing Shift-JIS kanji code parser libraries
%PDDIR%\lib\utf-8 Directory for storing Unicode (UTF-8) parser libraries
%PDDIR%\client\lib Directory for storing HiRDB client's libraries
%PDDIR%\client\utl Directory for storing HiRDB client's commands and utilities
%PDDIR%\client\include Directory for storing the header information that is used during UAP creation
%PDDIR%\include Directory for storing header information that is used during UAP creation
%PDDIR%\spool Directory for storing HiRDB work files
%PDDIR%\spool\save#1 Directory for storing saved core files
%PDDIR%\spool\pdshmdump#1 Directory for storing shared memory dump files
%PDDIR%\spool\pdlckinf#1 Directory for storing deadlock time-out information files
%PDDIR%\spool\pdsysdump#1 Directory for storing simple dump files common to the system
%PDDIR%\spool\pdsdsdump#1 Directory for storing simple dump files for a single server
%PDDIR%\spool\pdfesdump#1 Directory for storing simple dump files for a front-end server
%PDDIR%\spool\pddicdump#1 Directory for storing simple dump files for a dictionary server
%PDDIR%\spool\pdbesdump#1 Directory for storing simple dump files for a back-end server
%PDDIR%\spool\pdstj1, pdstj2 Statistics log files
%PDDIR%\spool\pdlog1, pdlog2 Message log files
%PDDIR%\spool\pdjnlinf Directory for storing system log information output files
%PDDIR%\spool\pdjnlinf\errinf Directory for storing system log error information output files
%PDDIR%\spool\scdqid1, scdqid2 Files for storing HiRDB's internal schedule queue information
%PDDIR%\spool\oslmqid File for storing message queue IDs
%PDDIR%\spool\oslsmid File for storing semaphore IDs
%PDDIR%\spool\pdprcsts prc status file
%PDDIR%\spool\~pdatmode Status files for startup and termination
%PDDIR%\spool\~pdipcid Files used for managing semaphore IDs
%PDDIR%\spool\~pdommenv Files for storing shared memory information
%PDDIR%\spool\cmdlog\ cmdlog1, cmdlog2 Files containing the historical information about the executed commands
%PDDIR%\spool\errlog\errlog1, errlog2 Files containing the historical information about internal HiRDB operation
%PDDIR%\spool\olkfifs HiRDB's internal work directory
%PDDIR%\spool\olkrsfs HiRDB's internal work directory
%PDDIR%\spool\cnctusrinf File for storing the connected user information if there is any user still connected to HiRDB during the execution of normal termination or a planned termination command
%PDDIR%\spool\cnctusrdtl File for storing the execution result of pdls -d act, pdls -d prc, and pdls -d trn commands if there is any user still connected to HiRDB during the execution of normal termination or a planned termination command
%PDDIR%\spool\pdsqldump#1 Directory for storing access path information files
%PDDIR%\spool\pdprf Directory for outputting PRF trace files
%PDDIR%\spool\pdrshs1.log, pdrshs2.log File for storing information about remote commands
%PDDIR%\spool\pdsha1.log, pdsha2.log File for storing information about the system switchover facility
any name#2 RPC trace file
%PDDIR%\tmp#3 HiRDB's internal work directory
%PDDIR%\tmp\pdommenv File for storing shared memory information
%PDDIR%\tmp\home\HiRDB-managed-ID-directory Current work directory
%PDDIR%\conf Directory for storing HiRDB system definition files
%PDDIR%\conf\backconf Directory for storing the pre-reconfiguration HiRDB system definition when executing the system reconfiguration command
%PDDIR%\.dbenv Directory for storing HiRDB database environment information files
%PDCLTPATH\pdsql1.trc, pdsql2.trc#4 Files for storing trace information for SQL that is executed by a UAP
%PDCLTPATH\pderr1.trc, pderr2.trc#4 Files for storing information about communication errors between a UAP and a server
%PDDIR%\plugin Directory that integrates all HiRDB plug-in directories
%PDDIR%\plugin\lib Directory for storing plug-in libraries
%PDDIR%\plugin\plug-in-name Plug-in directory
%PDDIR%\plugin\plug-in-name\bin Directory for storing plug-in commands
%PDDIR%\plugin\plug-in-name\etc Directory for storing the common files that are required by all plug-ins
%PDDIR%\plugin\plug-in-name\conf Directory for storing plug-in configuration files
%PDDIR%\jre#5 Java execution environment
%PDDIR%\renew Directory used during updating to the HiRDB update version
%PDDIR%\renew_bak Directory for backing up the operating HiRDB when updating to the HiRDB update version
%PDDIR%\pdistup Directory containing the simple setup tool
%PDDIR%\sample Directory containing an execution environment for the sample database
%PDDIR%\HiRDEF Directory containing an execution environment for the HiRDB definition support
%PDDIR%\UXPLDIR Directory used by the differing system call specifications absorption library
%PDDIR%\UXPLDIR\spool\
uxpllog1.txt, uxpllog2.txt
File for storing the information that is output by the differing system call specifications absorption library
%PDDIR%\Setup.ini File for managing installation information

#1: Because HiRDB uses this directory to output troubleshooting information, it may keep increasing in size. You should use the pdcspool command periodically to delete the contents.

You use the operands listed below for periodic deletion of troubleshooting information. For details about these operands, see the manual HiRDB Version 9 System Definition:
  • pd_spool_cleanup_interval
  • pd_spool_cleanup_interval_level
  • pd_spool_cleanup
  • pd_spool_cleanup_level

#2: To specify the filename, use the pd_rpc_trace_name operand.

#3: This directory is used internally by HiRDB. Do not create directories or files in this directory. Do not specify this directory for use by HiRDB to create files (for example, for the pd_rpc_trace_name operand). This directory is deleted and re-created each time the unit starts.

#4: Two copies of this file are output to the directory specified with PDCLTPATH. If PDCLTPATH is omitted, the files are output to the current directory used to start the UAP (in the case of a UAP started from OpenTP1, %DCDIR%\tmp\home\directory-with-server-name-xx).

The names for the files to be created depends on whether X/Open-compliance API (TX_ function) was used. When the TX_ function is used, the files are created with the following names:
  • pdsqlxxxxx-1.trc, pdsqlxxxxx-2.trc
  • pderrxxxxx-1.trc, pderrxxxxx-2.trc
Legend:
xxxxx: Process ID during UAP execution

Be aware that it is possible for as many files to be output as there are server processes during UAP execution, since the process ID serves as the file name.

#5: This directory is created when the version is earlier than 07-03. When version 07-03 or later is used, this directory is not created because JRE is not bundled with the package.