ADDRDBDIRE

La commande ADDRDBDIRE permet d'ajouter un poste au répertoire des bases de données relationnelles. Les postes de RDB (base de données relationnelle) peuvent représenter des bases de données locales ou éloignées. La RDB associée à un poste peut également être classée comme base de données système ou utilisateur.

Il n'y a qu'une base de données système par système. Elle est définie comme pool de mémoire secondaire système (ASP numéro 1) et ASP utilisateur de base configurés (ASP numéros 2 à 32). Un système peut être configuré pour avoir une ou plusieurs bases de données utilisateur. Une base de données utilisateur est définie comme étant un groupe ASP configuré et disponible. Une telle base de données est jointe à la base de données système de manière telle que tous les objets, sur la base de données système, sont également accessibles à travers elle.

Remarque :Utilisé dans ce contexte, 'système' peut se référer à une partition logique d'une machine System i configurée en partitions multiples.

Les bases de données locales incluent la base de données système et toute base de données utilisateur disponible sur ce système. Les bases de données éloignées résident normalement sur un autre système, mais un groupe ASP non disponible, configuré sur ce système, est également considéré comme étant temporairement éloigné, car il peut avoir été commuté sur un autre noeud, dans une grappes de systèmes.

Restrictions :

• Vous devez disposer du droit d'exécution (*EXECUTE) sur la bibliothèque et le programme spécifiés au paramètre Pilote demandeur d'application (ARDPGM).

Paramètres

Poste (RDB)

Indique des informations sur le nom de la base de données relationnelle.

Vous devez indiquer une valeur pour ce paramètre.

Remarque :Les noms et les alias de base de données relationnelle valides peuvent être constitués des caractères suivants : A-Z, 0-9, à, #, $ et _.

Elément 1 : Base de données relationnelle

valeur-alphanumérique

Indiquez le nom de base de données relationnelle tel qu'il est identifié sur le lieu éloigné. Ce nom ne doit pas dépasser 18 caractères ; en revanche, les noms de base de données relationnelle DB2 UDB for z/OS sont limités à 16 caractères.

Elément 2 : Alias base données relation

*NONE

Il n'existe aucun alias local pour la base de données relationnelle.

valeur-alphanumérique

Indiquez l'alias de base de données relationnelle. L'alias est utilisé pour identifier localement la base de données relationnelle indiquée ci-dessus. L'alias ne doit pas dépasser 18 caractères. Un nom d'alias de base de données relationnelle est incorrect lorsqu'il est défini avec un nom de lieu éloigné *LOCAL.

Lieu éloigné (RMTLOCNAME)

Indique le nom de lieu éloigné du système sur lequel se trouve la base de données relationnelle.

Vous devez indiquer une valeur pour ce paramètre.

Valeurs uniques

*ARDPGM

Le programme pilote de demandeur d'applications indiqué au paramètre ARDPGM est utilisé pour accéder à la RDB. Un nom de lieu éloigné n'est pas utilisé pour localiser la RDB.

Remarque :Lorsque *ARDPGM est précisé, les paramètres PORT, DEV, LCLLOCNAME, RMTNETID, MODE et TNSPGM sont ignorés.

*LOOPBACK

Cette valeur est un alias pour l'adresse IP du système hôte.

Remarque :Lorsque *LOOPBACK est précisé, les paramètres DEV, LCLLOCNAME, RMTNETID, MODE, TNSPGM et ARDPGM sont ignorés et la valeur du second élément est forcée à *IP.

*MIRROR

L'accès à la base de données relationnelle s'effectue sur l'autre système dans le cadre d'une relation Db2 Mirror.

Remarque :Lorsque *MIRROR est précisé, les paramètres PORT, RMTAUTHMTH, DEV, LCLLOCNAME, RMTNETID, MODE, TNSPGM et ARDPGM sont ignorés.

Elément 1 : Nom ou adresse

*LOCAL

