CHGICFF

Modifier un fichier ICF

En bref

La commande CHGICFF (Modifier un fichier ICF) permet de modifier les attributs du fichier ICF indiqué.

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

Syntaxe minimale

CHGICFF FILE(…)

Paramètres

FILE Fichier ICF obligatoire
ACQPGMDEV Unité programme à acquérir
MAXPGMDEV Nombre maximal d'unités pgm
LVLCHK Vérification niveau de format
TEXT Texte 'descriptif'
MAXRCDLEN Longueur maximale d'enreg
WAITFILE Temps d'attente maxi fichier
WAITRCD Temps d'attente maxi enreg
DTAQ File d'attente de données
SHARE Partage chemin d'ouverture

Astuce : dans une session 5250, tapez CHGICFF 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 CHGICFF (Modifier un fichier ICF) permet de modifier les attributs du fichier ICF indiqué.

Remarque : Seules les informations spécifiées dans cette commande peuvent être modifiées. Si les DDS (spécifications de description de données) qui ont servi à créer ce fichier sont modifiées, le fichier ICF devra être recréé pour que les modifications deviennent effectives.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
FILE	Fichier ICF	Nom d'objet qualifié	Obligatoire, clé, positionnel 1
	Qualificatif 1: Fichier ICF	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
ACQPGMDEV	Unité programme à acquérir	Valeur caractère, SAME, NONE	Facultatif
MAXPGMDEV	Nombre maximal d'unités pgm	1-256, *SAME	Facultatif
LVLCHK	Vérification niveau de format	SAME, YES, *NO	Facultatif
TEXT	Texte 'descriptif'	Valeur caractère, SAME, BLANK	Facultatif
MAXRCDLEN	Longueur maximale d'enreg	1-32767, SAME, CALC	Facultatif
WAITFILE	Temps d'attente maxi fichier	1-32767, SAME, IMMED, *CLS	Facultatif
WAITRCD	Temps d'attente maxi enreg	1-32767, SAME, NOMAX, *IMMED	Facultatif
DTAQ	File d'attente de données	Valeurs uniques: SAME, NONE Autres valeurs: Nom d'objet qualifié	Facultatif
	Qualificatif 1: File d'attente de données	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
SHARE	Partage chemin d'ouverture	SAME, NO, *YES	Facultatif

Fichier ICF (FILE)

Indique le fichier ICF à modifier.

Ce paramètre est obligatoire.

Qualificatif 1 : Fichier ICF

nom: Indiquez le nom du fichier ICF.

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 ICF est recherché dans la bibliothèque en cours. Si cette dernière n'est pas précisée, QGPL est prise par défaut.
nom: Indiquez la bibliothèque contenant le fichier ICF.

Unité programme à acquérir (ACQPGMDEV)

Indique l'unité programme acquise à l'ouverture du fichier.

*SAME: Le nom de l'unité programme acquise ne change pas.
*NONE: Le fichier est ouvert sans qu'aucune unité programme ne soit acquise. Toutes les unités programme utilisées avec ce fichier doivent être explicitement acquises avant de pouvoir participer à des opérations d'entrée/sortie.
valeur-alphanumérique: Indiquez le nom de la première unité programme acquise lors de l'ouverture du fichier.

Nombre maximal d'unités pgm (MAXPGMDEV)

Indique le nombre maximal d'unités programme pouvant être ajoutées au fichier ICF.

*SAME: La valeur reste inchangée.
1 à 256: Indiquez le nombre maximal de postes d'unité programme.

Vérification niveau de format (LVLCHK)

Indique si les identificateurs de niveau des formats d'enregistrement de ce fichier unité sont vérifiés lors de l'ouverture du fichier par un programme.

*SAME: La valeur reste inchangée.
*YES: Les identificateurs de niveau des formats d'enregistrement sont vérifiés. S'ils ne correspondent pas tous ou s'ils n'ont pas été spécifiés dans le programme, un message d'erreur d'ouverture est envoyé au programme qui demande l'ouverture.
*NO: Les identificateurs de niveau des formats d'enregistrement ne sont pas vérifiés lors de l'ouverture du fichier.

Texte 'descriptif' (TEXT)

