OVRICFF

La commande OVRICFF modifie le nom du fichier dans le programme ainsi que certains paramètres du fichier en cours de traitement. Les paramètres modifiés par cette commande peuvent être spécifiés dans la description du fichier, dans le programme ou dans d'autres commandes de modification des fichiers exécutées ultérieurement.

Si un nom de fichier du programme est modifié, le nom de ce programme est spécifié dans le paramètre FILE et le nom du fichier qui le remplace (le fichier en cours de traitement) est spécifié dans le paramètre TOFILE.

Cette commande peut également spécifier des paramètres qui modifieront les valeurs contenues dans la description du fichier de substitution. Si le nom du fichier dans le programme n'est pas remplacé mais que certains paramètres du fichier le sont, le nom du fichier sera spécifié dans le paramètre FILE et *FILE dans le paramètre TOFILE. Les paramètres modifiés sont alors spécifiés par les autres paramètres de la commande OVRICFF. Les paramètres non spécifiés n'affectent pas ceux indiqués dans la description du fichier, le programme ou d'autres commandes de modification exécutées ultérieurement.

Pour plus d'informations sur le traitement des substitutions, reportez-vous aux manuels Catégorie des fichiers et systèmes de fichiers de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/, Application Display Programming book, SC41-5715 et Catégorie Impression de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Remarque :L'utilisation de cette commande ne provoque pas la substitution immédiate d'un fichier. Les informations contenues dans la commande sont stockées jusqu'à l'utilisation du fichier, qui est alors remplacé.

Paramètres

Fichier à substituer (FILE)

Indique le fichier auquel s'applique cette commande de substitution. Il doit s'agir d'un fichier ICF si la valeur *FILE est indiquée au paramètre TOFILE (Fichier ICF de substitution). Autrement, n'importe quel nom de fichier d'unité ou de fichier base de données peut être indiqué.

Ce paramètre est obligatoire.

nom

Indiquez le nom du fichier ICF.

Fichier ICF de substitution (TOFILE)

Indique le nom qualifié du fichier ICF (10 caractères au maximum) utilisé à la place du fichier spécifié au paramètre FILE (Fichier à substituer) ou, si la valeur *FILE est spécifiée, indique que certains attributs seront remplacés par les paramètres de cette commande. Ces paramètres remplacent les valeurs précisées dans le fichier ICF ou dans le programme.

Valeurs uniques

*FILE

Certains paramètres du fichier ICF indiqué au paramètre FILE (Fichier à substituer) sont remplacés par des valeurs précisées dans cette commande.

Qualificatif 1 : Fichier ICF de substitution

nom

Indiquez le nom du fichier ICF de substitution.

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 description du fichier ICF est recherchée dans la bibliothèque en cours du travail. Si celle-ci n'est pas définie dans la liste des bibliothèques, QGPL est prise par défaut.

nom

Entrez le nom de la bibliothèque contenant la description du fichier ICF.

Unité programme à acquérir (ACQPGMDEV)

Désigne l'unité programme acquise lors de l'ouverture du fichier. Ce paramètre remplace la valeur indiquée dans le fichier ICF, le programme ou les autres commandes OVRICFF exécutées ultérieurement.

*NONE

Aucune unité n'est acquise. Toutes les unités utilisées avec ce fichier doivent l'être explicitement avant que des opérations d'E-S puissent avoir lieu.

valeur-alphanumérique

Indiquez le nom de l'unité programme acquise lors de l'ouverture du fichier. Ce nom devra être spécifié dans les commandes ADDICFDEVE (Ajouter unité à fichier ICF) ou OVRICFDEVE (Substituer unité fichier ICF) avant l'ouverture du fichier.

Longueur maximale d'enreg (MAXRCDLEN)

Indique la longueur maximale d'enregistrement utilisée à l'ouverture du fichier. Ce paramètre remplace la valeur indiquée dans le fichier ICF, le programme ou les autres commandes OVRICFF exécutées ultérieurement.

