18.5 Notes

  1. Do not back up an erroneous RDAREA. A backup copy of an erroneous RDAREA is invalid and cannot be used to restore the database.
  2. To use EasyMT and MTguide, you need to initialize the magnetic tape before using this utility.
  3. If both EasyMT and JP1/Magnetic Tape Access are installed, the utility starts JP1/Magnetic Tape Access.
  4. The maximum number of copies of the database copy utility that can be executed concurrently depends on the value of the pd_utl_exec_mode operand in the system common definitions. If pd_utl_exec_mode=0 is specified, you can execute a maximum of 32 copies; if pd_utl_exec_mode=1 is specified, you can execute as many copies as there are specified in the pd_max_users operand. The number of copies of the database copy utility that can be executed concurrently depends on the number of specified backup files. The following describes the concept of concurrently executing database copy utility copies:
    Concept
    • If six copies of database copy utility are executed concurrently, each of which uses a single backup file, the number of concurrently executing database copy utility copies is 1 [Figure] 6 = 6.
    • If four copies of database copy utility are executed concurrently, each of which uses two single backup files, the number of concurrently executing database copy utility copies is 2 [Figure] 4 = 8.
    • If all the above database copy utilities are running concurrently, the number of concurrently executing utility copies is 6 + 8 = 14.
      If one backup file is created per server machine in a HiRDB parallel server configuration environment in which pd_utl_exec_mode=0 was specified, the number of concurrently executing utility copies becomes greater than the number of executable pdcopy copies. This means that the maximum number of concurrently executable utilities might be exceeded when pd_utl_exec_mode=0 is specified, which will result in an error. If this error does occur, take one of the following actions:
      [Figure]Reduce the number of pdcopy copies to be executed.
      [Figure]Specify pd_utl_exec_mode=1.
  5. If you specify multiple backup files in the control statement file using a regular expression in the -r option, make sure that the RDAREAs subject to backup processing are output to a single backup file. An error results if they are output to multiple backup files. The following shows examples:
    Example 1
    -b back-up-file-1 -r RDUSER*,RDMASTER
    -b back-up-file-2 -r ..USER,RDDICTIONARY
    Explanation:
    An error results because the RDAREAs with names beginning with RDUSER are output to backup files 1 and 2.
    Example 2
    -b back-up-file-1 -r RD*,RDMASTER
    Explanation:
    This specification does not result in an error because there is only one backup file, although RD* includes RDMASTER.
  6. The return codes of pdcopy are as follows:
    0: Normal termination
    8: Abnormal termination (some of the copy operations failed or were skipped)
    12: Abnormal termination (all copy operations failed)
  7. If you selected utf-8 or utf-8_ivs as the character encoding in the pdsetup command, you can use a file with a BOM as the control statements file for pdcopy. Note that even when a file with a BOM is used as the control statements file, the BOM is skipped. No BOM is included in the file that is output by pdcopy.
  8. For details about acquiring a backup when the OS time is delayed, see the HiRDB Version 9 System Operation Guide.