CHGPF

La commande CHGPF (Modifier un fichier physique) permet de modifier les attributs d'un fichier physique et de tous ses membres. Les attributs ainsi modifiés s'appliquent à tous les membres ajoutés ultérieurement au fichier sauf si d'autres valeurs sont indiquées ou s'appliquent par défaut lors de l'opération d'ajout. Si vous désirez modifier les attributs d'un seul membre, utilisez la commande CHGPFM (Modifier un membre de fichier physique).

Restrictions :

• Vous devez disposer du droit de gestion d'objet (*OBJMGT) ou du droit de modification d'objet (*OBJALTER) sur le fichier, ainsi que du droit d'exécution (*EXECUTE) sur la bibliothèque. Un verrouillage exclusif sans lecture permise est nécessaire (personne ne peut alors utiliser le fichier).
• Aucune modification n'est admise si vous demandez la réutilisation des enregistrements supprimés par un fichier existant sans que le fichier physique ne contienne de fichiers logiques dans lesquels l'ordre "FIFO" ou "LIFO" est défini pour les clés en double.

Paramètres

Fichier physique (FILE)

Indique le fichier physique à modifier.

Remarque :Si un fichier DDM (Gestion de fichiers éloignés) est indiqué, le nom du fichier physique à modifier et celui du système éloigné sur lequel ce fichier réside sont contenus dans ce fichier. Pour plus d'informations, reportez-vous au paramètre Système (SYSTEM) de cette commande.

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.

Système (SYSTEM)

Indique si le fichier physique est modifié sur le système local ou sur un système éloigné.

*LCL

Le fichier physique est modifié sur le système local.

*RMT

Le fichier physique est modifié sur le système éloigné à l'aide de DDM (Gestion de fichiers éloignés). Le nom du fichier physique indiqué pour le paramètre Fichier physique (FILE) doit correspondre à celui du fichier DDM qui identifie le fichier physique à modifier et le système éloigné sur lequel la modification doit être effectuée.

*FILETYPE

Si le nom indiqué pour le paramètre FILE correspond à un fichier DDM, le fichier physique est modifié sur le système éloigné précisé par le paramètre Lieu éloigné (RMTLOCNAME) du fichier DDM. Si le nom indiqué pour le paramètre FILE ne correspond pas à un fichier DDM, le fichier physique du même nom est modifié sur le système local.

Fichier source (SRCFILE)

Indique le fichier source utilisé pour modifier le fichier physique. Le fichier source contient les spécifications décrivant le format d'enregistrement et ses zones ainsi que le chemin d'accès au fichier et ses membres. Les spécifications de description de données (DDS) produites sont décrites dans les manuels Rubrique Base de données de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/ et Rubriques DDS de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

En cas de modification des attributs de format, les données contenues dans le fichier existant sont modifiées en fonction de ces nouveaux attributs.

Attention :

• Les données du fichier existant sont converties au nouveau format en fonction des noms de zone. Lorsqu'un nom de zone est modifié, les données qu'il contient sont perdues.
• Si vous convertissez des données, il vous est vivement recommandé de sauvegarder le fichier avant de lancer cette commande.

Si les attributs de chemin d'accès ou ceux de l'une des zones clés du format sont modifiés, un nouveau chemin d'accès peut être créé.

Remarque :Lorsque les données ou les attributs de chemin d'accès sont modifiés, la modification du fichier peut prendre du temps. Des messages d'état sont émis afin d'informer l'utilisateur interactif de l'état d'avancement de l'opération.

Valeurs uniques

*NONE

Aucun fichier source n'est indiqué. Les attributs de format ou de chemin d'accès du fichier ne sont pas modifiés.

Qualificatif 1 : Fichier source

QDDSSRC

Le fichier source, QDDSSRC, contient les DDS utilisées pour modifier le fichier physique.

nom

Indiquez le nom du fichier source contenant les DDS utilisées pour modifier le 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

