Commande CL IBM i (AS/400)

CLRPFM

Mettre à blanc membre fichier

En bref

La commande CLRPFM (Mettre à blanc un membre de fichier physique) permet d'enlever toutes les données (y compris les enregistrements supprimés) du membre de fichier physique indiqué.

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

Syntaxe minimale

CLRPFM FILE(…)

Paramètres

FILE Fichier physique obligatoire
MBR Membre

Astuce : dans une session 5250, tapez CLRPFM 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 CLRPFM (Mettre à blanc un membre de fichier physique) permet d'enlever toutes les données (y compris les enregistrements supprimés) du membre de fichier physique indiqué. Si *NO a été mentionné pour le paramètre Allocation mémoire secondaire (ALLOCATE) lors de la création du fichier, le compteur d'enregistrements du membre est remis à zéro et l'espace occupé par le membre est réduit au minimum. En revanche, si *YES a été indiqué pour le paramètre ALLOCATE lors de la création du fichier, la commande CLRPFM réinitialise la taille du membre à la valeur utilisée lors de la création du fichier.

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. C'est également le cas 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, *ALL	Facultatif, positionnel 2

Fichier physique (FILE)

Indique le fichier physique contenant le membre à mettre à blanc.

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 nom du membre à mettre à blanc.

*FIRST: Met à blanc le premier membre du fichier physique.
*LAST: Met à blanc le dernier membre du fichier physique.
*ALL: Tous les membres du fichier physique indiqué sont mis à blanc.
nom: Indiquez le nom du membre de fichier physique à mettre à blanc.

Exemples

CLRPFM   FILE(*CURLIB/INV)  MBR(FEB)

Cette commande met à blanc le membre FEB du fichier physique INV, qui se trouve dans la bibliothèque en cours du travail *CURLIB. Il n'est mis à blanc que lorsque tous les travaux utilisant le membre et tous les travaux utilisant les chemins d'accès au membre ont fini de l'utiliser.

Messages d'erreur

Messages *ESCAPE

CPF3130: Membre &2 en cours d'utilisation.
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.
CPF3141: Membre &2 non trouvé.
CPF3142: Fichier &1 non trouvé dans la bibliothèque &3.
CPF3144: Membre &2 non mis à blanc ou non initialisé.
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.
CPF32B8: Erreur de fichier réparti. Code raison &3.
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.
CPF3203: Allocation de l'objet impossible pour le fichier &1 de &2.