CHGDDMF

La commande CHGDDMF (Modifier un fichier DDM) permet de modifier, dans la description de fichier DDM, un ou plusieurs attributs du fichier DDM indiqué. Ce fichier est utilisé à titre de référence par des programmes de l'IBM i pour accéder à des fichiers d'un système cible du réseau DDM IBM i.

Paramètres

Fichier DDM (FILE)

Indique le fichier DDM dont la description doit être modifiée.

Ce paramètre est obligatoire.

Qualificatif 1 : Fichier DDM

nom

Indiquez le nom du fichier DDM.

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

Le fichier DDM est recherché dans la bibliothèque en cours du travail. Si cette dernière n'est pas précisée, QGPL est prise par défaut.

nom

Indiquez le nom de la bibliothèque contenant le fichier DDM.

Fichier éloigné (RMTFILE)

Indique le nom du fichier éloigné tel que codé sur le système cible. Il n'est pas nécessaire que ce fichier existe lors de la modification du fichier DDM.

Remarque :Le nom de ce fichier doit être indiqué en page de codes 500.

Valeurs uniques

*SAME

Le nom du fichier éloigné n'est pas modifié.

Elément 1 : Fichier

Valeurs uniques

*NONSTD

Le nom du fichier éloigné ne correspond pas à un nom de fichier IBM i standard. Indiquez le nom de fichier complet entre apostrophes pour le deuxième élément de ce paramètre.

Qualificatif 1 : Fichier

nom

Indiquez le nom du fichier éloigné reconnu sur le système éloigné. Si ce dernier est un IBM i, indiquez le nom de fichier. Le nom de fichier ne doit pas dépasser 10 caractères. Si le système distant est un IBM 36, le nom du fichier est identique à son label de fichier IBM 36. Le nom de fichier ne doit pas dépasser huit caractères. Dans le cas d'un IBM 38, vous pouvez indiquer un nom simple (non qualifié). Le nom de fichier ne doit pas dépasser 10 caractères. Pour les labels de tous les autres systèmes éloignés (y compris les noms de fichier qualifiés IBM 38), vous devez indiquer *NONSTD, suivi du nom de fichier éloigné entre apostrophes.

Qualificateur 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

Le fichier est recherché dans la bibliothèque en cours du travail. Si cette dernière n'est pas précisée, QGPL est prise par défaut.

nom

Indique la bibliothèque contenant le fichier.

Remarque :Le nom de bibliothèque n'est utilisé que si le système cible est un IBM i.

Elément 2 : 'Nom de fichier' non-standard

valeur-alphanumérique

Lorsque vous indiquez un nom de membre pour un fichier éloigné d'un IBM i ou d'un IBM 38, ou un nom de fichier qualifié d'un IBM 38, et lorsque le système cible accepte des règles d'appellation différentes de celles utilisées sur l'IBM i et l'IBM 36, indiquez 255 caractères au maximum pour le nom du fichier éloigné auquel vous voulez accéder. Le nom doit être fourni sous une forme acceptable par le système cible. Il doit toujours figurer entre apostrophes et peut pas contenir de minuscules, de blancs, de points, ou tout autre caractère spécial.

Pour l'IBM i, l'IBM 38 et l'IBM 36, les noms doivent être en majuscules et les blancs ne sont pas admis.

Si le système cible est un IBM i ou un IBM 38, un nom de fichier, un nom de bibliothèque et un nom de membre peuvent être spécifiés. Cependant, si un nom de membre est indiqué, le nom complet du fichier devra figurer entre apostrophes et être précédé de la valeur *NONSTD ; le nom du membre devra être indiqué entre parenthèses et suivre immédiatement (sans espace) soit le nom de la bibliothèque (IBM 38), soit le nom du fichier (IBM i).

Lieu éloigné (RMTLOCNAME)

Indique le nom ou l'adresse du lieu éloigné du système éloigné (cible) utilisé(e) avec le fichier DDM. Plusieurs fichiers DDM peuvent utiliser le même lieu éloigné d'un système cible.

Valeurs uniques

*RDB

Les informations relatives au lieu éloigné extraites du poste de la base de données relationnelle indiqué pour le paramètre Base de données relationnelle (RDB) sont utilisées pour déterminer le système éloigné.

Elément 1 : Nom ou adresse

*SAME

Le nom de lieu éloigné, indiqué dans la description du fichier, ne change pas.

*DEVD

Le nom de lieu éloigné défini dans la description d'unité spécifiée pour le paramètre Unité (DEV) est utilisé.