La recherche porte sur la bibliothèque en cours de l'unité d'exécution. Si aucune bibliothèque n'est définie comme bibliothèque en cours pour l'unité d'exécution, la recherche porte sur la bibliothèque QGPL.

nom

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

Membre source (SRCMBR)

Indique le membre de fichier source contenant les DDS associées au fichier physique à modifier.

Remarque :Ce paramètre est admis uniquement si un fichier source est indiqué pour le paramètre Fichier source (SRCFILE).

*FILE

Le nom du membre de fichier source est identique à celui du fichier physique à modifier.

nom

Indiquez le nom du membre de fichier source utilisé pour modifier le fichier physique.

Options pour liste source (OPTION)

Indique le type de sortie obtenue une fois le fichier modifié. Parmi les valeurs suivantes, quatre au maximum peuvent être indiquées dans n'importe quel ordre pour ce paramètre. Si aucune des deux valeurs d'une option n'est indiquée ou si les deux valeurs sont spécifiées, seule la première est utilisée.

Remarques :

• Ce paramètre est admis uniquement si un fichier source est indiqué pour le paramètre Fichier source (SRCFILE).
• La première valeur d'une option fait office de valeur par défaut, bien qu'elle n'en soit pas une réellement. C'est pourquoi elle ne peut pas être modifiée à l'aide de la commande CHGCMDDFT.
• Ce paramètre admet jusqu'à 3 valeurs.

Option de liste source

*SRC ou *SOURCE

Une impression des instructions source utilisées pour la modification du fichier et des erreurs survenues est créée.

*NOSRC ou *NOSOURCE

Les instructions source ne sont pas imprimées, sauf si des erreurs sont détectées. Dans ce cas, elles sont imprimées avec le mot clé ou le format d'enregistrement responsable de l'erreur.

Option de liste de programme

*LIST

Une impression source étendue est créée ; elle présente une liste détaillée des spécifications de fichier résultant des instructions source et des références à d'autres descriptions de fichier.

*NOLIST

L'impression du source étendu n'est pas créée.

Option de message de deuxième niveau

*NOSECLVL

La section de messages figurant sur l'impression des DDS ne contient pas les messages de deuxième niveau relatifs aux erreurs rencontrées au cours du traitement des DDS.

*SECLVL

Le texte du message de deuxième niveau est inclus dans la liste source.

Option de création de fichier événements

*NOEVENTF

Le compilateur ne crée pas de fichier événements pour le produit Environnement développement coopératif (CODE).

*EVENTF

Le compilateur crée un fichier événements qui peut être utilisé par le produit CODE. Ce fichier événements est créé en tant que membre du fichier EVFEVENT dans votre bibliothèque objet. Le produit CODE s'en sert pour offrir un suivi des erreurs intégré à l'éditeur CODE. Normalement, cette valeur est indiquée par le produit CODE, pour votre compte.

Niveau gravité pour génération (GENLVL)

Indique le niveau de gravité d'erreur à partir duquel l'opération de modification échoue. Si des erreurs dont le niveau de gravité est supérieur ou égal à cette valeur se produisent, l'opération est interrompue.

Remarques :

• Ce paramètre est admis uniquement si un fichier source est indiqué pour le paramètre Fichier source (SRCFILE).
• Ce paramètre s'applique uniquement aux messages créés lors du traitement du source des DDS. Il n'affecte pas les messages créés à un autre stade de la modification de fichier.
• La valeur de ce paramètre doit être supérieure ou égale à celle indiquée au paramètre Niveau gravité pour marquage (FLAG).

20

Un niveau de gravité d'erreur supérieur ou égal à 20 entraîne l'interruption de la modification.

0 à 30

Indiquez le niveau de gravité maximal admis. Le fichier n'est pas modifié si le niveau de gravité indiqué est 0.

Niveau gravité pour marquage (FLAG)

Indique le niveau de gravité minimal des messages à lister.

