CHGSRCPF

La commande CHGSRCPF (Modifier un fichier physique source) permet de modifier les attributs d'un fichier physique source 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.

Restrictions :

• Pour modifier un fichier source physique, 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.
• Pour modifier le fichier, un verrouillage exclusif est nécessaire ; personne ne peut utiliser le fichier.

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.

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.

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 utilisé pour décrire les données alphanumériques dans les zones du fichier.

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

Exemples

Exemple 1 : Modification de la date d'expiration

CHGSRCPF   FILE(QGPL/INV)  EXPDATE('10/31/88')

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

Exemple 2 : Modification du texte

CHGSRCF   FILE(QGPL/DDMF)  TEXT('Fichier d'inventaire')
          SYSTEM(*RMT)

Cette commande modifie le texte 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).

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