Checks the contents of system definitions that are required in order to start HiRDB.
If there is an error in the system definitions, the command displays the erroneous definition along with the details.
(a) -d subdirectory-name ~<path name>
Specifies the subdirectory that contains the HiRDB system definition file to be checked, expressed as a path name relative to %PDDIR%\conf or %PDCONFPATH%. %PDDIR%\conf is the directory that contains unit control information definition files. %PDCONFPATH% is the directory that contains other HiRDB system definition files.
The following table shows the locations of the HiRDB system definition files that can be checked:
Type of HiRDB system definition file | -d option specified | -d option omitted |
---|
Unit control information definition file | %PDDIR%\conf\subdirectory\ | %PDDIR%\conf\ |
Other file | %PDCONFPATH%\subdirectory\ | %PDCONFPATH%\ |
- Criteria
- Before changing the HiRDB system definitions for the current environment, you should save the new HiRDB system definitions in a subdirectory and check them. This enables you to check the modified HiRDB system definitions before proceeding.
- Rules
- Create in advance the subdirectory that will be specified.
- Store in the subdirectory not only the modified HiRDB system definition file but all HiRDB system definition files.
- For a HiRDB/Single Server, the same path name is set in %PDDIR%\conf and %PDCONFPATH%.
- For a HiRDB/Parallel Server, the path name pointed to by %PDDIR%\conf and %PDCONFPATH% may be different (for example, when the HiRDB system definition file is shared). In this case, create a subdirectory with the same name on both paths.
If the %PDDIR%\conf and %PDCONFPATH% settings are different for each unit, create the subdirectory under %PDDIR%\conf and %PDCONFPATH% and then store the HiRDB system definition files in the subdirectories.
- The maximum lengths of %PDDIR%\conf\subdirectory and %PDCONFPATH%\subdirectory are 220 bytes. Make sure that the name does not exceed 220 bytes.
- To check the system definitions that are to be changed by the pdchgconf command, store the new system definition files in %PDDIR%\conf\chgconf and then specify -d chgconf when you execute the pdconfchk command.
- Because definitions are checked in the primary system when the system switchover facility is used, subdirectories that you create must be in the primary system. Note also that you must switch all running units to the primary units before you execute the pdconfchk command. If the unit containing the system manager is offline, execute the pdconfchk -d command on the unit that contains the system manager for the primary system.
- For a HiRDB/Single Server, the following operand values in the HiRDB system definition file under subdirectories must match the operand values under %PDDIR%\conf or %PDCONFPATH%:
Host name specified in the -x option of the pdunit operand
Host name specified in the pd_hostname operand
- For a HiRDB/Parallel Server, the following operand values in the HiRDB system definition file under subdirectories must match the operand values under %PDDIR%\conf or %PDCONFPATH%:
Host name specified in the -x option of the pdunit operand on the unit that contains the system manager
Host name specified in the pd_hostname operand on the unit that contains the system manager
(b) -n
Specifies that checking of the system files and access permissions is to be skipped. Use this option when the system files have not been created by the pdfmkfs or pdloginit command.
- Syntax checking
The command outputs the result of syntax checking to the standard output and standard error output.
- Checking for system files
The command checks for any system log file, synchronization point dump file, or status file.
- Checking for access privilege
The command checks the following:
- Whether the HiRDB administrator can access HiRDB files
- Whether there is a directory specified in the pd_tmp_directory operand in the system definition and whether the HiRDB administrator can access that directory
If the pd_tmp_directory operand is omitted, this checking is not performed.
- Checking for duplicated system files
The command checks the system log files, synchronization point dump files, and status files for any duplication.
The command checks to see if the host names are specified in the HOSTS file.
- Checking between server machines (applicable to HiRDB/Parallel Server)
The command checks between server machines based on the system manager's server machine.
For details about the operands in the system definition that can be checked by the pdconfchk command, see Operands Checked by the pdconfchk Command in the manual HiRDB Version 9 System Definition.