Remarque :Ce paramètre est admis uniquement si un fichier source est indiqué pour le paramètre Fichier source (SRCFILE).

0

Tous les messages sont listés.

0-30

Indiquez un chiffre donnant la gravité minimale des messages à lister. La valeur spécifiée doit être supérieure ou égale à la valeur spécifiée à l'invite Niveau gravité pour génération (paramètre GENLVL).

Suppr fich logique dépendant (DLTDEPLF)

Indique si les fichiers logiques et les tables de requêtes matérialisées SQL dépendant d'une zone sont supprimés lorsque cette zone est enlevée du fichier dans le cadre de l'opération de modification. Une zone est enlevée du fichier si sa définition n'est pas incluse dans les DDS identifiées dans le fichier source.

Remarque :Ce paramètre est admis uniquement si un fichier source est indiqué pour le paramètre Fichier source (SRCFILE).

*NO

Les fichiers dépendants ne sont pas supprimés. La zone dont dépendent les chemins d'accès n'est pas enlevée et le fichier n'est pas modifié. La commande est interrompue.

*YES

Les fichiers dépendant d'une zone enlevée du fichier sont également supprimés.

Enlever contrainte (RMVCST)

Indique si les associations de contrainte sont enlevées de l'ensemble de fichiers dépendants associé lorsque vous supprimez un fichier parent d'une contrainte référentielle.

Remarque :Ce paramètre est admis uniquement si *YES est indiqué pour le paramètre Suppr fich logique dépendant (DLTDEPLF).

*RESTRICT

Les associations de contrainte ne sont pas enlevées. Le fichier parent non plus, et le fichier n'est pas modifié. La commande est interrompue.

*REMOVE

Les contraintes dépendant d'une zone enlevée du fichier sont également enlevées. Lorsqu'une contrainte unique est enlevée, toute contrainte référentielle dépendant de cette dernière est également enlevée.

Date d'expiration du membre (EXPDATE)

Indique la date de péremption de tous les membres du fichier. Si une nouvelle date de péremption est mentionnée, elle s'applique à tous les membres du fichier. Vous pouvez indiquer une nouvelle date pour un membre dont la date a été dépassée. La date de péremption doit être postérieure ou identique à la date du jour.

*SAME

La date de péremption du fichier ne change pas.

*NONE

Aucune date d'expiration n'est indiquée.

date

Indiquez, dans le format de la date du travail, la date après laquelle les membres du fichier ne devront plus être utilisés.

Nombre maximal de membres (MAXMBRS)

Indique le nombre maximal de membres que peut contenir le fichier physique. Cette valeur doit être supérieure ou égale au nombre de membres déjà contenus dans le fichier.

*SAME

Le nombre maximal de membres que peut contenir le fichier ne change pas.

*NOMAX

Aucun nombre maximal n'a été indiqué pour les membres du fichier. La valeur par défaut utilisée est de 32767 membres par fichier.

entier

Indiquez le nombre maximal de membres que le fichier physique peut contenir. Les valeurs possibles sont comprises entre 1 et 32767 secondes.

Taille du chemin d'accès (ACCPTHSIZ)

Indique la taille maximale de la mémoire secondaire pouvant être occupée par les types de chemins d'accès suivants :

• Les chemins d'accès associés à un fichier base de données ayant un chemin d'accès sur clé.
• Chemins d'accès créés pour les contraintes référentielles ou uniques.

Si la valeur pour ce fichier est modifiée, les chemins d'accès lui appartenant sont recréés.

Remarque :Ce paramètre ne s'applique pas aux chemins d'accès créés pour des demandes qui font référence aux données du fichier.

*SAME

La valeur ne change pas.

*MAX1TB

Le volume maximal de mémoire secondaire qui peut être occupé par les chemins d'accès associés à ce fichier est déterminé par la taille de page logique comme indiqué ci-dessous :

  Taille de          Mémoire secondaire
  mémoire logique    maximum
     8K                 4 To
     16K                8 To
     32K-512K           16 To

