ibm-information-center/dist/eclipse/plugins/i5OS.ic.dbmult_5.4.0.1/chgnga.htm

99 lines
7.5 KiB
HTML

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en-us" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="security" content="public" />
<meta name="Robots" content="index,follow" />
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<meta name="DC.Type" content="concept" />
<meta name="DC.Title" content="Change Node Group Attributes (CHGNODGRPA) command" />
<meta name="abstract" content="The Change Node Group Attributes (CHGNODGRPA) command changes the data partitioning attributes for a node group." />
<meta name="description" content="The Change Node Group Attributes (CHGNODGRPA) command changes the data partitioning attributes for a node group." />
<meta name="DC.subject" content="node group, changing, data partitioning attributes examples, CHGNODGRPA (Change Node Group Attributes) command, Change Node Group Attributes (CHGNODGRPA) command, command, CL, CHGNODGRPA (Change Node Group Attributes), command, CL, Change Node Group Attributes (CHGNODGRPA), data partitioning attribute, changing, example, data partitioning attributes examples, data partitioning attributes, changing, partitioning attributes, changing" />
<meta name="keywords" content="node group, changing, data partitioning attributes examples, CHGNODGRPA (Change Node Group Attributes) command, Change Node Group Attributes (CHGNODGRPA) command, command, CL, CHGNODGRPA (Change Node Group Attributes), command, CL, Change Node Group Attributes (CHGNODGRPA), data partitioning attribute, changing, example, data partitioning attributes examples, data partitioning attributes, changing, partitioning attributes, changing" />
<meta name="DC.Relation" scheme="URI" content="rzaf3c2-gen4.htm" />
<meta name="DC.Relation" scheme="URI" content="crtngc.htm" />
<meta name="DC.Relation" scheme="URI" content="../rbam6/rbam6clmain.htm" />
<meta name="DC.Relation" scheme="URI" content="ption.htm" />
<meta name="DC.Relation" scheme="URI" content="custdd.htm" />
<meta name="copyright" content="(C) Copyright IBM Corporation 1998, 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 1998, 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="chgnga" />
<meta name="DC.Language" content="en-us" />
<!-- All rights reserved. Licensed Materials Property of IBM -->
<!-- US Government Users Restricted Rights -->
<!-- Use, duplication or disclosure restricted by -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
<link rel="stylesheet" type="text/css" href="./ic.css" />
<title>Change Node Group Attributes (CHGNODGRPA) command</title>
</head>
<body id="chgnga"><a name="chgnga"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Change Node Group Attributes (CHGNODGRPA) command</h1>
<div><p>The Change Node Group Attributes (CHGNODGRPA) command changes the
data partitioning attributes for a node group.</p>
<p>The node group contains a table with 1024 partitions; each partition contains
a node number. Node numbers were assigned when the node group was created
and correspond to the relational databases specified on the RDB parameter
of the Create Node Group (CRTNODGRP) command. Use the Display Node Group (DSPNODGRP)
command to see the valid node number values and the correlation between node
numbers and relational database names.</p>
<p>The CHGNODGRPA command does not affect any existing distributed files that
were created using the specified node group. For the changed node group to
be used, the changed node group must be specified either when creating a new
file or on the Change Physical File (CHGPF) command. For complete details
on the CHGNODGRPA command, see the Control Language topic in the Information
Center.</p>
<div class="p">This first example shows how to change the partitioning attributes of the
node group named GROUP1 in library LIB1: <pre>CHGNODGRPA NODGRP(LIB1/GROUP1) PTNNBR(1019)
NODNBR(2)</pre>
</div>
<p>In this example, the partition number 1019 is specified, and any records
that hash to 1019 are written to node number 2. This provides a method for
directing specific partition numbers to specific nodes within a node group.</p>
<div class="p">The second example changes the partitioning attributes of the node group
named GROUP2. (GROUP2 is found by using the library search list, *LIBL.) The
value specified on the comparison data value (CMPDTA) parameter is hashed,
and the resulting partition number is changed from its existing node number
to node number 3. (Hashing and partitioning are discussed in Partitioning
with DB2<sup>®</sup> Multisystem.)
<pre>CHGNODGRPA NODGRP(GROUP2) CMPDTA('CHICAGO')
NODNBR(3)</pre>
</div>
<p>Any files that are created using this node group and that have a partitioning
key consisting of a character field store records that contain 'CHICAGO' in
the partitioning key on node number 3. To allow for files with multiple fields
in the partitioning key, you can specify up to 300 values on the compare data
(CMPDTA) parameter.</p>
<p>When you enter values on the CMPDTA parameter, you should be aware that
the character data is case-sensitive. This means that 'Chicago' and 'CHICAGO'
do not result in the same partition number. Numeric data should be entered
only as numeric digits; do not use a decimal point, leading zeros, or following
zeros.</p>
<p>All values are hashed to obtain a partition number, which is then associated
with the node number that is specified on the node number (NODNBR) parameter.
The text of the completion message, CPC3207, shows the partition number that
was changed. Be aware that by issuing the CHGNODGRPA command many times and
for many different values that you increase the chance of changing the same
partition number twice. If this occurs, the node number that is specified
on the most recent change is in effect for the node group.</p>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzaf3c2-gen4.htm" title="To enable database files to be visible across a set of iSeries servers, you must first define the group of systems (node group) that you want the files on.">Introduction of node groups with DB2 Multisystem</a></div>
</div>
<div class="relconcepts"><strong>Related concepts</strong><br />
<div><a href="crtngc.htm" title="This section uses two CL command examples to show how to create a node group by using the Create Node Group (CRTNODGRP) command.">Create Node Group (CRTNODGRP) command</a></div>
<div><a href="ption.htm" title="Partitioning is the process of distributing a file across the nodes in a node group.">Partitioning with DB2 Multisystem</a></div>
<div><a href="custdd.htm" title="Because the system is responsible for placing the data, you do not need to know where the records actually reside. However, if you want to guarantee that certain records are always stored on a particular system, you can use the Change Node Group Attributes (CHGNODGRPA) command to specify where those records reside.">Customization of data distribution with DB2 Multisystem</a></div>
</div>
<div class="relref"><strong>Related reference</strong><br />
<div><a href="../rbam6/rbam6clmain.htm">Control language</a></div>
</div>
</div>
</body>
</html>