CRTDDMF

La commande CRTDDMF (Créer un fichier DDM) permet de créer un fichier DDM.

Un fichier DDM est un fichier de référence permettant d'accéder à un fichier situé sur un système éloigné (cible) d'un réseau DDM. Il contient le nom du fichier éloigné et un certain nombre d'informations identifiant le système éloigné. Il indique aussi la méthode d'accès utilisée.

Paramètres

Fichier DDM (FILE)

Indique le fichier DDM à créer.

Ce paramètre est obligatoire.

Qualificatif 1 : Fichier DDM

nom

Indiquez le nom du fichier DDM à créer.

Qualificateur 2 : Biblio

*CURLIB

Le fichier DDM est recherché dans la bibliothèque en cours pour le travail. Si celle-ci n'est pas précisée, c'est QGPL qui sera utilisée.

nom

Indiquez la bibliothèque dans laquelle figure le fichier DDM.

Fichier éloigné (RMTFILE)

Indique le nom du fichier éloigné tel que codé sur le système cible. Le nom de ce fichier doit être indiqué en page de codes 500. Il n'est pas nécessaire que ce fichier existe lors de la création du fichier DDM.

Ce paramètre est obligatoire.

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. Si *CURLIB est indiqué, le fichier est recherché dans la bibliothèque en cours du travail appelé sur le système cible. Si la bibliothèque a pour valeur *LIBL, le fichier est recherché dans la liste des bibliothèques du travail appelé sur le système cible.

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. Il n'est pas nécessaire de définir ce nom ou cette adresse avant de créer le fichier DDM. En revanche, il faut le faire avant l'ouverture de ce dernier. Plusieurs fichiers DDM peuvent utiliser le même lieu éloigné d'un système cible.

Ce paramètre est obligatoire.

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

*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

*SNA

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

*IP

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

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

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.

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 obligatoire lorsque *RDB est indiqué pour le paramètre Lieu éloigné (RMTLOCNAME).

Texte 'descriptif' (TEXT)

Texte décrivant brièvement l'objet.

*BLANK

Aucun texte n'est indiqué.

valeur-alphanumérique

Entrez, entre apostrophes, un texte de 50 caractères au maximum.

Unité (DEV)

Indique le nom que possède, sur le système source, l'unité de communication utilisée avec ce fichier DDM.

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

*LOC

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

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).

*LOC

Le nom du lieu local spécifié pour le lieu éloigné est utilisé.

*NETATR

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

nom-communications

Si nécessaire, spécifiez le nom du lieu local utilisé avec le nom du lieu éloigné. Ce nom sert seulement à définir un lieu local spécifique pour le lieu éloigné.

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

Mode (MODE)

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

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

*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.

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

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 éloigné (cible).

Si ce paramètre est indiqué, le paramètre Lieu éloigné (RMTLOCNAME) doit être cohérent 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.

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

*LOC

L'ID éloigné de réseau indiqué pour le 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 l'ID éloigné de réseau utilisé avec le nom du lieu éloigné. Cet identificateur ne doit être précisé que dans un cas spécifique.

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

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).

*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 le numéro de port à utiliser.

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. Ce paramètre n'est pas pris en compte si le système éloigné (cible) est un IBM 38 ou un IBM i.

*RMTFILE

Le système source sélectionne la méthode d'accès compatible avec le fichier éloigné concerné et les méthodes d'accès supportées par le système éloigné (cible) de ce fichier. Pour les systèmes cible autres que l'IBM i et l'IBM 38, 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 du programme. Une autre valeur doit être indiquée pour ce paramètre à l'aide de la commande CHGDDMF, une fois que les informations relatives à la méthode d'accès appropriée au fichier ont été fournies par un responsable au niveau du système cible.

*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). L'enregistrement peut être sélectionné à l'aide d'une valeur de clé ou d'un numéro d'enregistrement. La position peut être ensuite définie de façon relative ou aléatoire 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.

*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).

*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.

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 par un programme. Si tel est le cas, les identificateurs de format d'enregistrement du programme doivent concorder avec ceux du fichier éloigné. Sinon, un message d'erreur est envoyé au programme demandeur et ni le fichier DDM ni le fichier éloigné associé n'est ouvert. Les fichiers objet d'une erreur lors de leur ouverture sont refermés automatiquement. Ce paramètre peut être substitué par une commande OVRDBF (Substituer un fichier base de données) avant l'ouverture du fichier éloigné.

*RMTFILE

Les identificateurs de niveau des formats d'enregistrement du fichier éloigné (identifié dans le paramètre RMTFILE) sont vérifiés lors de l'ouverture du fichier DDM.

Si le système cible n'est pas un IBM i ni un IBM 38, l'IBM i source crée une valeur de vérification de niveau en fonction de la longueur d'enregistrement du fichier éloigné et des zones clés que celui-ci comporte. Les valeurs créées sont ensuite comparées aux valeurs du programme ; elles doivent concorder avant l'ouverture du fichier éloigné. Cela réduit les risques de sélection du fichier incorrect.