*MAX4GB

Les chemins d'accès associés à ce fichier peuvent occuper un maximum de quatre gigaoctets (4 294 967 296 octets) de mémoire secondaire.

Maintenance chemin d'accès (MAINT)

Indique le type de maintenance de chemin d'accès choisi pour tous les membres du fichier physique. Ce paramètre ne peut être utilisé que si le fichier comporte un chemin d'accès par clé.

*SAME

La maintenance du chemin d'accès du fichier ne change pas.

*IMMED

La maintenance du chemin d'accès de tous les membres du fichier physique s'effectue en permanence (immédiatement). Le chemin d'accès est modifié à chaque modification, ajout ou suppression d'enregistrement. *IMMED doit être indiqué pour tous les fichiers à clé unique pour vérifier l'unicité de tout ajout ou mise à jour.

*REBLD

La reconstruction du chemin d'accès s'effectue à l'ouverture du membre. La maintenance du chemin d'accès est assurée en permanence jusqu'à la fermeture du membre, après quoi, elle n'est plus en vigueur. *REBLD ne peut pas être indiqué pour des chemins d'accès à clé unique.

*DLY

La maintenance du chemin d'accès est différée jusqu'à la prochaine ouverture du membre. Le chemin d'accès est alors modifié pour les seuls enregistrements ajoutés, supprimés ou modifiés depuis dernière ouverture du fichier. (Pendant que le fichier est ouvert, toute modification apportée à un membre sous-jacent est immédiatement prise en compte dans le chemin d'accès par clé du membre, quelle que soit la valeur indiquée pour le paramètre Maintenance chemin d'accès (MAINT).) Pour éviter que le rétablissement dure trop longtemps, n'indiquez *DLY que si le nombre de modifications apportées au chemin d'accès est peu élevé entre une opération de fermeture et l'opération d'ouverture suivante. Vous ne pouvez pas indiquer *DLY pour un chemin d'accès à clé unique.

Si le volume des modifications sauvegardées représente environ 10% de la taille du chemin d'accès, le système cesse de sauvegarder les modifications et le chemin d'accès est entièrement reconstruit lors de l'ouverture suivante du fichier.

Rétablissement chemin d'accès (RECOVER)

Indique, pour les fichiers comportant une maintenance immédiate ou différée de chemin d'accès, à quel moment est rétabli le chemin d'accès du fichier en cas de panne système lors de la modification du chemin d'accès. Ce paramètre ne peut être indiqué que si le fichier comporte un chemin d'accès par clé.

*SAME

L'attribut de rétablissement du chemin d'accès du fichier ne change pas.

*NO

Le chemin d'accès du fichier n'est pas reconstruit. Si le chemin d'accès est incorrect, celui-ci est reconstruit à l'ouverture du fichier.

*AFTIPL

La reconstruction du chemin d'accès débute après l'IPL. Avec cette option, les autres travaux qui n'utilisent pas le fichier concerné peuvent être traités dès la fin de l'IPL.

*IPL

La reconstruction du chemin d'accès du fichier a lieu pendant l'IPL. Le fichier peut donc être utilisé par un premier programme utilisateur. Cependant, aucun travail ne peut être lancé avant que tous les chemins d'accès des fichiers pour lesquels *IPL a été indiqué aient été reconstruits.

Forcer chemin d'accès sur clé (FRCACCPTH)

Indique, pour des fichiers comportant des chemins d'accès par clé, si les chemins d'accès modifiés sont écrits dans la mémoire secondaire en même temps que les enregistrements du fichier. La valeur *YES diminue (mais ne supprime pas) les risques de fin anormale pouvant endommager le chemin d'accès qui devra alors être reconstruit.

*SAME

L'attribut de forçage du chemin d'accès en mémoire secondaire n'est pas modifié.

*NO

Les modifications du chemin d'accès et des enregistrements ne sont pas forcées en mémoire secondaire après chaque modification.