Ce poste est la base de données système (ASP système et tout ASP de base) sur ce système. Dans le répertoire RDB, vous ne pouvez indiquer *LOCAL que pour un poste.

Remarque :Lorsque *LOCAL est précisé, les paramètres DEV, LCLLOCNAME, RMTNETID, MODE, TNSPGM et ARDPGM sont ignorés et la valeur du second élément est forcée à *IP. Un nom d'alias de base de données relationnelle est incorrect lorsqu'il est défini avec un nom de lieu éloigné *LOCAL.

valeur-alphanumérique

Le premier élément de ce paramètre peut être indiqué dans plusieurs formats :

• Nom de lieu éloigné SNA (nom de LU). Indiquez un nom de 8 caractères au maximum. Si ce format est utilisé, le deuxième élément de ce paramètre doit être *SNA (la valeur par défaut).
• ID réseau éloigné SNA et nom de lieu éloigné, séparés par un point. Indiquez au maximum 8 caractères pour chacun de ces deux éléments. Si ce format du paramètre est utilisé, le deuxième élément de ce paramètre doit être *SNA (la valeur par défaut), et toute valeur indiquée au paramètre RMTNETID doit concorder. Si cette valeur n'est pas spécifiée, elle est définie de façon à correspondre à celle du paramètre RMTLOCNAME.
• Adresse IP (version 4) en notation décimale à point. Indiquez une adresse IP (version 4) au format nnn.nnn.nnn.nnn, où chaque nnn représente un nombre compris entre 0 et 255. Si ce format est utilisé, le deuxième élément de ce paramètre doit être indiqué comme *IP.
• Adresse IP (version 6) en notation hexadécimale à deux-points. Indiquez une adresse IP (version 6) au format xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx, où chaque xxxx représente un nombre hexadécimal compris entre 0 et FFFF. Si ce format est utilisé, le deuxième élément de ce paramètre doit être indiqué comme *IP. L'adresse IP version 6 inclut le format d'adresse IPv6 mappé IPv4 (par exemple, ::FFFF:1.2.3.4). Pour l'adresse IP version 6, le format compressé de l'adresse est admis.
• Nom de domaine d'hôte IP. Indiquez un nom de domaine d'hôte Internet comportant jusqu'à 254 caractères. Si ce format est utilisé, le deuxième élément de ce paramètre doit être indiqué comme *IP.

Si le deuxième élément indiqué est *IP, le serveur DRDA du lieu éloigné doit prendre en charge l'utilisation de TCP/IP, et les paramètres DEV, LCLLOCNAME, RMTNETID, MODE et TNSPGM sont ignorés.

Si le deuxième élément indiqué est *SNA, le serveur DRDA doit prendre en charge la connectivité SNA. Pour plus d'informations sur les noms de lieux éloignés SNA, consultez les manuels APPC Programming, SC41-5443, et APPN de la catégorie Networking de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Elément 2 : Type

*SNA

Le système RDB est accessible à l'aide d'une adresse et d'un protocole SNA (Systems Network Architecture).

*IP

Pour trouver le système RDB, utilisez un nom d'hôte ou une adresse Internet sur une connexion TCP/IP.

Numéro port ou pgm de service (PORT)

Indique le port TCP/IP utilisé par le lieu éloigné pour communiquer avec le système sur lequel la RDB est installée. Ce paramètre est ignoré si *IP n'est pas indiqué au paramètre RMTLOCNAME.

*DRDA

Le port connu DRDA 446 est utilisé.

numéro-port

Indiquez un numéro compris entre 1 et 65535.

nom-service

Indiquez au maximum 14 caractères pour le nom de service. Ce nom doit être enregistré dans le fichier base de données de service.

Méthode authentification dist (RMTAUTMTH)