Remarque :Si *LOC est indiqué pour le paramètre DEV, un nom de lieu éloigné doit être indiqué pour ce paramètre.

valeur-alphanumérique

Indiquez le nom ou l'adresse du lieu éloigné associé au système cible. Le lieu éloigné, qui permet l'accès au système cible, ne doit pas nécessairement exister lors de la création du fichier DDM. En revanche, il doit exister lors de l'ouverture de celui-ci. Le nom de lieu éloigné peut avoir plusieurs formats :

• Nom de lieu éloigné SNA (nom de LU). Indiquez un nom de 8 caractères au maximum. Si vous utilisez ce format, le type d'adresse de ce paramètre doit être *SNA (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 vous utilisez ce format, le type d'adresse de ce paramètre doit être *SNA (valeur par défaut) et toute valeur indiquée pour le paramètre RMTNETID doit être compatible. Si cette valeur n'est pas spécifiée, elle est définie de façon à correspondre à celle du paramètre RMTLOCNAME.
• Adresse IP en notation décimale avec 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 vous utilisez ce format, le type d'adresse de ce paramètre doit être *IP.
• Adresse IP en notation hexadécimale avec deux-points. Indiquez toute adresse IP (protocole Internet) version 6 au format xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx, où "nnn" désigne un nombre hexadécimal compris entre 0 et FFFF. Si vous utilisez ce format, le type d'adresse de ce paramètre doit être *IP. L'adresse IP version 6 inclut le format IPv6 mappé sur 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 vous utilisez ce format, le type d'adresse de ce paramètre doit être *IP.

Si *IP est indiqué comme type d'adresse, le serveur DDM situé sur le lieu éloigné doit prendre en charge TCP/IP. Les paramètres DEV, LCLLOCNAME, RMTNETID et MODE sont alors ignorés.

Si *IP n'est pas indiqué, le serveur DDM doit prendre en charge la connectivité SNA. Le paramètre PORT est alors ignoré.

Elément 2 : Type

*SAME

Le type d'adresse n'est pas modifié.

*SNA

Le lieu éloigné est associé au type d'adresse SNA.

*IP

Le lieu éloigné est associé au type d'adresse IP (Internet Protocol).

Vérification niveau de format (LVLCHK)

Indique si les identificateurs de niveau des formats d'enregistrement du fichier éloigné sont vérifiés lors de l'ouverture du fichier DDM. S'ils ne correspondent pas tous aux identificateurs de niveau du programme, un message d'erreur est envoyé au programme qui demande l'ouverture, et ni le fichier DDM, ni le fichier éloigné associé ne sont ouverts. La valeur de ce paramètre peut être substituée, au moyen de la commande OVRDBF (Substituer un fichier base de données), avant l'ouverture du fichier éloigné.

*SAME

Les identificateurs de niveau ne changent pas.

*RMTFILE

Les identificateurs de niveau des formats d'enregistrement du fichier éloigné sont vérifiés lors de l'ouverture du fichier DDM.

Remarque :Pour les systèmes autres que les IBM i, le programme doit être compilé (ou recompilé) avec le fichier DDM. Ce fichier sert à établir les communications avec le système cible, à obtenir les attributs du fichier éloigné et à créer les valeurs des identificateurs de niveau qui sont placés dans le programme compilé pour des vérifications de niveau ultérieures.

*NO

Les identificateurs de niveau ne sont pas vérifiés lors de l'ouverture du fichier.

Base de données relationnelle (RDB)

Indique le poste de la base de données relationnelle utilisé pour déterminer les informations de lieu éloigné pour le fichier DDM.

*SAME

Le poste de la base de données relationnelle n'est pas modifié.

nom

Indiquez le nom du poste de la base de données relationnelle identifiant le système cible ou le groupe d'ASP (pool de mémoire secondaire) cible. Le nom de la base de données relationnelle peut faire référence à un système distant ou à un groupe ASP distant qui est configuré et stocké sur un système distant. Le poste de la base de données relationnelle ne doit pas nécessairement exister lors de la création du fichier DDM. En revanche, il est nécessaire à l'ouverture de celui-ci. Ce paramètre est requis lorsque *RDB est utilisé comme nom de lieu éloigné (paramètre RMTLOCNAME).

Texte 'descriptif' (TEXT)

Texte décrivant brièvement l'objet.

*SAME

Le texte, s'il existe, ne change pas.

*BLANK

