HiRDB Datareplicator Version 8 Description, User's Guide and Operator's Guide

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

9.2.1 Error handling procedures

This subsection explains the error handling procedures for the target Datareplicator.

Organization of this subsection
(1) Handling procedure
(2) Contacting the system administrator

(1) Handling procedure

To handle an error:

  1. Check the error message.
    The messages are output to the syslog file (event log in Windows). Check the messages.
  2. Check the error logs in the import error information file to see if they contain the same error messages that have been output to the syslog file (event log in Windows).
    A message (KFRB00051-I or KFRB00052-I) is output when an error information file is swapped or closed during Datareplicator operation. If this message is used as the basis for making a backup copy, first check its contents.
  3. Use the hdstrcedit command to edit the import trace file, analyze the file, and then store the results.
  4. Take action that is appropriate to the message.
    For details about how to handle errors, see 9.2.2 Error handling methods.
  5. Take appropriate action after correcting the error.
    Depending on the cause of the error, you might need to take some action that is appropriate to the process that resulted in the error. For details about the appropriate actions for each process that results in an error, see 9.2.3 Actions after correcting an error.
    Depending on the error, the target Datareplicator's process or shared memory (memory mapped file in Windows) might remain. In the UNIX edition of Datareplicator, any remaining processes or shared memory will be deleted when the Datareplicator is restarted.
    In the Windows edition of Datareplicator, use the following procedure to delete any remaining processes or memory mapped file.
    Step Description
    1 Start the Task Manager, and on the Processes page obtain the ID of the Datareplicator process.
    2 Terminate the process with the process ID obtained in step 1.
    pdkill process-ID#
    3 Delete the memory mapped file under installation-directory\tmp\hde\spool\shm.
    #
    If you are using Datareplicator Extension, use the hdskill command instead of the pdkill command.

(2) Contacting the system administrator

If you need to contact the system administrator about an error:

  1. Obtain the following data:
    • Messages output to the syslog file (event log in Windows)
    • Import Datareplicator's status information
      Execute the hdsstate command to obtain status information.
    • Binary files indicating the error information
      The following two files are output in the directory specified in the HDSPATH environment variable:
      [Figure] TCPDMP
      [Figure] rfc_core
      Note that if the user who started the target Datareplicator does not have write permission for the directory specified in the HDSPATH environment variable, the rfc_core file is not created.
    • Memory mapped file (Windows edition)
    • Import status files
    • Import master status file
    • Import error information files
    • Unimported information files
    • Import trace files
    • Definition files (if they might be changed)
  2. Check the nature of the error and take appropriate action.
    In the event of an internal conflict error, contact the customer support center.