INZPFM

Initialiser membre de fichier

En bref

INZPFM se lit INZ (Initialiser) + PFM. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

INZPFM FILE(…)

Paramètres

FILE Fichier physique obligatoire
MBR Membre
RECORDS Option d'initialisation enreg
TOTRCDS Nombre total d'enregistrements

Astuce : dans une session 5250, tapez INZPFM puis F4 pour l'invite de saisie, et F1 sur un paramètre pour son aide.

Aide IBM i de la commande

Texte du F1, IBM i 7.5 en français (bibliothèque QSYS)

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Sous conditions

La commande INZPFM (Initialiser un membre de fichier physique) permet d'initialiser les enregistrements d'un membre de fichier physique conformément au type d'enregistrement indiqué (enregistrements par défaut ou supprimés). Si le membre qui doit être initialisé est vide, des enregistrements sont ajoutés et initialisés conformément au type d'enregistrement indiqué ; dans le cas contraire, les enregistrements qui sont ajoutés correspondent au type indiqué. Il est ajouté autant d'enregistrements qu'il est nécessaire pour atteindre le nombre total d'enregistrements indiqué.

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 DDM (Gestion de fichiers éloignés) de type *SNA.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
FILE	Fichier physique	Nom d'objet qualifié	Obligatoire, positionnel 1
	Qualificatif 1: Fichier physique	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
MBR	Membre	Nom, FIRST, LAST	Facultatif, positionnel 2
RECORDS	Option d'initialisation enreg	DFT, DLT	Facultatif, positionnel 3
TOTRCDS	Nombre total d'enregistrements	1-4294967288, *NXTINCR	Facultatif

Fichier physique (FILE)

Indique le fichier physique contenant le membre à initialiser.

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 est recherché dans la bibliothèque en cours du travail. Si celle-ci n'est pas précisée, QGPL est prise par défaut.

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

Membre (MBR)

Indique le membre de fichier à initialiser.

*FIRST: Le premier membre du fichier indiqué est utilisé.

*LAST: Initialise le dernier membre du fichier physique indiqué.
nom: Entrez le nom du membre de fichier physique à initialiser.

Option d'initialisation enreg (RECORDS)

Indique le type d'enregistrements à initialiser ou ajouter au membre indiqué. Les enregistrements du membre sont initialisés sous la forme d'enregistrements par défaut ou supprimés.

*DFT: Les enregistrements du membre sont initialisés sous la forme d'enregistrements par défaut. Si une valeur par défaut a été indiquée pour une zone dans les DDS (mot clé DFT), cette zone est initialisée conformément à cette valeur ; dans le cas contraire, toutes les zones numériques sont initialisées avec des zéros et toutes les zones alphanumériques sont initialisées avec des blancs.
*DLT: Les enregistrements du membre sont initialisés sous la forme d'enregistrements supprimés. Il n'est pas possible d'accéder à ces enregistrements pour lesquels un espace est seulement réservé dans le fichier. Les enregistrements supprimés sont modifiés afin que l'espace qu'ils occupent puisse être réutilisé.

Nombre total d'enregistrements (TOTRCDS)

Indique le nombre total d'enregistrements du membre après son initialisation. Si, du fait de la valeur indiquée dans ce paramètre, la taille du fichier est supérieure à celle qui était la sienne lors de sa création, un message est envoyé à la file d'attente de l'opérateur système (QSYSOPR). Ce dernier peut alors poursuivre ou annuler l'opération.

*NXTINCR: Le nombre des enregistrements du membre est augmenté du nombre indiqué pour la valeur de la prochaine incrémentation. Si le membre est vide, il est ajouté autant d'enregistrements qu'il est nécessaire pour atteindre le même résultat. *NXTINCR ne peut être utilisé si *NOMAX a été mentionné pour le paramètre Taille du membre (SIZE), lors de la création du fichier.
1-4294967288: Indiquez le nombre total d'enregistrements souhaité pour le membre. Si le nombre des enregistrements existants atteint déjà ou est supérieur à la valeur indiquée, aucun enregistrement ne sera initialisé ; si ce nombre est inférieur à la valeur indiquée, il sera ajouté autant d'enregistrements que nécessaire pour atteindre le total indiqué.

Exemples

INZPFM   FILE(*CURLIB/INV)  TOTRCDS(12000)

Cette commande initialise 12 000 enregistrements dans le premier membre du fichier physique INV de la bibliothèque en cours du travail *CURLIB. Seul le nombre d'enregistrements portant le total à 12000 enregistrements est ajouté au membre. Tous les enregistrements ajoutés sont initialisés au format par défaut. Si une valeur par défaut est indiquée pour une zone dans les DDS (mot clé DFT), cette zone est initialisée conformément à cette valeur ; dans le cas contraire, toutes les zones numériques sont initialisées avec des zéros et toutes les zones alphanumériques sont initialisées avec des blancs.

Messages d'erreur

Messages *ESCAPE

CPF3130: Membre &2 en cours d'utilisation.
CPF3131: Impossible d'initialiser membre &2 avec enreg par défaut.
CPF3132: Valeur du paramètre TOTRCDS manquante ou trop faible.
CPF3133: Le fichier &1 de la bibliothèque &3 ne contient aucun membre.
CPF3134: Erreur de contrainte référentielle lors du traitement du membre &2.
CPF3136: Fichier &1 de &3 non admis dans cette commande.
CPF3137: Non autorisé à mettre à blanc, initialiser ou copier le membre &2.
CPF3138: Violation d'une contrainte de vérification lors du traitement du membre &2.
CPF3140: Initialisation ou copie du membre &2 annulée.
CPF3141: Membre &2 non trouvé.
CPF3142: Fichier &1 non trouvé dans la bibliothèque &3.
CPF3143: Incréments non admis pour le membre &2.
CPF3144: Membre &2 non mis à blanc ou non initialisé.
CPF3148: Espace mémoire insuffisant pour l'ajout d'enregistrements au membre &2.
CPF3156: Fichier &1 de &3 en cours d'utilisation.
CPF3157: Des déclencheurs ou la table temporelle de période système bloquent l'opération demandée.
CPF3159: Membre &2 sauvegardé avec STG(*FREE).
CPF3160: Opération sur le membre &2 interrompue car poste non journalisé.
CPF3179: Impossible de mettre à blanc ou d'initialiser le fichier DDM &1 de &3.
CPF3180: Membre &2 non initialisé.
CPF32CF: Erreur de fichier réparti. Code raison &3.
CPF32C3: Erreur au niveau du fichier réparti, identificateur de niveau de fichier non concordant
CPF320B: Opération incorrecte pour le fichier base de données &1.
CPF9801: Objet &2 non trouvé dans la bibliothèque &3.
CPF9810: Bibliothèque &1 non trouvée.
CPF9820: Non autorisé à utiliser la bibliothèque &1.