ADDPFM

La commande ADDPFM (Ajouter un membre de fichier physique) permet d'ajouter un membre à un fichier physique existant déjà sur le système. Le nombre maximal de membres pouvant être ajoutés au fichier est indiqué dans le paramètre Nombre maximal de membres (MAXMBRS) de la commande CRTPF (Créer un fichier physique) ou CHGPF (Modifier un fichier physique). Pour ajouter d'autres membres dans le fichier, utilisez la commande ADDPFM pour chacun d'entre eux.

Le nombre de membres pouvant être ajoutés dans le fichier physique est limité au nombre indiqué pour le paramètre MAXMBRS de la commande CRTPF associée. Chaque membre ajouté possède les mêmes attributs que ceux définis dans le fichier physique, dans son propre ensemble d'enregistrements de données et son propre chemin d'accès aux données, comme indiqués dans les spécifications de description de données (DDS). Le chemin d'accès détermine l'ordre de traitement des enregistrements de ce membre.

Restrictions :

• 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)) par un autre travail.

Paramètres

Fichier physique (FILE)

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

Ce paramètre est obligatoire.

Qualificatif 1 : Fichier physique

nom

Indiquez le nom du fichier physique.

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

Membre (MBR)

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

Si un fichier DDM est indiqué pour le paramètre FILE et qu'un nom de membre est spécifié dans le cadre du nom de fichier éloigné du fichier DDM, le nom MBR indiqué doit correspondre au nom de membre du nom de fichier éloigné du fichier DDM.

Ce paramètre est obligatoire.

nom

Entrez le nom du membre de fichier à ajouter.

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.

Date d'expiration du membre (EXPDATE)

Indique la date de péremption du membre de fichier physique.

*NONE

Aucune date d'expiration n'est spécifiée.

date

Indiquez la date après laquelle le membre de fichier ne pourra plus être utilisé. Cette date doit être indiquée entre apostrophes si des caractères de séparateur de date sont utilisées dans la valeur.

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.

Type de source (SRCTYPE)

Indique l'attribut de type source à affecter au nouveau membre. Un type source ne peut être indiqué que si le fichier physique a été créé à l'aide de la commande CRTSRCPF (Créer un fichier source) ou à l'aide de la commande CRTPF (Créer un fichier physique) lorsque *SRC est indiqué pour le paramètre Type de fichier (FILETYPE).

*NONE

Aucun type de source n'est indiqué.

valeur-alphanumérique

Indiquez le type source du membre de fichier. Cette valeur est une chaîne de 10 caractères maximum. Le premier caractère doit être alphabétique (caractères $, à et # compris). Les caractères suivants doivent être des caractères alphanumériques ou des traits de soulignement.

Exemples

ADDPFM   FILE(INVENTX)  MBR(MONDAYTX)
         TEXT('Opérations d'inventaire du lundi')

Cette commande permet d'ajouter un membre appelé MONDAYTX au fichier physique INVENTX. Le fichier est recherché dans la liste de bibliothèques (*LIBL) car la valeur de FILE n'est pas qualifiée par un nom de bibliothèque. La taille du membre et les valeurs d'allocation de mémoire attribuées à ce membre ont été indiquées dans la commande CRTPF qui a créé le fichier physique. Le texte, Opérations d'inventaire du lundi, décrit ce membre du fichier INVENTX.

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.