Texte décrivant brièvement l'objet.

*SAME: Le texte, s'il existe, ne change pas.
*BLANK: Aucun texte n'est indiqué.
valeur-alphanumérique: Tapez un texte d'au plus 50 caractères, entre apostrophes.

Longueur maximale d'enreg (MAXRCDLEN)

Indique la longueur maximale d'enregistrement utilisée lors de l'ouverture du fichier.

*SAME: La longueur d'enregistrement maximale n'est pas modifiée.
*CALC: La longueur calculée pour le plus long enregistrement du fichier est utilisée lors de l'ouverture de ce dernier.
1 à 32767: Indiquez la longueur d'enregistrement maximale. Si la longueur de l'enregistrement est inférieure à celle calculée pour l'enregistrement le plus long, c'est la valeur calculée qui est utilisée.

Temps d'attente maxi fichier (WAITFILE)

Indique le nombre de secondes pendant lesquelles le programme attend l'allocation des ressources système lors de l'ouverture du fichier. Si les ressources ne peuvent être allouées dans le temps imparti, un message d'erreur est envoyé au programme.

*SAME: Le délai d'attente n'est pas modifié.

*IMMED: Le programme n'attend pas. Une allocation immédiate des ressources est requise.

*CLS: Le délai d'attente par défaut du travail est utilisé pour l'allocation des ressources du fichier.
1 à 32767: Indiquez, en secondes, le délai d'attente possible pour l'allocation des ressources du fichier.

Temps d'attente maxi enreg (WAITRCD)

Indique le délai d'attente (en secondes) par le programme pour la réalisation d'une opération de lecture sur les unités invitées d'un fichier contenu dans un programme en langage évolué. Pour savoir dans quels cas un fichier est traité en tant que fichier à unités multiples, reportez-vous au manuel de référence relatif au langage évolué. Le programme exécutant l'opération de lecture attend les données d'entrée de toutes les unités invitées accédant au fichier. Si aucun enregistrement n'est renvoyé depuis l'une de ces unités dans le délai indiqué, le système envoie un message d'avertissement au programme. Ce paramètre n'a aucune incidence sur une opération d'entrée dirigée sur une unité unique.

*SAME: Le temps d'attente n'est pas modifié.
*NOMAX: Aucun temps d'attente maximum du programme n'est spécifié pour l'exécution d'une opération de lecture sur les unités sollicitées.

*IMMED: Le programme n'attend pas. Si aucun enregistrement n'est disponible lors de l'opération de lecture sur les unités invitées, un message d'avertissement est envoyé au programme.

1 à 32767: Spécifiez, en secondes, le temps d'attente maximal nécessaire à la réalisation d'une opération de lecture sur les unités invitées.

File d'attente de données (DTAQ)

Indique la file d'attente de données dans laquelle sont placés les postes. Le nom doit comporter au moins 80 caractères. Il n'est pas nécessaire que la file d'attente existe lors de la création du fichier écran puisque le nom indiqué par ce paramètre est examiné uniquement lorsque le fichier est utilisé.

Remarque :Les files d'attente de données par clé ne sont pas prises en charge pour ce paramètre. Si vous indiquez une file d'attente de ce type, une erreur se produira lors de l'exécution, mais ceci ne vous est pas signalé, car il n'est pas nécessaire qu'une file d'attente existe lors du lancement de la commande.

Valeurs uniques

*SAME: Le nom de la file d'attente de données ne change pas.
*NONE: Aucune file d'attente de données n'est indiquée.

Qualificatif 1 : File d'attente de données

nom: Indiquez le nom de la file d'attente de données à utiliser.

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: La file d'attente est recherchée dans la bibliothèque en cours du travail. Si celle-ci n'est pas précisée, QGPL est prise par défaut.
nom: Entrez le nom de la bibliothèque contenant la file d'attente de données.

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 précisée dans le fichier 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.

Exemples

CHGICFF   FILE(ICFHIST)  MAXPGMDEV(10)

Cette commande permet de modifier le nombre maximal d'unités programme pouvant être ajoutées au fichier ICF ICFHIST.

Messages d'erreur

*ESCAPE Messages

CPF7304: Fichier &1 de &2 non modifié.