Remarque :Avant d'effectuer cette opération pour un système autre qu'un IBM i ou un IBM 38, le programme doit être compilé (ou recompilé) avec le fichier DDM. Lors de la compilation, le fichier DDM permet d'établir des communications avec le système cible, d'accéder aux attributs du fichier éloigné à partir du système cible et de générer les valeurs d'identificateur de niveau de sorte que celles-ci puissent être incluses dans le programme compilé à des fins de vérification de niveau ultérieure.

*NO

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

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.

Remarque :Sur le système cible, le droit d'accès au fichier éloigné est également vérifié à l'aide du profil utilisateur du travail lancé sur ce système.

*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. Les droits sur l'objet définis dans cette liste sont accordés aux utilisateurs figurant sur celle-ci. La liste d'autorisation doit exister à la création de l'objet.

Remplacer fichier (REPLACE)

Indique si un fichier existant, autre qu'un fichier sauvegarde ou base de données, est remplacé.

*YES

Un fichier existant est remplacé si la création d'un nouveau fichier DDM de même nom et appartenant à la même bibliothèque a réussi.

*NO

La création d'un nouveau fichier DDM n'est pas permise si un fichier existant porte le même nom et appartient à la même bibliothèque.

Exemples

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

Exemple 1: Création d'un fichier DDM pour accéder à un fichier sur un autre IBM i

CRTDDMF   FILE(SOURCE/SALES)  RMTFILE(REMOTE/SALES)
          RMTLOCNAME(NEWYORK)

Cette commande permet de créer un fichier DDM appelé SALES et de stocker celui-ci dans la bibliothèque SOURCE du système source. Ce fichier DDM utilise le lieu éloigné NEWYORK pour accéder à un fichier éloigné appelé SALES stocké dans la bibliothèque REMOTE sur un IBM i situé à New York.

Exemple 2: Création d'un fichier DDM pour accéder à un membre de fichier sur un autre IBM i

CRTDDMF   FILE(SOURCE/SALES)  RMTLOCNAME(NEWYORK)
          RMTFILE(*NONSTD 'REMOTE/SALES(APRIL)')

Cette commande permet de créer le même fichier que dans l'exemple précédent, à ceci près qu'il accède désormais à un membre spécifique du fichier SALES éloigné ; ce membre est appelé APRIL.

Exemple 3 : Création d'un fichier DDM pour accès à un fichier sur un IBM 38

CRTDDMF   FILE(OTHER/SALES)  RMTLOCNAME(CHICAGO)
          RMTFILE(*NONSTD 'PAYROLL.REMOTE')

Cette commande permet de créer un fichier DDM appelé SALES et de stocker celui-ci dans la bibliothèque OTHER du système source. Le lieu éloigné CHICAGO est utilisé par le fichier DDM pour accéder à un fichier éloigné appelé PAYROLL dans la bibliothèque REMOTE d'un IBM 38.

Exemple 4 : Création d'un fichier DDM pour accès à un fichier sur un IBM 36

CRTDDMF   FILE(OTHER/SALES)  RMTFILE(PAYROLL)
          RMTLOCNAME(DENVER)  LVLCHK(*NO)

Cette commande permet de créer un fichier DDM appelé SALES et de stocker celui-ci dans la bibliothèque OTHER du système source. Le lieu éloigné DENVER est utilisé par le fichier DDM pour accéder à un fichier éloigné appelé PAYROLL sur un IBM 36 à Denver. Aucune vérification de niveau n'est effectuée entre le fichier PAYROLL et les programmes d'application qui accèdent à ce fichier. Dans la mesure où le paramètre ACCMTH n'a pas été indiqué, la méthode d'accès au système cible est sélectionnée par le système source lorsque le fichier DDM est ouvert pour l'accès au fichier éloigné.

Exemple 5 : Création d'un fichier DDM pour accès à un fichier via TCP/IP

CRTDDMF   FILE(OTHER/SALES)  RMTFILE(PAYROLL)
          RMTLOCNAME(ROCHESTER.XYZ.COM *IP) PORT(*DRDA)

Cette commande permet de créer un fichier DDM appelé SALES et de stocker celui-ci dans la bibliothèque OTHER du système source. Le lieu éloigné ROCHESTER.XYZ.COM est utilisé par le fichier DDM pour accéder à un fichier éloigné appelé PAYROLL sur un 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. (Dans la mesure où *DRDA correspond au port par défaut, le paramètre PORT n'est pas réellement nécessaire dans ce cas.)

Exemple 6: Création 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

CRTDDMF   FILE(OTHER/SALES)  RMTFILE(PAYROLL)
          RMTLOCNAME('9.5.36.17' *IP)  PORT(5021)

Cette commande permet de créer un fichier DDM appelé SALES et de stocker celui-ci dans la bibliothèque OTHER du système source. Le lieu éloigné 9.5.36.17 est utilisé par le fichier DDM pour accéder à un fichier éloigné appelé PAYROLL sur un 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 7: Création 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

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

Cette commande permet de créer un fichier DDM appelé SALES et de stocker celui-ci dans la bibliothèque OTHER du système source. The remote location Le lieu éloigné 2001:DB8:0:B33D:8785:0:1734:F51C est utilisé par le fichier DDM pour accéder à un fichier éloigné nommé PAYROLL sur un 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

CPF7302

Fichier &1 non créé dans la bibliothèque &2.