Aucun texte n'est indiqué.

valeur-alphanumérique

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

Unité (DEV)

Indique le nom de la description d'unité APPC, sur le système source, utilisée avec le fichier DDM.

Ce paramètre est ignoré si *IP est indiqué pour le paramètre Lieu éloigné (RMTLOCNAME).

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

*SAME

Le nom d'unité, précisé dans la description du fichier, ne change pas.

*LOC

L'unité associée au lieu éloigné est utilisée. Si plusieurs unités sont associées au lieu éloigné, c'est le système qui détermine l'unité utilisée.

Remarque :Si *DEVD est spécifié dans le paramètre RMTLOCNAME pour le lieu éloigné, un nom d'unité doit être spécifié pour ce paramètre.

nom

Indiquez le nom d'une unité de communication associée au lieu éloigné. Si ce nom d'unité n'est pas correct pour le lieu éloigné, un message d'arrêt programme sera envoyé lors de l'ouverture du fichier DDM.

Lieu local (LCLLOCNAME)

Indique le nom du lieu local.

Ce paramètre est ignoré si *IP est indiqué pour le paramètre Lieu éloigné (RMTLOCNAME).

*SAME

Le nom du lieu local spécifié dans la description du fichier n'est pas modifié.

*LOC

Le nom du lieu local associé au lieu éloigné est utilisé.

*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 à utiliser avec le nom du lieu éloigné. Ce nom sert seulement à définir un lieu local spécifique pour le lieu éloigné.

Mode (MODE)

Indique le nom de mode utilisé avec le nom du lieu éloigné pour communiquer avec le système cible.

Ce paramètre est ignoré si *IP est indiqué pour le paramètre Lieu éloigné (RMTLOCNAME).

Pour plus d'informations sur les noms de mode, reportez-vous au manuel APPC Programming, SC41-5443.

*SAME

Le nom de mode n'est pas modifié.

*NETATR

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

BLANK

Un nom de mode composé de 8 blancs est utilisé.

nom-communications

Indiquez le nom du mode utilisé. Si ce nom n'est correct pour aucune combinaison de lieu local et éloigné, un message d'arrêt programme est envoyé lors de l'ouverture du fichier DDM.

ID éloigné réseau (RMTNETID)

Indique l'ID éloigné de réseau, dont fait partie le lieu éloigné, utilisé pour communiquer avec le système cible.

Si ce paramètre est indiqué, la valeur du paramètre Lieu éloigné (RMTLOCNAME) doit être cohérente avec celle du 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.

Ce paramètre est ignoré si *IP est indiqué pour le paramètre RMTLOCNAME.

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

*SAME

L'ID éloigné de réseau, spécifié dans la description du fichier, ne change pas.

*LOC

L'ID éloigné de réseau, associé au lieu éloigné, est utilisé.

*NETATR

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

*NONE

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

nom-communications

Indiquez, si besoin est, l'ID éloigné de réseau à associer au lieu éloigné. Si l'ID éloigné de réseau n'est pas correct pour le lieu éloigné, un message d'arrêt programme sera envoyé lors de l'ouverture du fichier DDM.

Numéro port (PORT)

Indique le port TCP/IP utilisé sur le lieu éloigné pour communiquer avec le système sur lequel réside le fichier éloigné.

Ce paramètre est ignoré si *SNA est indiqué pour le paramètre Lieu éloigné (RMTLOCNAME).

*SAME

La valeur ne change pas.

*DRDA

Le port connu DRDA 446 est utilisé. Il s'agit du port via lequel le serveur IBM i DDM TCP/IP fonctionne en mode écoute.

1-65535

Indiquez un numéro de port.

Méthode d'accès (ACCMTH)

Indique la méthode d'accès DDM utilisée pour ouvrir le fichier éloigné et accéder à ses enregistrements lorsque le système cible n'est pas un IBM i. Toute autre valeur que *RMTFILE pour ce paramètre peut également améliorer les performances de traitement des requêtes sur les fichiers cibles. Ce paramètre est ignoré lorsque le système cible est un IBM i ou un IBM 38. L'accès au fichier d'un système éloigné s'effectue comme pour un fichier local.

Valeurs uniques

*SAME

La méthode d'accès ne change pas.

*RMTFILE

Le système source sélectionne la méthode d'accès compatible avec (1) les attributs du fichier éloigné identifié par le paramètre Fichier éloigné (RMTFILE) et (2) les méthodes d'accès acceptées par le système cible pour ce fichier. Pour les systèmes cible autres que les IBM i, si cette valeur est utilisée et que le système source ne peut pas sélectionner de méthode d'accès lors de l'ouverture du fichier, un message est envoyé à l'utilisateur.