*YES

Les modifications du chemin d'accès et des enregistrements sont forcées en mémoire secondaire à chaque modification. Si cette valeur est indiquée, *REBLD ne doit par être précisé à l'invite Maintenance chemin d'accès (paramètre MAINT).

Taille du membre (SIZE)

Indique le nombre d'enregistrements initial dans chaque membre du fichier, le nombre d'enregistrements de chaque incrément ajouté au membre, et le nombre d'incrémentations automatiques. Le nombre d'enregistrements indiqué pour chaque membre du fichier représente le nombre d'enregistrements que le membre peut contenir (y compris, le cas échéant, ceux qui sont supprimés).

Le nombre maximal d'enregistrements du membre (nombre initial d'enregistrements augmenté du nombre d'incrémentations des enregistrements multiplié par le nombre maximal d'incréments) doit être supérieur au nombre actuel d'enregistrements du membre. Si ce nombre est inférieur au nombre actuel d'enregistrements du membre, un message d'erreur est émis et le nombre maximal d'enregistrements du membre n'est pas modifié.

Valeurs uniques

*NOMAX

Le nombre d'enregistrements pouvant être ajoutés à chaque membre n'est pas limité par l'utilisateur. Le nombre maximal d'enregistrements de chaque membre est déterminé par le système. Cette option ne peut être choisie si *YES a été indiqué pour l'attribut ALLOCATE du fichier physique.

Elément 1 : Nombre initial d'enreg

*SAME

La valeur reste inchangée.

1-2147483646

Indiquez le nombre d'enregistrements pouvant être insérés avant l'extension automatique. Si vous ne souhaitez pas cette extension automatique, entrez des zéros pour la seconde et la troisième valeur de la liste.

Elément 2 : Valeur d'incrément

*SAME

La valeur reste inchangée.

0 à 32767

Indiquez une valeur pour le nombre d'enregistrements supplémentaires ajoutés au membre lorsque le nombre d'enregistrements qu'il contient dépasse le nombre initial d'enregistrements ou le nombre d'enregistrements de l'incrément actuel.

Entrez 0 pour empêcher toute incrémentation automatique. Cette valeur doit être 0 si la valeur du nombre maximal d'incréments est égale à 0.

Elément 3 : Nombre maximal d'incréments

*SAME

La valeur reste inchangée.

0 à 32767

Indiquez le nombre maximum d'incréments pouvant être ajoutés automatiquement au membre. Entrez 0 pour empêcher toute incrémentation automatique. Si le nombre d'incréments de la valeur des enregistrements est 0, cette valeur doit également être 0.

Allocation mémoire secondaire (ALLOCATE)

Indique si un espace mémoire initial doit être alloué pour chaque fichier physique. Cette modification est prise en compte lors de l'ajout d'un membre au fichier ou lorsque le membre en cours est effacé ou réorganisé.

*SAME

Les valeurs précédentes ne changent pas.

*NO

Chaque fois qu'un nouveau membre est ajouté au fichier, ou qu'un membre existant est mis à blanc ou réorganisé, le système détermine et alloue l'espace mémoire nécessaire.

*YES

L'espace mémoire indiqué comme première valeur du paramètre Taille du membre (SIZE) est alloué chaque fois qu'un nouveau membre est ajouté, ou chaque fois qu'un membre existant est mis à blanc ou réorganisé. Si cet espace mémoire n'est pas disponible, le membre n'est pas ajouté et un message est envoyé à l'utilisateur. Si cette valeur de paramètre est utilisée, *NOMAX est incompatible avec le paramètre SIZE.

Choix unité stockage second (UNIT)

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

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

entier

Toute valeur comprise entre 1 et 254 équivaut à indiquer *ANY. La valeur 255 équivaut à indiquer *SSD.

Nb enreg forcés en écriture (FRCRATIO)

