1.2.5 Procedure for modifying the HiRDB system definitions (excluding UAP environment definition)

Organization of this subsection
(1) Modifying the HiRDB system definitions
(2) Using the system reconfiguration command to modify the HiRDB system definitions
(3) Notes
(4) When linking a HiRDB Datareplicator

(1) Modifying the HiRDB system definitions

This subsection describes how to modify the HiRDB system definitions. Note that %PDDIR%\conf is the directory that stores the unit control information definition file. %PDCONFPATH% is the directory that stores other HiRDB system definition files.

To modify the HiRDB system definitions:
  1. Create subdirectories under %PDDIR%\conf and %PDCONFPATH%. In this example, a subdirectory called work is created.
  2. Copy the unit control information definition file to %PDDIR%\conf\work. Copy other HiRDB system definition files to %PDCONFPATH%\work.
  3. Modify the HiRDB system definitions that have been copied to %PDDIR%\conf\work and %PDCONFPATH%\work.
  4. Use the pdconfchk -d work command to check the content of the HiRDB system definitions in %PDDIR%\conf\work and %PDCONFPATH%\work. If any error is found, correct the HiRDB system definition and re-execute the pdconfchk command.
  5. Use the pdstop command to normally terminate HiRDB.
  6. Use the pdlogunld command to unload the system log files that are waiting to be unloaded.
  7. Replace the HiRDB system definition file by copying the HiRDB system definition file modified in Step 3 to %PDDIR%\conf or %PDCONFPATH%.
  8. If you modify the specified values of the following operands, you must use the pdloginit command to initialize the system log file.
    [Figure]pd_log_dual
    [Figure] pdstart
  9. Use the pdstart command to normally start HiRDB.

(2) Using the system reconfiguration command to modify the HiRDB system definitions

If you use the system reconfiguration command (pdchgconf command), you can modify the HiRDB system definitions while HiRDB is running, and therefore you need not normally terminate HiRDB. Note however that HiRDB Advanced High Availability is required for using this command.

To modify the HiRDB system definition using the system reconfiguration command:
  1. Create the %PDDIR%\conf\chgconf directory.
  2. Copy the HiRDB system definition file being used to the directory created in Step 1.
  3. Modify the HiRDB system definitions in %PDDIR%\conf\chgconf.
  4. Use the pdconfchk -d chgconf command to check the HiRDB system definitions in %PDDIR%\conf\chgconf. If any error is found, correct the HiRDB system definition and re-execute the pdconfchk command.
  5. Use the pdchgconf command to replace the HiRDB system definition with the modified one.
    When you execute the pdchgconf command, the HiRDB system definition file being used (unmodified one) is saved to %PDDIR%\conf\backconf. Then, the modified HiRDB system definition file in %PDDIR%\conf\chgconf is copied to %PDDIR%\conf.
Notes:
  • If a transaction or utility continues to be active for 15 minutes or longer after the pdchgconf command is input, the command is aborted.
  • Some limits apply when you use the system reconfiguration command to modify the HiRDB system definitions. For details on these limits, see the HiRDB Version 8 System Operation Guide.

(3) Notes

(4) When linking a HiRDB Datareplicator

Before the operands listed below are added, modified, or deleted, HiRDB Datareplicator must be terminated; HiRDB Datareplicator can be restarted after the operand addition, modification, or deletion operation is completed:

If these operands are added, modified, or deleted while HiRDB Datareplicator is running, extraction by HiRDB Datareplicator may fail under some circumstances.