18.5 Notes
- Do not back up an erroneous RDAREA. A backup copy of an erroneous RDAREA is invalid and cannot be used to restore the database.
- To use EasyMT and MTguide, you need to initialize the magnetic tape before using this utility.
- If both EasyMT and JP1/Magnetic Tape Access are installed, the utility starts JP1/Magnetic Tape Access.
- 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
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
4 = 8. - If all the above database copy utilities are running concurrently, the number of concurrently executing utility copies is 6 + 8 = 14.
- 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.
- 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)
- You can copy a maximum of 1,120 RDAREAs in a single execution of pdcopy. If you have specified multiple backup files in the -b option in the control statements file, you can copy a maximum of 1,120 RDAREAs per backup file.
- If you selected utf-8 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.