Indique la méthode d'authentification éloignée préférée, sur une demande de connexion TCP/IP DDM/DRDA. La méthode effectivement utilisée est fonction du résultat du processus de négociation entre client et serveur ; elle dépend de la prise en charge cryptographique disponible et de la configuration des paramètres de sécurité du serveur. La commande CHGDDMTCPA (Modifier attributs TCP/IP DDM) peut être utilisée pour configurer la sécurité TCP/IP DDM/DRDA sur les systèmes i5/OS. Ce paramètre est ignoré si *IP n'est pas précisé dans Lieu éloigné (paramètre RMTLOCNAME).

Elément 1 : Méthode préférée

Indique la méthode d'authentification initiale proposée au serveur. Basée sur les méthodes d'authentification prises en charge par le serveur et sur la valeur précisée pour l'élément Authentific inférieure admise de ce paramètre, une méthode d'authentification est négociée si elle est acceptable au client et au serveur.

*USRENCPWD

L'ID utilisateur et le mot de passe chiffré associé sont envoyés dans une demande de connexion DDM. La prise en charge cryptographique doit être disponible sur les deux systèmes pour pouvoir utiliser cette méthode d'authentification.

*USRID

L'ID utilisateur uniquement est envoyé dans la demande de connexion DDM. C'est la méthode d'authentification de plus faible niveau.

*USRIDPWD

L'ID utilisateur et le mot de passe associé sont envoyés dans une demande de connexion DDM. Les mots de passe ne sont pas chiffrés si cette méthode d'authentification est utilisée.

*ENCUSRPWD

L'ID utilisateur chiffré et le mot de passe chiffré associé sont envoyés lors d'une demande de connexion DDM. La prise en charge cryptographique doit être disponible sur les deux systèmes pour pouvoir utiliser cette méthode d'authentification.

*KERBEROS

L'authentification s'effectue à l'aide de Kerberos. Le nom de la RDB doit mapper un nom principal cible dans l'environnement EIM (Enterprise Identity Mapping). Kerberos doit être configuré sur les deux systèmes pour pouvoir utiliser cette méthode d'authentification.

Remarque :La valeur suivante est prise en charge uniquement à des fins de compatibilité avec les éditions antérieures à la version 6 édition 1 modification 0 du système d'exploitation.

*ENCRYPTED

L'ID utilisateur et le mot de passe chiffré associé sont envoyés dans une demande de connexion DDM. La prise en charge cryptographique doit être disponible sur les deux systèmes pour pouvoir utiliser cette méthode d'authentification. Il est recommandé d'utiliser la valeur *USRENCPWD à la place de la valeur *ENCRYPTED.

Elément 2 : Authentific inférieure admise

Indique si une méthode d'authentification, de niveau inférieur à celui précisé dans l'élément Méthode préférée de ce paramètre, est acceptée au cours de la négociation avec le serveur. Si ce dernier est configuré pour nécessiter une méthode d'authentification d'un niveau supérieur à celui précisé pour l'élément Méthode préférée de ce paramètre et que le système demandeur d'application peut prendre en charge une méthode d'authentification de niveau supérieur, la méthode négociée peut toujours être supérieure à Méthode préférée Les méthodes d'authentification disponibles sont les suivantes, de la plus forte à la plus faible :

• *KERBEROS
• *ENCUSRPWD
• *USRENCPWD ou *ENCRYPTED
• *USRIDPWD
• *USRID

*ALWLOWER

Permet la négociation d'une méthode d'authentification de niveau inférieur à celui précisé pour l'élément Méthode préférée de ce paramètre.

*NOALWLOWER

Ne permet pas la négociation d'une méthode d'authentification de niveau inférieur à celui précisé pour l'élément Méthode préférée de ce paramètre.

Algorithme de chiffrement (ENCALG)

