CRTNODGRP

La commande CRTNODGRP permet de créer un groupe de noeuds en vue de la création de fichiers base de données répartis.

Paramètres

Groupe de noeuds (NODGRP)

Indique le groupe de noeuds à créer.

Ce paramètre est obligatoire.

Qualificatif 1 : Groupe de noeuds

nom

Indiquez le nom du groupe de noeuds à créer.

Qualificatif 2 : Biblio

*CURLIB

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

nom

Indiquez le nom de la bibliothèque du groupe de noeuds.

Base de données relationnelle (RDB)

Indique les bases de données relationnelles à inclure dans le groupe de noeuds.

Ce paramètre est obligatoire.

valeur-caractères

Indiquez le nom de chaque base de données relationnelle à utiliser. La longueur maximale d'un nom de base de données relationnelle est de 18 caractères. Ceux-ci doivent déjà avoir été définis dans le répertoire des bases de données relationnelles du système à l'aide de la commande ADDRDBDIRE (Ajouter poste répertoire RDB). Vous devez indiquer au moins deux noms de base de données relationnelle. L'un des postes doit correspondre au système local. Tous les autres postes doivent correspondre à des système IBM i éloignés. Vous pouvez indiquer jusqu'à 32 bases de données relationnelles.

Lors de la création du groupe de noeuds, un numéro de noeud est affecté à chaque base de données relationnelle indiquée. La numérotation est consécutive et commence par 1 : le numéro 1 est associé à la première base de données relationnelle indiquée, le numéro 2 à la deuxième et ainsi de suite. Dès que le groupe de noeuds est créé, vous pouvez utiliser la commande DSPNODGRP (Afficher un groupe de noeuds) pour savoir quel numéro correspond à quel nom de base de données relationnelle.

Fichier de partitionnement (PTNFILE)

Indique le nom du fichier à utiliser pour déterminer les attributs de partitionnement du groupe de noeuds. Celui-ci contient une table comprenant 1024 partitions, chacune d'elles comportant un numéro de noeud. Le fichier de partitionnement vous permet de définir le numéro de noeud associé à chacune des 1024 partitions. Pour une description détaillée des formats de fichier de partitionnement, reportez-vous au manuel DB2 Multisystem for IBM i.

Qualificatif 1 : Fichier de partitionnement

*NONE

Un fichier de partitionnement ne sera pas utilisé pour la définition des attributs de partitionnement de cet objet groupe de noeuds. Chaque numéro de noeud correct sera affecté à un nombre égal de partitions. Par exemple, si deux bases de données relationnelles sont indiquées, deux numéros corrects (1 et 2) leur sont associés : le numéro 1 est attribué à 512 partitions et le numéro 2 aux 512 autres.

nom

Indiquez le nom du fichier de partitionnement à utiliser.

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.

Membre de partitionnement (PTNMBR)

Indique le membre du fichier de partitionnement à utiliser pour déterminer les attributs de partitionnement de ce groupe de noeuds.

*FIRST

Le premier membre du fichier de partitionnement est utilisé.

nom

Indiquez le nom du membre à utiliser.

Remarque :Ce paramètre ne doit pas être utilisé si *NONE est indiqué en regard du paramètre Fichier de partitionnement (PTNFILE).

Texte 'descriptif' (TEXT)

Permet d'indiquer une brève description du groupe de noeuds.

*BLANK

Aucun texte n'est indiqué.

valeur-alphanumérique

Tapez un texte d'au plus 50 caractères, entre apostrophes.

Droits (AUT)

Indique les droits que vous accordez aux utilisateurs qui n'ont pas de droits spécifiques sur l'objet, qui ne figurent pas sur une liste d'autorisation ou dont le profil de groupe ou les profils du groupe supplémentaire ne disposent pas de droits spécifiques sur l'objet.

*LIBCRTAUT

Le système détermine les droits sur l'objet à l'aide de la valeur spécifiée à l'invite Droits pour objets créés (paramètre CRTAUT) dans la commande CRTLIB pour la bibliothèque contenant l'objet à créer. Si la valeur précisée au paramètre CRTAUT est modifiée, la nouvelle valeur n'affecte pas les objets existants.

*CHANGE

L'utilisateur peut effectuer toutes les opérations sur l'objet, à l'exception de celles réservées au propriétaire ou contrôlées par les droits d'existence de l'objet (*OBJEXIST) et de gestion de l'objet (*OBJMGT). L'utilisateur peut réaliser des fonctions de base sur l'objet et le modifier. Le droit *CHANGE fournit le droit d'opération sur l'objet (*OBJOPR) ainsi que les droits sur toutes les données. Si l'objet est une liste d'autorisation, vous pouvez ajouter, modifier ou supprimer des utilisateurs dans cette liste.

*ALL

L'utilisateur peut effectuer toutes les opérations, à l'exception de celles réservées au propriétaire ou soumises au droit de gestion de la liste d'autorisation (*AUTLMGT). L'utilisateur a un droit d'existence sur l'objet Il peut également effectuer des fonctions de base sur ce dernier, le modifier, définir son niveau de protection et en transférer la propriété.

*USE

L'utilisateur peut effectuer des opérations de base sur l'objet, telles que l'exécution d'un programme ou la lecture d'un fichier. Il ne peut pas le modifier. Le droit d'utilisation (*USE) fournit le droit d'opération sur l'objet (*OBJOPR) ainsi que le droit d'exécution (*EXECUTE).

*EXCLUDE

L'utilisateur n'a pas accès à l'objet.

nom

Indiquez le nom d'une liste d'autorisation permettant de déterminer les droits sur l'objet. Les droits sur l'objet précisés dans la liste sont accordés aux utilisateurs qui figurent sur cette liste. La liste d'autorisation doit exister à la création de l'objet.

Exemples

Exemple 1 : Création d'un groupe comportant un partitionnement par défaut

CRTNODGRP   NODGRP(LIB1/GROUP1)
            RDB(SYSTEMA SYSTEMB SYSTEMC SYSTEMD)
            TEXT('groupe de noeuds destinés aux fichiers test')

Cette commande crée un groupe de noeuds contenant quatre noeuds. Par défaut, les attributs de partitionnement affectent un quart des partitions à chaque numéro de noeud. Ce groupe de noeuds peut être utilisé pour le paramètre NODGRP de la commande CL CRTPF (Créer un fichier physique) afin de créer un fichier réparti. Dans les fichiers répartis créés en indiquant ce groupe de noeuds, les données sont réparties entre les systèmes des quatre noeuds. Si les enregistrements du fichier réparti contiennent une distribution uniforme des valeurs pour les zones comportant la clé de partition, les enregistrements sont répartis uniformément sur les systèmes des noeuds.

Exemple 2 : Création d'un groupe comportant un partitionnement spécifique

CRTNODGRP   NODGRP(LIB1/GROUP2)  RDB(SYSTEMA SYSTEMB SYSTEMC)
            PTNFILE(LIB1/PTN1)
            TEXT('partition de la plupart des données vers SYSTEMA')

Cette commande crée un groupe de noeuds contenant trois noeuds. Les attributs de partitionnement sont extraits du fichier PTN1. Ce dernier peut être configuré de sorte qu'un pourcentage plus élevé des enregistrements (ou lignes) soit situé sur un système particulier.

Messages d'erreur

Messages *ESCAPE

CPF3165

Le groupe de noeuds &1 de la bibliothèque &2 n'a pas pu être créé.