ADDLFM

La commande ADDLFM (Ajouter un membre de fichier logique) permet d'ajouter un membre à un fichier logique existant déjà sur le système. Le nombre maximal de membres pouvant être ajoutés à ce fichier est spécifié dans le paramètre Nombre maximal de membres (MAXMBRS) de la commande CRTLF (Créer un fichier logique) ou de la commande CHGLF (Modifier un fichier logique). Pour ajouter d'autres membres dans le fichier, utilisez la commande ADDLFM pour chacun d'entre eux.

Un membre de fichier logique peut utiliser les données de l'ensemble ou d'un sous-ensemble de fichiers physiques référencés par le fichier logique. Chaque membre dispose de son propre ensemble de données et de son propre chemin d'accès à ces données. Le système tente le partage implicite d'un chemin d'accès figurant déjà sur le système.

Chaque membre ajouté comporte les mêmes attributs que ceux définis dans le fichier logique.

Restrictions :

• Pour pouvoir ajouter un membre à un fichier logique à clés, vous devez disposer du droit d'exécution (*OBJOPR) et des droits de gestion (*OBJMGT) ou de modification (*OBJALTER) sur chaque fichier physique sur lequel est basé le membre de fichier logique. (Ces droits doivent être indiqués explicitement par le paramètre DTAMBRS, ou implicitement, par le mot clé PFILE ou JFILE spécifié dans les DDS).
• Si le membre est ajouté à un fichier logique qui n'est pas à clés, seul le droit *OBJOPR est requis sur chaque fichier physique.
• Cette commande est à unités d'exécution protégées sous certaines conditions. Dans le cas de travaux à unités d'exécution multiples, cette commande n'admet pas l'utilisation d'unités d'exécution multiples pour les fichiers répartis utilisant une base de données relationnelle de type *SNA. En outre, elle n'admet pas l'utilisation d'unités d'exécution protégées pour les fichiers DDM (Gestion de fichiers éloignés) de type *SNA lorsque SYSTEM(*RMT) ou SYSTEM(*FILETYPE) est indiqué.

Remarque :Un verrouillage *EXCLRD du fichier est nécessaire pour pouvoir ajouter un membre. Dans la mesure où cette commande permet d'ajouter un membre dans un fichier d'une bibliothèque, cette dernière ne doit pas être verrouillée (*SHRNUP ou *EXCLRD indiqué dans la commande ALCOBJ (Allouer un objet)) dans un autre travail.

Paramètres

Fichier logique (FILE)

Indique le fichier logique dans lequel le membre doit être ajouté.

Ce paramètre est obligatoire.

Qualificatif 1 : Fichier logique

nom

Indiquez le nom du fichier logique.

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 logique 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 la bibliothèque contenant le fichier logique.

Membre de fichier logique (MBR)

Indique le membre de fichier logique à ajouter. Ce nom doit être unique dans le fichier.

Si le paramètre FILE indique un fichier DDM et qu'un nom de membre est indiqué dans le cadre du nom de fichier éloigné du fichier DDM, les noms de membre doivent être identiques.

Ce paramètre est obligatoire.

nom

Entrez le nom du membre de fichier logique à ajouter.

Membres données de fich phys (DTAMBRS)

Indique les fichiers physiques et les membres qui contiennent les données associées au membre de fichier logique à ajouter par cette commande. Un membre de fichier logique peut être basé sur tous (*ALL) les fichiers physiques et les membres sur lesquels le fichier logique proprement dit est basé, ou bien le membre peut être basé sur un sous-ensemble des fichiers et des membres.

Remarque :Lors de l'ajout d'un membre dans un fichier logique de type DDM, le fichier physique, s'il est spécifié, doit également être un fichier DDM et ses bibliothèque et membre(s) doivent être précisés explicitement. Le paramètre *CURRENT n'est pas pris en charge avec un fichier logique de type DDM.