Indique l'algorithme de chiffrement à utiliser initialement sur une demande de connexion DDM/DRDA TCP/IP lors du chiffrement de l'ID utilisateur et du mot de passe. L'algorithme effectivement utilisé est fonction du résultat du processus de négociation entre client et serveur, ce qui dépend du support de chiffrement disponible et de la configuration de la sécurité du serveur. La commande CHGDDMTCPA (Modifier attributs TCP/IP DDM) peut être utilisée pour configurer la sécurité TCP/IP DDM/DRDA sur les systèmes i5/OS. Si *IP n'est pas indiqué pour Lieu éloigné (paramètre RMTLOCNAME), ce paramètre est ignoré. Les valeurs possibles sont :

*AES

L'algorithme de chiffrement AES (Advanced Encryption Standard) doit être utilisé initialement. Si le serveur prend en charge AES, la connexion négociera l'utilisation d'AES. Dans le cas contraire, la connexion sera refusée. Si la prise en charge d'AES par le serveur est établie, il est recommandé que l'utilisateur indique *AES pour le mot clé ENCALG de la commande ADDRDBDIRE (Ajouter poste répertoire RDB) ou de la commande CHGRDBDIRE (Modifier attributs TCP/IP DDM), ceci afin d'éviter le flux de renégociation susceptible d'être généré avec la valeur *DES.

*DES

L'algorithme de chiffrement DES (Data Encryption Standard) doit être utilisé initialement. Le paramétrage à *DES ne garantit pas que DES sera utilisé. S'il prend également en charge AES, le serveur pourra soit forcer une renégociation avec le client pour une mise à niveau vers AES, soit utiliser DES. S'il prend uniquement en charge AES, le serveur pourra soit forcer une renégociation avec le client pour une mise à niveau vers AES, soit refuser la connexion. Si la prise en charge d'AES par le serveur est établie, il est recommandé que l'utilisateur indique *AES pour le mot clé ENCALG de la commande ADDRDBDIRE (Ajouter poste répertoire RDB) ou de la commande CHGRDBDIRE (Modifier attributs TCP/IP DDM), ceci afin d'éviter le flux de renégociation susceptible d'être généré avec la valeur *DES.

Les algorithmes de chiffrement disponibles sont les suivants, le premier étant le plus fort :

• *AES
• *DES

Connexion sécurisée (SECCNN)

Indique si la couche TLS doit être utilisée sur une demande de connexion DDM/DRDA TCP/IP. Les valeurs possibles sont :

*NONE

La couche Secure Sockets Layer ne doit pas être utilisée.

*SSL

La couche TLS est utilisée. La valeur *SSL a désormais la même signification que *TLS car la couche SSL n'est plus prise en charge. Il est désormais recommandé d'utiliser la valeur *TLS à la place de la valeur *SSL.

*TLS

La couche TLS est utilisée.

Unité (DEV)

Indique la description d'unité d'APPC (Communications évoluées de programme à programme) sur ce système, correspondant à cette entrée de base de données relationnelle.

Pour plus d'informations sur les noms d'unité, consultez le manuel APPC Programming, SC41-5443.

*LOC

S'il s'agit d'APPC (Communications évoluées de programme à programme), le système indique le type de description d'unité utilisé. S'il s'agit d'APPN (Gestion de réseau paritaire), le système ne tient pas compte de ce paramètre.

nom

Indiquez un nom de description d'unité (10 caractères au maximum).

Lieu local (LCLLOCNAME)

Indique le nom du lieu local qui identifie ce système sur le système où se trouve la RDB. Le nom de lieu local doit être différent du nom de lieu éloigné.

*LOC

S'il s'agit d'APPC (Communications évoluées de programme à programme), le système indique le nom du lieu local utilisé. S'il s'agit d'APPN (Gestion de réseau paritaire), le système utilise le lieu local par défaut défini dans les attributs du réseau.

*NETATR

La valeur LCLLOCNAME indiquée dans les attributs de réseau du système est utilisée.

nom-communications

Indiquez le nom du lieu local (8 caractères au maximum).

ID éloigné réseau (RMTNETID)