*CALC

La valeur calculée dans le fichier est utilisée lors de l'ouverture du fichier.

entier

Indiquez la longueur d'enregistrement (en nombre de caractères) utilisée lors de l'ouverture du fichier. Les valeurs possibles sont comprises entre 1 et 32767. Si la longueur d'enregistrement est inférieure à la valeur calculée dans le fichier, cette dernière est utilisée.

Temps d'attente maxi fichier (WAITFILE)

Indique le délai d'attente (en secondes) par le programme pour l'allocation des ressources fichier 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.

*IMMED

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

*CLS

Le temps d'attente par défaut spécifié dans la description de classe est utilisé pour l'allocation des ressources du fichier.

entier

Indiquez, en secondes, le temps d'attente maximal. Les valeurs possibles sont comprises entre 1 et 32767.

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.

*NOMAX

Le temps pendant lequel le système attend l'aboutissement de l'opération est illimité.

*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

Indiquez en secondes, le temps d'attente maximal du programme.

Vérification niveau de format (LVLCHK)

Indique si les identificateurs de niveau des formats d'enregistrements de ce fichier sont vérifiés à l'ouverture du fichier. Au cours de cette opération, le système vérifie les identificateurs de niveau et compare l'identificateur de format d'enregistrement utilisé par le programme avec l'identificateur correspondant dans le fichier unité. Un même nom de format d'enregistrement pouvant exister dans plusieurs fichiers, un identificateur unique interne au système est donné à chaque format lors de sa création.

Remarque :Avec cette commande, vous ne pouvez pas remplacer la valeur de vérification *NO par *YES.

*NO

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

Protection autre substitution (SECURE)

Indique si ce fichier est protégé contre les effets de commandes de substitution de fichier lancées précédemment.

*NO

Le fichier n'est pas protégé. Ses valeurs peuvent être remplacées par des commandes de substitution précédentes.

*YES

Ce fichier est protégé des substitutions précédentes.

Portée de substitution (OVRSCOPE)

Indique le champ d'application (la portée) de la substitution.

*ACTGRPDFN

Le champ d'application de la substitution est déterminé par le groupe d'activation du programme qui appelle cette commande. Lorsqu'il s'agit du groupe d'activation par défaut, le champ d'application est égal au niveau d'appel du programme appelant. Dans le cas contraire, le champ d'application correspond au groupe d'activation du programme appelant.

*CALLLVL

Le champ d'application de la substitution est déterminé par le niveau d'appel en cours. Toutes les opérations d'ouverture effectuées à un niveau d'appel identique ou supérieur au niveau en cours sont concernées par cette substitution.

*JOB

Le champ d'application de la substitution correspond au travail dans lequel cette dernière est exécutée.

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.

Le manuel Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/ contient des informations complémentaires sur la fonction de file d'attente de données.

Valeurs uniques

*NONE

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

nom

Indiquez la bibliothèque où figure 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.

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

Portée d'ouverture (OPNSCOPE)

Indique la portée de l'opération d'ouverture.

*ACTGRPDFN

La portée de l'opération d'ouverture est déterminée par le groupe d'activation du programme qui a appelé le programme de traitement de la commande OVRICFF. S'il s'agit du groupe d'activation par défaut, la portée correspond au niveau d'appel du programme appelant. S'il ne s'agit pas du groupe d'activation par défaut, la portée correspond au groupe d'activation du programme appelant.

*JOB

La portée de l'opération d'ouverture est le travail dans lequel cette dernière est exécutée.

Exemples

OVRICFF   FILE(ICFHIST)  TOFILE(PRSNNL/ICFCURT)

Cette commande permet de remplacer le fichier ICFHIST par le fichier ICF ICFCURT dans la bibliothèque PRSNNL.

Messages d'erreur

Messages *ESCAPE

CPF180C

Fonction &1 non admise.

CPF1892

Fonction &1 non admise.