CHGLF

La commande CHGLF (Modifier un fichier logique) permet de modifier les attributs d'un fichier logique 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 CHGLFM (Modifier un membre de fichier logique).

Paramètres

Fichier logique (FILE)

Indique le fichier logique à modifier.

Ce paramètre est obligatoire.

Remarque :Si un fichier DDM (Gestion de fichiers éloignés) est indiqué, le nom du fichier logique et celui du système éloigné sont contenus dans ce fichier. Pour plus d'informations, reportez-vous à la description du paramètre Système (SYSTEM).

Qualificatif 1 : Fichier logique

nom

Indiquez le nom du fichier logique.

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.

Système (SYSTEM)

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

*LCL

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

*RMT

Le fichier logique est modifié sur le système éloigné à l'aide de DDM (Gestion de fichiers éloignés). Le nom de fichier logique indiqué pour le paramètre Fichier logique (FILE) doit correspondre au nom du fichier DDM (créé à l'aide de la commande CRTDDMF). Ce dernier contient le nom du fichier logique à modifier et le nom du système éloigné sur lequel il réside.

*FILETYPE

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

Forcer reconstruction chemin (FRCRBDAP)

Indique s'il faut forcer la reconstruction des chemins d'accès associés aux fichiers logiques joints ou aux fichiers dotés de chemins d'accès par clé.

Remarque :Pour un fichier logique joint, ce paramètre s'applique à tous les chemins d'accès secondaires joints, même lorsque le fichier logique joint n'est pas un fichier à clé.

*NO

Les chemins d'accès ne sont pas explicitement marqués comme devant être reconstruits.

*YES

Les chemins d'accès sont marqués comme étant incorrects et sont reconstruits de manière asynchrone par le travail de serveur de la base de données.

Nombre maximal de membres (MAXMBRS)

Indique le nombre maximal de membres que peut contenir le fichier logique. 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 une valeur représentant le nombre maximal de membres pour le fichier logique. Les valeurs admises sont comprises entre 1 et 32767.

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 logique. Ce paramètre ne peut être utilisé que dans le cas d'un fichier joint ou comportant un chemin d'accès par clé.

Remarque :Pour un fichier logique joint, ce paramètre s'applique à tous les chemins d'accès secondaires joints, même lorsque le fichier joint ne comporte pas un chemin d'accès par clé.

*SAME

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

*IMMED

Le chemin d'accès est maintenu en permanence pour chaque membre du fichier logique. Ce chemin d'accès est modifié chaque fois qu'un enregistrement est modifié, ajouté au membre ou supprimé. Les enregistrements sont modifiés via un fichier logique qui utilise le membre de fichier physique contenant les données, que ce fichier logique soit ouvert ou fermé. *IMMED est indiqué pour chaque fichier requérant des clés uniques afin que toutes les opérations d'insertion et de mise à jour soient uniques.

*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 retardée jusqu'à ce que le membre soit ouvert pour être utilisé. Le chemin d'accès est alors modifié uniquement pour les enregistrements qui ont été ajoutés, supprimés ou modifiés depuis la dernière fermeture du fichier. *DLY n'est pas admis pour les chemins d'accès requérant des valeurs de clé unique.

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

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.

Pgm de sélection de format (FMTSLR)

Indique le programme de sélection de formats d'enregistrement, appelé lorsqu'un membre de fichier logique comporte plusieurs formats d'enregistrements logiques. Ce programme, défini par l'utilisateur, est appelé lorsqu'un enregistrement est ajouté au fichier base de données, et que le nom de son format ne figure pas dans le programme écrit en langage évolué. Ce paramètre n'est pas admis si le fichier logique ne comporte qu'un format d'enregistrement.

Valeurs uniques

*SAME

Le nom du programme de sélection appelé ne change pas.

*NONE

Aucun programme de sélection n'est prévu pour ce fichier logique. Le fichier ne peut comporter plus d'un format d'enregistrement logique, ou un nom de format d'enregistrement doit figurer dans le programme écrit en langage évolué.

Qualificatif 1 : Pgm de sélection de format

nom

Entrez le nom du programme de sélection de format appelé lorsqu'un enregistrement est ajouté dans un membre comportant plusieurs formats.

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

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). La valeur indiquée pour un fichier logique doit être inférieure ou égale à la plus petite valeur indiquée pour les fichiers physiques qui lui sont associés. Sinon, la valeur est ignorée et un message d'information est émis. Si un fichier physique associé à ce fichier logique est journalisé, il est préférable d'indiquer une valeur FRCRATIO très grande ou *NONE.

*SAME

La valeur FRCRATIO du fichier 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.

Vérification niveau de format (LVLCHK)

Indique si les identificateurs de format d'enregistrement figurant dans le programme sont comparés avec ceux qui se trouvent dans le fichier logique lors de l'ouverture du fichier. Si la comparaison est demandée, les identificateurs de format d'enregistrement du programme doivent correspondre à ceux du fichier logique. Cette valeur peut faire l'objet d'une substitution à l'aide de la commande OVRDBF (Substituer un fichier base de données) au moment de l'exécution.

*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 un ou plusieurs chemins d'accès vers un pool de mémoire principal pour un membre de fichier lorsque le ou les chemins d'accès sont utilisés dans la requête pour améliorer les performances.

*SAME

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

*NO

Le ou les chemins d'accès du membre ne seront pas transférés vers un pool de mémoire principal.

*YES

Le ou les chemins d'accès du membre pourront être transférés 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.

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.

Exemples

Exemple 1 : Modification du programme de sélection de formats

CHGLF   FILE(QGPL/INV)  FMTSLR(INVFMTS)

Cette commande modifie le fichier logique INV qui est stocké dans la bibliothèque QGPL, ce qui donne lieu au nouveau programme de sélection de formats, INVFMTS, qui est utilisé avec ce fichier logique. Le programme de sélection de formats est recherché dans la liste des bibliothèques (*LIBL).

Exemple 2 : Modification d'un fichier situé sur le système éloigné

CHGLF   FILE(QGPL/DDMF)  FMTSLR(INVFMTS)  SYSTEM(*RMT)

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

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