Indique l'ID éloigné du réseau du système sur lequel se trouve la RDB. Si ce paramètre est indiqué, le paramètre RMTLOCNAME doit concorder avec ce paramètre RMTNETID. Si RMTLOCNAME indique un ID réseau, la valeur de ce paramètre doit être compatible. Dans le cas contraire, un message d'erreur est émis. Si RMTLOCNAME n'indique aucun ID réseau, aucun conflit n'est susceptible de se produire.

Pour plus d'informations sur les identificateurs éloignés de réseau, reportez-vous au manuel APPC Programming, SC41-5443

*LOC

S'il s'agit d'APPC (Communications évoluées de programme à programme), le système indique l'ID éloigné du réseau utilisé. S'il s'agit d'APPN (Gestion de réseau paritaire), le système utilise, pour identifier le réseau éloigné, l'ID local du réseau défini dans les attributs du réseau.

*NETATR

L'ID éloigné du réseau figurant dans les attributs du réseau est utilisé.

*NONE

Aucun ID éloigné du réseau n'est utilisé.

identificateur-réseau-éloigné

Indiquez l'ID éloigné du réseau (8 caractères au maximum).

Mode (MODE)

Indique le nom de mode à utiliser avec le nom de lieu éloigné pour communiquer avec le système sur lequel se trouve la RDB.

*NETATR

Le mode défini dans les attributs du réseau est utilisé.

BLANK

Un nom de mode ne comportant que des blancs est utilisé.

nom-communications

Indiquez un nom de mode (8 caractères au maximum).

Transaction program (TNSPGM)

Indique le nom du programme de transaction associé au poste RDB.

*DRDA

Le nom du programme de transaction, X'07F6C4C2', de DRDA (Architecture de base de données relationnelle répartie) est utilisé. DRDA est un moyen utilisé par les RDB pour communiquer entre elles sur un réseau.

nom

Indiquez le nom du programme de transaction en respectant l'un des formats suivants :

• Nom hexadécimal de 4 octets, les 8 chiffres hexadécimaux devant être placés entre guillemets simples et précédés de la lettre X. Par exemple, X'07F6C4C2' est un nom hexadécimal de 4 octets.
• Nom alphanumérique de 8 octets.

Pilote demandeur d'application (ARDPGM)

Indique le pilote de demandeur d'applications, c'est-à-dire le programme appelé pour le traitement des requêtes SQL dirigées vers la RDB. Le programme doit exister dans une bibliothèque située dans la base de données système (ASP système ou ASP utilisateur de base configuré), sur ce système et doit être de type objet *PGM.

Valeurs uniques

*DRDA

Le demandeur d'applications DRDA (Architecture de base de données relationnelle répartie) est utilisé.

Qualificatif 1 : Programme

nom

Indiquez le nom du programme pilote de demandeur d'applications à appeler pour traiter les requêtes SQL.

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 est effectuée dans la bibliothèque en cours de l'unité d'exécution. Si aucune bibliothèque n'est définie comme bibliothèque en cours pour l'unité d'exécution, la recherche porte sur la bibliothèque QGPL.

nom

Indiquez le nom de la bibliothèque contenant le programme.

Texte (TEXT)

Texte décrivant brièvement l'objet.

*BLANK

Aucun texte n'est indiqué.

valeur-alphanumérique

Indiquez un texte (50 caractères au maximum) entre guillemets simples.

Exemples

Exemple 1 : Ajout d'un poste

ADDRDBDIRE   RDB(MYRDB)  RMTLOCNAME(*LOCAL)

Cette commande permet d'ajouter un poste au répertoire des bases de données relationnelles. Ce poste identifie la base de données relationnelles locale. Dans un programme SQL, le nom de la base de données relationnelles fait référence à la base de données relationnelles locale.

Exemple 2 : Ajout d'un poste

ADDRDBDIRE   RDB(YOURRDB)  RMTLOCNAME(NEWYORK)

Cette commande permet d'ajouter un poste au répertoire des bases de données relationnelles. Ce poste identifie un lieu éloigné, NEW YORK.

Exemple 3 : Ajout d'un poste pour un programme pilote de demandeur d'applications

ADDRDBDIRE   RDB(YOURRDB)  RMTLOCNAME(*ARDPGM)
             ARDPGM(MYLIB/MYPGM)

Cette commande permet d'ajouter un poste au répertoire des bases de données relationnelles. Ce poste indique que l'accès à la base de données relationnelles YOURRDB sera effectué par un programme pilote de demandeur d'applications nommé MYPGM dans la bibliothèque MYLIB.

Exemple 4 : Ajout d'un poste pour TCP/IP

ADDRDBDIRE   RDB(TCPRDB)  RMTLOCNAME(ROCHESTER.XYZ.COM *IP)
             PORT(*DRDA)

Cette commande permet d'ajouter un poste au répertoire des bases de données relationnelles. Ce poste spécifie que la base de données relationnelles éloignée associée au nom TCPRDB utilise TCP/IP, réside sur l'hôte avec pour nom de domaine ROCHESTER.XYZ.COM et reçoit sur le port DRDA standard 446 (*DRDA étant le port par défaut, le paramètre PORT est inutile).

Exemple 5 : Ajout d'un poste pour TCP/IP avec adresse IP à notation décimale (version 4) et numéro de port numérique

ADDRDBDIRE   RDB(DB2DSYS)  RMTLOCNAME('9.5.36.17' *IP)
             PORT(5021)

Cette commande permet d'ajouter un poste au répertoire des bases de données relationnelles. Ce poste spécifie que la base de données relationnelles éloignée associée au nom DB2DSYS utilise TCP/IP, réside sur l'hôte avec adresse IP 9.5.36.17 et reçoit sur le port 5021. Une installation IBM 390 MVS, par exemple, peut comporter plusieurs sous-systèmes DB2 et TCP/IP peut prendre en charge un seul serveur sur chaque numéro de port ; des numéros de port autres que 446 sont donc parfois requis.

Exemple 6 : Ajout d'un poste pour TCP/IP avec adresse IP à notation hexadécimale à deux points (version 6) et numéro de port numérique

ADDRDBDIRE   RDB(DB2DSYS)
             RMTLOCNAME('2001:DB8:0:B33D:8785:0:1734:F51C' *IP)
             PORT(32)

Cette commande permet d'ajouter un poste au répertoire des bases de données relationnelles. Ce poste spécifie que la base de données relationnelle éloignée associée au nom DB2DSYS utilise TCP/IP, réside sur l'hôte avec adresse IP 2001:DB8:0:B33D:8785:0:1734:F51C et reçoit sur le port 32. Une installation IBM 390 MVS, par exemple, peut comporter plusieurs sous-systèmes DB2 et TCP/IP peut prendre en charge un seul serveur sur chaque numéro de port ; des numéros de port autres que 446 sont donc parfois requis.

Exemple 7 : Ajout d'un poste pour TCP/IP avec nom de service pour l'identification du port

ADDRDBDIRE   RDB(DB2ESYS)  RMTLOCNAME(ROCHESTER.XYZ.COM *IP)
             PORT(DB2ESYS_PORT)

Cette commande utilise un nom de service pour identifier le numéro de port lors de l'ajout d'un nouveau poste. Le système d'exploitation va tenter d'associer le nom DB2ESYS_PORT à un numéro de port à l'aide de la table des services TCP/IP. Pour que l'association soit correcte, un poste doit exister pour DB2ESYS_PORT dans la table des services TCP/IP. Les commandes WRKSRVTBLE ou CFGTCP peuvent être utilisées pour mettre à jour la table des services.

Messages d'erreur

*ESCAPE Messages

CPF3EC0

Poste non ajouté au répertoire des bases de données relationnelles.