Indique le nombre d'enregistrements ajoutés, modifiés ou supprimés qui sont traités avant d'être écrits dans la mémoire secondaire (permanente). Si le fichier physique est journalisé, il est préférable d'indiquer une valeur FRCRATIO très grande ou *NONE. Le manuel Reprise du système, SC41-5304 fournit plus de détails sur la gestion du journal.

*SAME

Le nombre d'enregistrements forcés en écriture ne change pas.

*NONE

L'écriture des enregistrements du fichier dans la mémoire secondaire est déterminée par le système.

entier

Indiquez le nombre d'enregistrements nouveaux ou modifiés qui sont traités avant d'être écrits dans la mémoire secondaire.

Temps d'attente maxi fichier (WAITFILE)

Indique le délai d'attente (en secondes) par le programme pour l'allocation des ressources fichier et session lors de l'ouverture du fichier, ou pour l'allocation des ressources unité ou session lors de l'exécution d'une opération d'acquisition sur le fichier. Si les ressources fichier ne peuvent pas être allouées dans le délai spécifié, le système envoie un message d'erreur au programme.

Remarque :L'allocation de l'unité par la ressource doit être immédiate lorsqu'une acquisition est exécutée sur le fichier.

*SAME

Le délai d'attente ne change pas.

*IMMED

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

*CLS

La valeur par défaut indiquée dans la description de classe est utilisée pour le délai d'attente d'allocation des ressources du fichier.

1 à 32767

Indiquez le délai d'attente (en secondes) accepté par le programme pour l'allocation des ressources fichier.

Temps d'attente maxi enreg (WAITRCD)

Indique le délai d'attente du programme (exprimé en secondes) avant l'obtention d'un enregistrement à modifier ou supprimer. Si l'enregistrement n'est pas disponible au terme de ce délai, un message d'erreur est envoyé au programme.

*SAME

Le délai d'attente ne change pas.

*IMMED

Aucun délai d'attente n'est prévu pour le programme ; lorsqu'un enregistrement est verrouillé, son allocation doit être immédiate.

*NOMAX

Le délai d'attente est le délai maximal admis par le système (32767 secondes).

1 à 32767

Indiquez le délai d'attente (en secondes) accepté par le programme pour l'allocation des ressources fichier.

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.

% maxi d'enreg supprimés admis (DLTPCT)

Indique le pourcentage maximal d'enregistrements supprimés admis dans un membre de fichier physique. Ce pourcentage exprime le rapport entre le nombre d'enregistrements supprimés et le nombre total d'enregistrements figurant dans un membre. La modification entre en vigueur dès l'ouverture ou la fermeture du fichier.

*SAME

Le pourcentage d'enregistrements supprimés ne change pas.

*NONE

Aucun pourcentage n'est indiqué ; le nombre d'enregistrements supprimés dans les membres du fichier n'est pas contrôlé lors de la fermeture d'un membre.

1 à 100

Indiquez le pourcentage maximal d'enregistrements supprimés que peut comporter un membre de fichier. Si le nombre d'enregistrements supprimés est supérieur à la valeur indiquée, un message est envoyé à l'historique du système (QHST) à la fermeture du fichier.

Réutilisation enreg supprimés (REUSEDLT)

Indique si l'espace libéré par des données supprimées peut être récupéré par des demandes d'insertion ultérieures.

*SAME

L'option ne change pas.

*NO

Le fichier ne récupère pas l'espace libéré par les enregistrements supprimés.

*YES

Le fichier récupère l'espace libéré par les enregistrements supprimés. Le manuel Rubrique Base de données de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/, fournit plus d'informations sur l'algorithme utilisé pour la récupération des données supprimées.

Remarque :L'ordre d'arrivée n'est pas significatif dans le cas d'un fichier qui réutilise l'espace d'enregistrements supprimés. Les enregistrements peuvent ne plus être ajoutés à la fin du fichier.

Séquence de tri (SRTSEQ)

