Nonstop Database, HiRDB Version 9 System Operation Guide

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

9.3.2 Application examples

This section provides application examples illustrating how to use the pdbufmod command to add, modify, and delete global buffers.

Organization of this subsection
(1) Example 1: Adding a global buffer
(2) Example 2: Adding a global buffer and changing an RDAREA's global buffer assignment
(3) Example 3: Setting an RDAREA global buffer assignment
(4) Example 4: Changing an RDAREA global buffer assignment
(5) Example 5: Deleting a global buffer
(6) Example 6: Deleting a global buffer to which an RDAREA is assigned
(7) Example 7: Separating an RDAREA from a global buffer
(8) Example 8: Changing a global buffer definition

(1) Example 1: Adding a global buffer

In this example, a global buffer (gbuf01) is added, and an RDAREA (RDAREA1) added for that global buffer is assigned.

 
pdbufmod -k add -a gbuf01 -r RDAREA1 -n 1000
 

Explanation
-k add: Specifies addition of a global buffer.
-a: Specifies a name for the global buffer being added.
-r: Specifies an RDAREA to assign.
-n: Specifies the number of buffer sectors for the global buffer.

(2) Example 2: Adding a global buffer and changing an RDAREA's global buffer assignment

In this example, a global buffer (gbuf02) is added. At the same time, the global buffer to which an RDAREA (RDAREA1) is assigned (the RDAREA global buffer assignment) is changed from gbuf01 to gbuf02.

 
pdbufmod -k add -a gbuf02 -r RDAREA1 -n 1000
 

Explanation
-k add: Specifies addition of a global buffer.
-a: Specifies a name for the global buffer to be added.
-r: Specifies an RDAREA to assign.
-n: Specifies the number of buffer sectors for the global buffer.

(3) Example 3: Setting an RDAREA global buffer assignment

In this example, an added RDAREA (RDAREA1) is assigned to an existing global buffer (gbuf01).

 
pdbufmod -k add -a gbuf01 -r RDAREA1
 

Explanation
-k add: Specifies assignment of an RDAREA to an existing global buffer.
-a: Specifies the name of the target global buffer.
-r: Specifies the RDAREA to be assigned.

(4) Example 4: Changing an RDAREA global buffer assignment

In this example, the global buffer assignment of an RDAREA (RDAREA1) is changed from gbuf01 to gbuf02. Both gbuf01 and gbuf02 are existing global buffers.

 
pdbufmod -k add -a gbuf02 -r RDAREA1
 

Explanation
-k add: Specifies assignment of an RDAREA to an existing global buffer.
-a: Specifies the name of the target global buffer.
-r: Specifies the RDAREA to be assigned.

(5) Example 5: Deleting a global buffer

In this example, a global buffer (gbuf01) to which no RDAREA is assigned is deleted.

 
pdbufmod -k del -a gbuf01
 

Explanation
-k del: Specifies deletion of a global buffer.
-a: Specifies the name of the global buffer to be deleted.

(6) Example 6: Deleting a global buffer to which an RDAREA is assigned

In this example, a global buffer (gbuf01) to which an RDAREA (RDAREA1) is assigned is deleted.

 
pdhold -r RDAREA1 -c                              1
pdbufmod -k del -a gbuf01                         2
 

Explanation
  1. The RDAREA is placed in shutdown status. If gbuf01 is an index global buffer, the index storage RDAREA is placed in shutdown status. If the inner replica facility is being used, index storage RDAREAs of all generations are placed in shutdown status.
  2. The global buffer is deleted.

(7) Example 7: Separating an RDAREA from a global buffer

In this example, an RDAREA (RDAREA1) is separated from a global buffer (gbuf01).

 
pdhold -r RDAREA1 -c                              1
pdbufmod -k del -r RDAREA1                        2
 

Explanation
  1. The RDAREA is placed in shutdown status.
  2. The RDAREA is separated from the global buffer.

(8) Example 8: Changing a global buffer definition

In this example, the number of buffer sectors comprising a global buffer (gbuf01) is changed from 1,000 to 2,000.

 
pdbufmod -k upd -a gbuf01 -n 2000
 

Explanation
-k upd: Specifies a change in a global buffer definition.
-a: Specifies the name of the global buffer whose definition is to be changed.
-n: Specifies the number of buffer sectors after the change.

The pdbufmod command can be used to change the following items: