CHGNODGRPA

La commande CHGNODGRPA permet de modifier les attributs de partitionnement de données pour un groupe de noeuds. Celui-ci contient une table comprenant 1024 partitions, chacune d'elles comportant un numéro de noeud. Les numéros de noeud, affectés lors de la création du groupe de noeuds, correspondent aux bases de données relationnelles indiquées dans le paramètre RDB de la commande CRTNODGRP. La commande DSPNODGRP (Afficher groupe de noeuds) permet de visualiser les valeurs correctes des numéros de noeud et les noms des bases de données relationnelles qui leur sont associées.

Cette commande n'affecte pas les fichiers répartis déjà créés à l'aide du groupe de noeuds indiqué. Les fichiers répartis créés après la modification de ce groupe de noeuds utilisent les nouveaux attributs de partitionnement.

• Vous pouvez créer un fichier base de données comme fichier réparti en indiquant des valeurs pour les paramètres NODGRP et PTNKEY de la commande CRTPF (Créer un fichier physique).
• Vous pouvez transformer en fichier réparti un fichier base de données physique qui ne l'est pas. Pour ce faire, indiquez des valeurs pour les paramètres NODGRP et PTNKEY de la commande CHGPF (Modifier un fichier physique).
• Vous pouvez modifier les attributs de partitionnement de données d'un fichier base de données réparti existant. Pour ce faire, indiquez des valeurs pour les paramètres NODGRP et PTNKEY de la commande CHGPF (Modifier un fichier physique). Les données seront alors de nouveau réparties selon la table de partitionnement du groupe de noeuds.

Paramètres

Groupe de noeuds (NODGRP)

Indique le groupe de noeuds dont les attributs doivent être modifiés.

Ce paramètre est obligatoire.

Qualificatif 1 : Groupe de noeuds

nom

Indiquez le nom du groupe de noeuds à modifier.

Qualificatif 2 : Biblio

*LIBL

La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB

La recherche porte sur la bibliothèque en cours du travail. Si celle-ci n'est pas précisée, QGPL est prise par défaut.

nom

Indiquez le nom de la bibliothèque dans laquelle doit s'effectuer la recherche.

Numéro de partition (PTNNBR)

Indique le numéro de partition à modifier.

0 à 1023:

Indiquez le numéro de partition à modifier.

Remarque :Vous devez indiquer soit PTNNBR, soit CMPDTA. Précisez PTNNBR si vous connaissez la partition à modifier. Vous pouvez utiliser la fonction intégrée %PARTITION avec la commande OPNQRYF (Ouvrir un fichier de requête) pour obtenir cette information. %HASH, %NODENUMBER et %NODENAME sont d'autres fonctions intégrées que vous pouvez utiliser avec la commande OPNQRYF pour traiter les fichiers répartis et le partitionnement de données.

Données de comparaison (CMPDTA)

Indique une valeur qui détermine le numéro de partition à modifier. Cette valeur sert d'entrée à un algorithme de hachage qui détermine la partition à modifier.

valeur-caractères

Indiquez les données à utiliser pour déterminer la partition à modifier. Vous pouvez entrer plusieurs valeurs qui correspondent à une clé de partitionnement ayant plusieurs colonnes (zones). Tapez les données alphanumériques sans espaces de début ou de fin. Entrez les données numériques à l'aide de leur représentation alphanumérique, sans zéro de début ou de fin, ni séparateur décimal (point ou virgule). (Par exemple, tapez 35 pour 3,5.) Vous pouvez indiquer jusqu'à 300 valeurs.

Remarque :Vous devez indiquer soit PTNNBR, soit CMPDTA. Précisez CMPDTA pour que des enregistrements (ou lignes) d'un fichier réparti soient acheminés vers un noeud particulier lorsque la clé de partitionnement contient la valeur indiquée.

Numéro de noeud (NODNBR)

Indique le nouveau numéro de noeud à associer à la partition à modifier.

1-32

Indiquez un numéro correct pour le groupe de noeuds. Vous pouvez utiliser la commande DSPNODGRP pour visualiser les numéros corrects pour un groupe de noeuds.

Exemples

Exemple 1 : Indication d'un numéro de partition

CHGNODGRPA   NODGRP(LIB1/GROUP1)  PTNNBR(1019)  NODNBR(2)

Cette commande modifie les attributs de partitionnement du groupe de noeuds GROUP1 de la bibliothèque LIB1. La partition 1019 est modifiée de sorte qu'elle fasse référence au noeud numéro 2. Ce dernier correspond à la deuxième base de données relationnelle indiquée lors de la création du groupe de noeuds (paramètre RDB de la commande CRTNODGRP).

Exemple 2 : Indication d'une valeur de comparaison

CHGNODGRPA   NODGRP(GROUP2)  CMPDTA('CHICAGO')  NODNBR(3)

Cette commande modifie les attributs de partitionnement du groupe de noeuds GROUP2 (GROUP2 est recherché dans la liste de bibliothèques *LIBL). La valeur indiquée dans le paramètre CMPDTA est hachée et le numéro de noeud existant de la partition résultante est remplacé par le noeud numéro 3.

Messages d'erreur

Messages *ESCAPE

CPF3166

Le groupe de noeuds &1 de la bibliothèque &2 est introuvable.

CPF3167

Le groupe de noeuds &1 de la bibliothèque &2 n'a pas été modifié.

CPF2189

Utilisation de l'objet &1 de &2, type *&3 non autorisée.

CPF9801

Objet &2 non trouvé dans la bibliothèque &3.

CPF9810

Bibliothèque &1 non trouvée.