Indique la séquence de tri utilisée pour ce fichier. La valeur de séquence de tri est utilisée avec le paramètre LANGID pour déterminer la table de séquence de tri utilisée.

Remarque :Si la valeur pour ce fichier est modifiée, les chemins d'accès lui appartenant sont recréés.

Valeurs uniques

*SAME

La valeur ne change pas.

*SRC

La table indiquée dans le mot clé ALTSEQ des spécifications de description de données (DDS) est utilisée. Si le mot clé ALTSEQ n'est pas utilisé dans les DDS, la valeur *JOB est prise par défaut pour ce paramètre.

*JOB

La valeur de séquence de tri utilisée est celle du travail correspondant à la demande de modification du fichier physique.

*LANGIDSHR

La table de séquence de tri utilise le même poids pour plusieurs caractères ; il s'agit de la table de séquence de tri à poids partagés associée à la langue définie par le paramètre LANGID.

*LANGIDUNQ

La table de séquence de tri doit contenir un poids unique pour chacun des caractères de la page de codes.

*HEX

Aucune table de séquence de tri n'est utilisée. Les valeurs hexadécimales des caractères sont utilisées pour déterminer la séquence de tri.

Qualificatif 1 : Séquence de tri

nom

Indiquez le nom de la table de séquence de tri à 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 recherche porte sur la bibliothèque en cours de l'unité d'exécution. Si aucune bibliothèque n'est définie comme bibliothèque en cours pour l'unité d'exécution, la recherche porte sur la bibliothèque QGPL.

nom

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

Identificateur de langue (LANGID)

Indique l'identificateur de langue utilisé lorsque *LANGIDSHR ou *LANGIDUNQ est précisé pour le paramètre Séquence de tri (SRTSEQ). L'identificateur de langue est utilisé avec les paramètres SRTSEQ et ID codé de jeu de caractères (CCSID) pour déterminer la table de séquence de tri utilisée par le fichier.

Remarque :Si vous modifiez la valeur indiquée pour ce fichier, les chemins d'accès appartenant à ce dernier seront recréés, sauf si le paramètre SRTSEQ a pour valeur *HEX.

*SAME

La valeur ne change pas.

*JOB

L'identificateur de langue indiqué dans la description de travail est utilisé.

valeur-caractères

Indiquez un identificateur de langue.

Vérification niveau de format (LVLCHK)

Indique si un contrôle de niveau est effectué sur les identificateurs des formats d'enregistrement. Ce contrôle permet de vérifier que l'identificateur de format d'enregistrement en cours est bien celui figurant dans le programme qui a demandé l'ouverture du fichier physique.

*SAME

La valeur de vérification de niveau du membre ne change pas.

*YES

Les identificateurs de formats d'enregistrements sont vérifiés à l'ouverture du fichier. Si les identificateurs ne correspondent pas, un message d'erreur est envoyé au programme qui a demandé l'ouverture du fichier et ce dernier n'est pas ouvert.

*NO

Les identificateurs de niveau ne sont pas vérifiés lors de l'ouverture du fichier.

Résidant en mémoire (KEEPINMEM)

Indique si SQE (SQL Query Engine) doit transférer les données vers un pool de mémoire principal pour un membre de fichier lorsque les données sont utilisées dans la requête pour améliorer les performances.

*SAME

L'attribut de maintien en mémoire reste inchangé.

*NO

Les données du membre ne seront pas transférées vers un pool de mémoire principal.

*YES

Les données du membre pourront être transférées vers un pool de mémoire principal.

Remarque :Le paramètre MEMORY_POOL_PREFERENCE du fichier d'options de requête (QAQQINI) permet d'indiquer le pool de mémoire principal à utiliser préférentiellement.

Groupe de noeuds (NODGRP)

Indique le nom du groupe de noeuds sur lequel le fichier est réparti.

Valeurs uniques

*SAME

La valeur reste inchangée.

*NONE

Le fichier n'est pas réparti et les données associées se trouvent sur le système local.