Lors de la création d'un fichier logique, les fichiers physiques indiqués pour le mot clé DDS PFILE ou JFILE sont utilisés pour créer le fichier logique. Si aucun nom de bibliothèque n'est indiqué pour les fichiers physiques du mot clé PFILE ou JFILE, la liste des bibliothèques (*LIBL) existant lors de la création du fichier permet de rechercher les fichiers physiques ; les fichiers physiques de la liste des bibliothèques permettent de créer le fichier logique. Les fichiers physiques qualifiés du mot clé PFILE ou JFILE (indépendamment du fait qu'un nom de bibliothèque a été indiqué ou si la liste des bibliothèques a permis de rechercher les fichiers) sont les fichiers physiques associés au fichier logique. Les noms des fichiers physiques associés au fichier logique sont sauvegardés dans la description du fichier logique. Lors de l'ajout d'un membre dans le fichier logique, le paramètre DTAMBRS permet d'indiquer les membres de fichier physique associés au membre du fichier logique. Chaque nom de fichier physique indiqué au paramètre DTAMBRS doit correspondre au nom d'un fichier physique associé au fichier logique (sauvegardé dans la description du fichier logique).

Valeurs uniques

*ALL

Le membre de fichier logique à ajouter est basé sur tous les fichiers physiques et membres (qui existent lors de l'entrée de cette commande CRTLF) utilisés par le fichier logique. Au moins un membre doit exister dans au moins un des fichiers physiques. Les noms de fichier physique sont indiqués pour le paramètre PFILE ou JFILE des DDS.

Elément 1 : Fichier physique

Qualificatif 1 : Fichier physique

nom

Indiquez les noms des fichiers physiques qui contiennent les données accessibles au membre de fichier logique à ajouter.

Les noms de fichier physique doivent correspondre à un nom figurant dans les mots clés PFILE ou JFILE des DDS et ne peuvent pas être indiqués plus souvent au paramètre DTAMBRS que sur les mots clés PFILE ou JFILE des DDS. En ce qui concerne les fichiers logiques joints, tous les fichiers physiques du mot clé JFILE doivent être indiqués pour le paramètre DTAMBRS et chaque fichier physique doit comporter un seul membre. Si aucun nom n'est indiqué pour un fichier physique figurant sur un mot clé PFILE ou JFILE des DDS, le membre de fichier logique n'est basé sur aucun membre du fichier physique.

Qualificatif 2 : Biblio

*CURRENT

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

Si aucun nom de bibliothèque n'est indiqué, le nom de bibliothèque en cours (*CURRENT) de la description du fichier logique est utilisé. Si le nom de bibliothèque est indiqué, le fichier physique doit correspondre à un fichier physique associé au fichier logique. Si ce dernier est associé à plusieurs fichiers physiques du même nom, le nom de bibliothèque doit être indiqué.

nom

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

Elément 2 : Membre

Valeurs uniques

*NONE

Aucun nom de membre n'est indiqué.

Autres valeurs (jusqu'à 32 répétitions)

nom

Indiquez les noms des membres de fichiers physiques qui contiennent les données accessibles au membre de fichier logique à ajouter.

Lorsque le paramètre FILE indique un fichier logique joint ou un fichier logique d'accès par ordre d'arrivée, un seul membre de données doit être indiqué dans le paramètre DTAMBRS pour chaque fichier physique qui a été spécifié pour le mot clé PFILE ou JFILE des DDS. *ALL ne s'applique que si chaque fichier physique sous-jacent ne comporte qu'un seul membre. Si l'un des fichiers physiques comporte plusieurs membres, le membre spécifique doit être indiqué pour le paramètre DTAMBRS.

Un même nom de fichier physique peut être indiqué plusieurs fois pour le mot clé JFILE. Dans ce cas, chaque occurrence du nom de fichier est traitée comme un autre fichier physique sous-jacent et doit être indiquée pour le paramètre DTAMBRS.

Jusqu'à 32 noms de fichier physique qualifiés et noms de membre de fichier physique peuvent être indiqués. Le nombre total des noms de membre ne peut pas être supérieur à 32. Par exemple, un fichier peut spécifier 32 membres, deux fichiers peuvent comporter 16 membres par fichier, ou bien un membre peut être indiqué pour chacun des 32 fichiers.

Pour le fichier DDM :

• Les noms de fichier indiqués au paramètre DTAMBRS doivent correspondre aux noms des fichiers DDM qui représentent les fichiers physiques sous-jacents éloignés. Si un nom de membre a été indiqué dans le cadre du nom de fichier éloigné dans le fichier DDM, seul ce nom de membre peut être indiqué pour le paramètre DTAMBRS. Les noms de membre doivent correspondre aux noms réels des membres de fichier éloigné.
• Les fichiers physiques sous-jacents doivent figurer sur le même lieu système que le fichier logique auquel le membre est ajouté.
• Lorsqu'aucun nom de membre n'est indiqué pour le nom de fichier éloigné dans le fichier DDM, tous les membres sont accessibles. Lorsqu'un seul nom de membre est indiqué, seul ce membre est accessible via le fichier DDM.

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.

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.

Exemples

ADDLFM   FILE(INVENLIB/STOCKTXS)  MBR(JANUARY)
         DTAMBRS((INVENTXS (JANUARY)))
         TEXT('JANUARY STOCK ACTIVITY BY LOCATION')

Cette commande permet d'ajouter un membre appelé JANUARY au fichier logique STOCKTXS de la bibliothèque INVENLIB. Le fichier logique a accès aux données stockées dans le membre JANUARY du fichier physique INVENTXS.

Messages d'erreur

*ESCAPE Messages

CPF3204

Objet nécessaire au traitement du fichier &1 de &2 introuvable.

CPF7306

Membre &1 non ajouté au fichier &2 de &3.