7.14.3 Control statement (define copy rdarea statement)
(1) target-RDAREA-name
~<identifier> ((1-30))
Specifies the name of the target RDAREA to which the configuration information is to be copied.
The system treats an RDAREA name enclosed in double quotation marks (") as case sensitive; otherwise, the system treats it as all uppercase letters.
(2) globalbuffer global-buffer-name
~<identifier> ((1-16))
Specifies the name of the global buffer in the HiRDB system (in the server used to copy the configuration information in the case of a HiRDB parallel server configuration) that is to be allocated to the target RDAREA.
To check the global buffer, use the pdbufls command.
- Rules
- You cannot specify a global buffer for index or LOB RDAREAs.
- If you specified the number of global buffer sectors, the size of the specified global buffer must be greater than the page length of the source RDAREA. You can use the pdbufls command to check the global buffer.
- The global buffer allocation specified here is ignored the next time HiRDB starts normally. Therefore, you must change the global buffer allocation in the system common definition at the next HiRDB normal startup.
- When this operand is omitted, the utility allocates the global buffer that was allocated before the configuration information was copied.
- If this operand is specified but no global buffer is allocated, copying of the RDAREA configuration information results in an error.
(3) lobbuffer LOB-global-buffer-name
~<identifier> ((1-16))
Specifies the name of the global buffer in the HiRDB system (in the server used to copy configuration information in the case of a HiRDB parallel server configuration) that is to be allocated to the target LOB RDAREA.
To check the global buffer, use the pdbufls command.
- Rules
- You cannot specify a global buffer for user RDAREAs or index RDAREAs.
- The size of the specified global buffer must be greater than the page length of the source RDAREA. You can use the pdbufls command to check the global buffer.
- The global buffer allocation specified here is ignored the next time HiRDB starts normally. Therefore, you must change the global buffer allocation in the system common definition at the next HiRDB normal startup.
- When this operand is omitted, the utility allocates the LOB global buffer that was allocated before the configuration information was copied. Note that no LOB global buffer is allocated if no LOB global buffer had been allocated before the configuration information was copied.
- If this operand is specified but no LOB global buffer is allocated, copying of the RDAREA configuration information results in an error.
- This operand is applicable when LOB RDAREA configuration information is copied. An error results if this operand is specified when RDAREA configuration information for a user RDAREA is copied.
(4) reproduce source-RDAREA-name
~<identifier> ((1-30))
Specifies the name of the source RDAREA from which configuration information is to be copied.
The system treats an RDAREA name enclosed in double quotation marks (") as case sensitive; otherwise, the system treats it as all uppercase letters.
An error results if the registered generation number does not correspond to the HiRDB file system area of the HiRDB files that constitute the source RDAREA.