Qualificatif 1 : Groupe de noeuds

nom

Indiquez le nom du groupe de noeuds associé à ce fichier.

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 recherche porte sur la bibliothèque en cours de l'unité d'exécution. Si aucune bibliothèque n'est définie comme bibliothèque en cours pour l'unité d'exécution, la recherche porte sur la bibliothèque QGPL.

nom

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

Clé de partitionnement (PTNKEY)

Indique une zone ou un ensemble de zones utilisées comme clé de partitionnement des données réparties.

Remarque :Ce paramètre n'est pas admis si NODGRP(*NONE) est indiqué. Si un nom de groupe de noeuds est précisé (paramètre NODGRP), un ou plusieurs noms de zone doivent être indiqués.

Valeurs uniques

*SAME

La valeur reste inchangée.

Autres valeurs (jusqu'à 300 répétitions)

nom

Indiquez le nom de la zone à utiliser pour définir la clé de partitionnement.

Texte 'descriptif' (TEXT)

Texte décrivant brièvement l'objet.

*SAME

La description du fichier ne change pas.

*BLANK

Aucun texte n'est indiqué.

valeur-alphanumérique

Tapez un texte d'au plus 50 caractères, entre apostrophes.

ID codé de jeu de caractères (CCSID)

Indique le CCSID à utiliser pour décrire les données de type caractère des zones du fichier.

Remarques :

• Si ce paramètre est indiqué, vous devez également spécifier SRCFILE(*NONE).
• Le CCSID ne peut pas être modifié si :
  • Tout CCSID explicite de niveau zone ou fichier est indiqué dans le mot clé CCSID des DDS pour les zones du fichier physique, dans IDDU ou SQL.
  • Le fichier physique est décrit dans les programmes.
  • Le format du fichier physique contient une zone concaténée.

*SAME

Le CCSID reste inchangé.

*HEX

Le CCSID 65535 est utilisé, ce qui signifie que les données alphanumériques des zones sont traitées comme des données binaires et ne sont pas converties.

1 à 65535

Indiquez le CCSID à utiliser.

Si le fichier physique comporte un champ DBCS, un CCSID mixte doit correspondre au CCSID indiqué. Pour plus d'informations sur les CCSID admis, consultez le manuel Internationalisation de l'iSeries Information Center, à l'adresse http://www.ibm.com/eserver/iseries/infocenter.

Exemples

Exemple 1 : Modification de la date d'expiration de tous les membres

CHGPF   FILE(QGPL/INV)  EXPDATE('10/31/89')

Cette commande modifie la date d'expiration de tous les membres du fichier physique INV en le 31 octobre 1989.

Exemple 2 : Modification de la taille d'un fichier

CHGPF   FILE(QGPL/DDMF)  SIZE(*NOMAX)  SYSTEM(*RMT)

Cette commande modifie la taille du fichier INV situé dans la bibliothèque QGPL sur le système éloigné. Avant d'indiquer la commande ci-dessus, cet utilisateur a créé un fichier DDM à l'aide de la commande CRTDDMF FILE(QGPL/DDMF) RMTFILE(QGPL/INV) RMTLOCNAME(AS400).

Exemple 3 : Ajout, retrait et modification de zones

CHGPF   FILE(QGPL/T1)  SRCFILE(QDDSSRC)

Cette commande ajoute des zones, supprime des zones et modifie des attributs de zone, en fonction de la DDS du membre T1 du fichier source QDDSSRC. Avant d'indiquer la commande ci-dessus, l'utilisateur a modifié le membre source.

Messages d'erreur

Messages *ESCAPE

CPF326A

L'opération a échoué pour le fichier &1 de la bibliothèque &2.

CPF327F

L'opération a échoué pour le fichier &1 de la bibliothèque &2.

CPF7304

Fichier &1 de &2 non modifié.

CPF7305

Le fichier &1 de &2 a été modifié, mais les demandes réparties ont échoué.