*COMBINED

C'est la méthode d'accès combiné DDM qui est utilisée. Elle regroupe les possibilités de traitement de fichier des méthodes d'accès combiné par clé (*KEYED *BOTH) et d'accès combiné par numéro d'enregistrement (*ARRIVAL *BOTH), comme indiqué dans la table suivante. L'enregistrement peut être sélectionné à l'aide d'une valeur de clé ou d'un numéro d'enregistrement. Cette position permet la définition relative ou aléatoire de la position par valeur de clé ou par numéro d'enregistrement. Si le fichier comporte des clés en double, celles-ci sont traitées dans l'ordre défini par la mise en oeuvre de l'architecture DDM par chaque système cible.

Elément 1 : Attribut du fichier éloigné

*KEYED

Le fichier éloigné est un fichier avec clé.

*ARRIVAL

Le fichier éloigné n'est pas un fichier avec clé.

Elément 2 : Méthode d'accès locale

*BOTH

Le fichier éloigné admet l'accès séquentiel et aléatoire aux enregistrements.

*RANDOM

Le fichier éloigné admet l'accès aléatoire aux enregistrements.

*SEQUENTIAL

Le fichier éloigné admet l'accès séquentiel aux enregistrements.

Détermination de la méthode d'accès

Les deux éléments de ce paramètre indiquent la méthode d'accès à utiliser pour accéder au fichier éloigné. Le tableau qui suit indique les combinaisons de valeurs possibles du paramètre ACCMTH. Les attributs du fichier éloigné (dans la colonne de gauche) désignent le type de fichier du système cible. La méthode d'accès locale (dans les trois dernières colonnes) désigne la méthode d'accès du programme IBM i source aux enregistrements du fichier éloigné.

Attributs               Méthode d'accès locale
Fichier
éloigné        *SEQUENTIAL     *RANDOM         *BOTH
----------     ------------    ------------    ------------
*ARRIVAL       Relative par    Aléatoire par   Regroupement par
               num. d'enreg.   num. d'enreg.   num. d'enreg.
*KEYED         Relative par    Aléatoire par   Regroupement par
               clé             clé             clé

Méthode d'accès Relative par numéro d'enregistrement (*ARRIVAL *SEQUENTIAL) :

Cette méthode permet d'accéder aux enregistrements par rapport à la position en cours dans l'ordre des numéros d'enregistrement. Le numéro d'enregistrement n'est pas spécifié pour l'identification de l'enregistrement.

Méthode d'accès Aléatoire par numéro d'enregistrement (*ARRIVAL *RANDOM) :

Cette méthode permet d'accéder aux enregistrements via l'indication d'un numéro d'enregistrement dans un ordre aléatoire déterminé par le demandeur.

Méthode d'accès Regroupement par numéro d'enregistrement (*ARRIVAL *BOTH) :

Cette méthode combine les fonctions des méthodes d'accès Relative par numéro d'enregistrement et Aléatoire par numéro d'enregistrement.

Méthode d'accès Relative par clé (*KEYED *SEQUENTIAL) :

Cette méthode permet d'accéder aux enregistrements d'un fichier avec clé dans l'ordre des valeurs de clés. Vous pouvez accéder aux enregistrements en vous déplaçant vers l'avant ou vers l'arrière dans la séquence de clés à partir de l'enregistrement en cours. La valeur de clé n'est pas spécifiée pour l'identification de l'enregistrement.

Méthode d'accès Aléatoire par clé (*KEYED *RANDOM) :

Cette méthode permet d'accéder aux enregistrements d'un fichier avec clé dans un ordre aléatoire. Les enregistrements sont sélectionnés par leur valeur de clé et non par leur position dans le fichier.

Méthode d'accès Regroupement par clé (*KEYED *BOTH) :

Cette méthode combine les fonctions des méthodes d'accès Relative par clé et Aléatoire par clé.

Partage chemin d'ouverture (SHARE)

Indique si le chemin d'ouverture (ODP) est partagé avec d'autres programmes dans la même phase d'activation. Dans l'affirmative, les programmes accédant au fichier partagent des fonctions telles que l'état du fichier et la mémoire tampon.

*SAME

La valeur ne change pas.

*NO

