7.13.3 Control statement (replicate rdarea statement)

This section explains the operands of the replicate rdarea statement. In the following table, the number corresponds to the explanation of the operand.

No.Operand
1

replicate rdarea replica-RDAREA-name

2

     [globalbuffer global-buffer-name]

3

     [lobbuffer LOB-global-buffer-name]

4

     reproduce original-RDAREA-name

5

     generation number generation-number-of-HiRDB-file-system-area

-

 ;

Organization of this subsection
(1) replica-RDAREA-name
(2) globalbuffer global-buffer-name
(3) lobbuffer LOB-global-buffer-name
(4) reproduce original-RDAREA-name
(5) generation number generation-number-of-HiRDB-file-system-area

(1) replica-RDAREA-name

[Figure]<string of alphanumeric symbols, underscore, and space beginning with an alphabetic symbol> ((1-30))

Specifies a name for the replica RDAREA that is being defined.

You cannot specify ALL for the RDAREA name. 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

[Figure]<string of alphanumeric symbols beginning with an alphabetic symbol> ((1-16))

Specifies the name of a global buffer in the HiRDB system (at the server where the replica definition is to be made, in the case of a HiRDB/Parallel Server) that is to be allocated temporarily to the user RDAREA for which a replica is being defined.

To check the global buffer, use the pdbufls command.

Rules
  1. You cannot specify a global buffer for indexes or LOB RDAREAs.
  2. 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 original RDAREA. You can use the pdbufls command to check the global buffer.
  3. A 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.
  4. When this operand is omitted, the global buffer allocated to the original RDAREA is also allocated to the replica RDAREA.
  5. If this operand is specified but no global buffer is allocated, the RDAREA replica definition results in an error.

(3) lobbuffer LOB-global-buffer-name

[Figure]<string of alphanumeric symbols beginning with an alphabetic symbol> ((1-16))

Specifies the name of a global buffer in the HiRDB system (at the server where the replica definition is to be made in the case of a HiRDB/Parallel Server) that is to be allocated temporarily to the LOB RDAREA for which a replica is being defined.

To check the global buffer, use the pdbufls command.

Rules
  1. You cannot specify a global buffer for user RDAREAs or index RDAREAs.
  2. The size of the specified global buffer must be greater than the page length of the original RDAREA. You can use the pdbufls command to check the global buffer.
  3. 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.
  4. When this operand is omitted, the LOB global buffer allocated to the original RDAREA is also allocated to the replica RDAREA. If no LOB global buffer has been allocated to the original RDAREA, no LOB global buffer is allocated to the replica RDAREA.
  5. If this operand is specified but no LOB global buffer is allocated, the RDAREA replica definition results in an error.
  6. You can specify this operand for replica definition for LOB RDAREAs. An error results if this operand is specified for replica definition for user RDAREAs.

(4) reproduce original-RDAREA-name

[Figure]<string of alphanumeric symbols, underscore, and space beginning with an alphabetic symbol> ((1-30))

Specifies the name of the original RDAREA for which a replica is being defined.

The system treats an RDAREA name enclosed in double quotation marks (") as case sensitive; otherwise, the system treats it as all uppercase letters.

(5) generation number generation-number-of-HiRDB-file-system-area

[Figure]<unsigned integer> ((1-10))

Specifies the generation number of the HiRDB file system area of the original RDAREA.

An error results if the registered generation number does not correspond to the HiRDB file system area of the HiRDB files that constitute the original RDAREA.