CHGPFM

Modifier membre fich physique

En bref

La commande CHGPFM (Modifier un membre de fichier physique) permet de modifier les attributs d'un membre de fichier physique.

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

Syntaxe minimale

CHGPFM FILE(…) MBR(…)

Paramètres

FILE Fichier physique obligatoire
MBR Membre obligatoire
SRCTYPE Type de source
EXPDATE Date d'expiration du membre
SHARE Partage chemin d'ouverture
TEXT Texte 'descriptif'
UNIT Choix unité stockage second

Astuce : dans une session 5250, tapez CHGPFM 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 : Non

La commande CHGPFM (Modifier un membre de fichier physique) permet de modifier les attributs d'un membre de fichier physique.

Restrictions :

Pour modifier un membre physique, vous devez disposer du droit de gestion d'objet (*OBJMGT) ou du droit de modification d'objet (*OBJALTER) sur le fichier physique qui contient le membre, ainsi que du droit d'exécution (*EXECUTE) sur la bibliothèque qui contient le fichier.
Aucun autre utilisateur ne peut mettre à blanc ou initialiser le membre, ni retenir le fichier pour utilisation exclusive. D'autres utilisateurs peuvent ouvrir le membre, mais leurs modifications ne sont pas prises en compte. Pour qu'elles le soient, vous devez fermer le membre (par fermeture complète si la valeur SHARE(*YES) a été indiquée lors de l'ouverture), puis l'ouvrir de nouveau.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
FILE	Fichier physique	Nom d'objet qualifié	Obligatoire, clé, positionnel 1
	Qualificatif 1: Fichier physique	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
MBR	Membre	Nom, *FIRST	Obligatoire, clé, positionnel 2
SRCTYPE	Type de source	Nom simple, SAME, NONE	Facultatif
EXPDATE	Date d'expiration du membre	Date, SAME, NONE	Facultatif
SHARE	Partage chemin d'ouverture	SAME, YES, *NO	Facultatif
TEXT	Texte 'descriptif'	Valeur caractère, SAME, BLANK	Facultatif
UNIT	Choix unité stockage second	SAME, ANY, *SSD	Facultatif

Fichier physique (FILE)

Indique le fichier physique contenant le membre à modifier.

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: Bibliothèque de l'unité d'exécution en cours utilisée pour localiser le fichier. Si aucune bibliothèque n'est indiquée comme bibliothèque en cours, la bibliothèque QGPL est utilisée.

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

Membre (MBR)

Indique le membre à modifier.

Ce paramètre est obligatoire.

*FIRST: Le premier membre du fichier indiqué est utilisé.
nom: Entrez le nom du membre de fichier physique à modifier.

Type de source (SRCTYPE)

Indique le type de source d'un membre pour un fichier source. Cette valeur est une chaîne de 10 caractères maximum représentant un nom. 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.

Remarque :L'utilisateur de cette commande doit s'assurer de la validité de l'option Type de source.

Cette option peut uniquement être utilisée avec cette commande pour changer l'attribut du type de source d'un membre de fichier source.

*SAME: La valeur reste inchangée.
*NONE: Aucun type de source n'est indiqué.
nom-simple: Indiquez le type de source d'un membre.

Date d'expiration du membre (EXPDATE)

Indique la date de péremption. Les fichiers ne peuvent pas être écrasés avant cette date. La date de péremption doit être égale ou postérieure à la date en cours.

*SAME: La date de péremption du membre ne change pas.
*NONE: Aucune date de péremption n'a été attribuée au membre.
date: Entrez, dans le format de la date du travail, la date après laquelle le membre ne pourra plus être utilisé.

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.

*SAME: La valeur définissant le partage du chemin d'ouverture ne change pas.

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

Texte 'descriptif' (TEXT)

Texte décrivant brièvement l'objet.

*SAME: La description du membre ne change pas.
*BLANK: Aucun texte n'est indiqué.

valeur-alphanumérique: Tapez un texte d'au plus 50 caractères, entre apostrophes.

Choix unité stockage second (UNIT)

Indique le support de stockage préférentiel pour le membre.

*ANY: Pas de support de stockage préférentiel. La mémoire est allouée à partir de n'importe quel support de stockage disponible.
*SSD: Un support de stockage de type disque électronique est à utiliser préférentiellement. La mémoire peut être allouée à partir d'un support de ce type, si disponible.

Exemples

CHGPFM   FILE(QGPL/INV)  MBR(FEB)  EXPDATE('10/31/90')

Cette commande modifie le membre FEB du fichier physique INV dans la bibliothèque QGPL, de sorte que sa date d'expiration devienne le 31 octobre 1990 (en supposant que la date du travail est au format mm/jj/aa).

Messages d'erreur

Messages *ESCAPE

CPF3288: Membre &3 du fichier &1 dans &2 non modifié.