Le chemin d'ouverture (ODP) n'est pas partagé avec d'autres programmes au cours de cette phase d'activation. Un nouvel ODP est créé pour le fichier et utilisé chaque fois qu'un programme ouvre ce fichier.

*YES

Le même chemin d'ouverture est partagé par tous les programmes du travail pour lequel *YES a été également indiqué lors de l'ouverture du fichier.

Conversation protégée (PTCCNV)

Indique si la conversation DDM démarrée pour le fichier DDM est protégée ou non. Une conversation protégée utilise des protocoles de validation à deux phases pour assurer, même en cas de défaillance, la synchronisation des mises à jour effectuées sur le système éloigné avec celles apportées à d'autres ressources locales ou éloignées. Une conversation de ce type est requise pour l'utilisation d'un contrôle de validation à deux phases avec DDM. La validation à deux phases n'est pas implémentée via TCP/IP pour les fichiers DDM hors base de données relationnelle. Par conséquent, les conversations protégées ne sont pas prises en charge lorsque le type d'emplacement éloigné est *IP. La validation à deux phases est implémentée via TCP/IP pour les fichier DDM de base de données relationnelle. Si une conversation protégée est requise lorsque le type d'emplacement éloigné est *IP, spécifiez PTCCNV(*YES) avec un nom d'emplacement éloigné *RDB pour le paramètre RMTLOCNAME et une base de données relationnelle pour le paramètre RDB. Pour plus d'informations à ce sujet, reportez-vous au manuel Rubriques Programmation d'une base de données répartie de l'IBM i Information Center (http://www.ibm.com/systems/i/infocenter/). Vous devez indiquer PTCCNV(*NO) si la valeur *IP est définie pour le paramètre Lieu éloigné (RMTLOCNAME).

*SAME

La valeur reste inchangée.

*NO

La conversation DDM démarrée à l'aide de ce fichier DDM n'est pas protégée.

*YES

La conversation DDM démarrée à l'aide de ce fichier DDM est protégée. Un contrôle de validation à deux phases peut être utilisé avec ce fichier DDM.

Exemples

Les exemples ci-dessous décrivent la modification d'un fichier DDM.

Exemple 1 : Modification du système de mode de communication

CHGDDMF   FILE(SOURCE/SALES)  MODE(MODEX)

Cette commande permet de modifier le mode de communication du fichier DDM SALES qui est stocké dans la bibliothèque SOURCE du système source. Le mode est modifié en MODEX.

Exemple 2 : Modification d'un fichier DDM pour accès à un fichier via TCP/IP

CHGDDMF   FILE(OTHER/SALES)  RMTLOCNAME(ROCHESTER.XYZ.COM *IP)
          PORT(*DRDA)

Cette commande permet de modifier le nom de lieu éloigné du fichier DDM intitulé SALES qui est stocké dans la bibliothèque OTHER du système source. Le lieu éloigné est remplacé par l'hôte TCP/IP dont le nom de domaine est ROCHESTER.XYZ.COM. L'hôte est en mode écoute sur le port DRDA numéro 446.

Exemple 3: Modification d'un fichier DDM pour accès à un fichier via TCP/IP à l'aide d'une adresse IP en notation décimale à point (version 4) et d'un numéro de port numérique

CHGDDMF   FILE(OTHER/SALES)  RMTLOCNAME('9.5.36.17' *IP)
          PORT(5021)

Cette commande permet de modifier le nom de lieu éloigné du fichier DDM intitulé SALES qui est stocké dans la bibliothèque OTHER du système source. Le lieu éloigné est remplacé par l'hôte TCP/IP dont l'adresse IP est 9.5.36.17. L'hôte est en mode écoute sur le port 5021.

Exemple 4: Modification d'un fichier DDM pour accès à un fichier via TCP/IP à l'aide d'une adresse IP en notation hexadécimale à deux-points (version 6) et d'un numéro de port numérique

CHGDDMF   FILE(OTHER/SALES)
          RMTLOCNAME('2001:DB8:0:B33D:8785:0:1734:F51C'
          *IP) PORT(32)

Cette commande permet de modifier le nom de lieu éloigné du fichier DDM intitulé SALES qui est stocké dans la bibliothèque OTHER du système source. Le lieu éloigné est remplacé par l'hôte TCP/IP dont l'adresse IP est 2001:DB8:0:B33D:8785:0:1734:F51C. L'hôte est en mode écoute sur le port 32.

Messages d'erreur

*ESCAPE Messages

CPF7304

Fichier &1 de &2 non modifié.