20.4 Rules and notes

Organization of this section
(1) Rules
(2) Notes

(1) Rules

  1. The registry facility initialization utility can be executed only when HiRDB is running.
  2. The registry facility initialization utility should be executed on either a single-server or a server machine with a system manager.
  3. The registry facility becomes available after the registry facility initialization utility has terminated and a global buffer is allocated to the registry LOB RDAREA that has been added. Registry information for plug-ins can be registered after the registry facility has become available.
  4. Before executing the registry facility initialization utility, define a HiRDB file system area on a single-server or on a dictionary server. The pdfmkfs command can be used to initialize the HiRDB file system area.
  5. When executing the registry facility initialization utility, set appropriate client environment variables (PDNAMEPORT, PDHOST, and PDUSER) and an authorization identifier with CONNECT privileges. For details about the client environment variables, see the HiRDB Version 9 UAP Development Guide.
  6. After completing the execution of the registry facility initialization utility, be sure to use the database copy utility (pdcopy) to back up the registry RDAREAs, the registry LOB RDAREAs, the master directory, and the data dictionary LOB RDAREAs that were added.

(2) Notes

  1. The following are the pdreginit command's return codes:
    0: Normal termination
    4: Normal termination (warning-level error occurred, but processing terminated normally)
    8: Abnormal termination
  2. The addition of registry RDAREA and registry LOB RDAREAs and the creation of a registry management table are performed when control is passed to the database structure modification utility (pdmod).
  3. The registration of a registry operation stored procedure is executed upon normal termination of the database structure modification utility (with a KFPX24200-I message with a return code of 0 or 4). In the event of abnormal termination of the database structure modification utility (with a KFPX24200-I message with a return code of 12), the addition of the RDAREA and the creation of the registry management table will be rolled back.
  4. If an error occurred during the registration of a registry operation stored procedure, specify the registration of the registry operation stored procedure only, using the -k option, when executing the registry facility initialization utility next time. An attempt to specify the addition of a registry RDAREA and a registry LOB RDAREA without registering a registry operation stored procedure may cause an error.
  5. If you selected utf-8 or utf-8_ivs as the character encoding in the pdsetup command, you can use a control statements file that contains a BOM. However, only ASCII characters are permitted for comments in the control statements file. If character encoding other than ASCII is used, pdreginit may not function correctly.