OVRSAVF

La commande OVRSAVF (Substituer un fichier sauvegarde) permet de (1) remplacer un fichier indiqué dans un programme, (2) remplacer certains attributs d'un fichier qui sont utilisés par un programme, (3) remplacer le fichier indiqué dans un programme et certains attributs du fichier de substitution.

Cette commande ne s'applique pas aux commandes de sauvegarde et de restauration.

Pour plus d'informations sur la substitution de fichiers, consultez le manuel Catégorie des fichiers et systèmes de fichiers 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 sauvegarde dans le programme auquel s'applique cette commande de substitution. Il doit s'agir d'un fichier sauvegarde lorsque la valeur du paramètre TOFILE (Fichier sauvegarde) est *FILE.

Remarque :Les informations d'un fichier sauvegarde ne sont significatives que pour les opérations de sauvegarde et de restauration de l'OS/400 ; il n'est pas conseillé de rediriger un autre type de fichier vers un fichier sauvegarde ou vice versa.

Ce paramètre est obligatoire.

nom

Indiquez le nom du fichier sauvegarde.

Fichier sauvegarde (TOFILE)

Indique le fichier sauvegarde utilisé à la place du fichier spécifié au paramètre FILE (Fichier à substituer) ou si *FILE est spécifié, indique que certains attributs seront remplacés par des paramètres précisés dans cette commande. Ces paramètres remplacent les valeurs indiquées dans le fichier sauvegarde ou dans le programme.

Valeurs uniques

*FILE

Certains paramètres du fichier sauvegarde indiqué au paramètre FILE seront remplacés par des valeurs spécifiées dans cette commande.

Qualificatif 1 : Fichier sauvegarde

nom

Indiquez le nom du fichier sauvegarde 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

Le fichier sauvegarde sera recherché 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

Indiquez la bibliothèque contenant le fichier sauvegarde.

Ajout au fichier (EXTEND)

Indique, pour les opérations de sortie uniquement, si les nouveaux enregistrements sont ajoutés dans le fichier sauvegarde. Cette option sert à démarrer un traitement après une défaillance du système ou d'une application. Lorsque cette opération est terminée, le fichier doit contenir l'image d'une seule opération de sauvegarde, effectuée à l'aide d'une commande de sauvegarde ; sinon il ne sera pas possible de restaurer des objets à partir du fichier sauvegarde. Ce paramètre remplace la valeur spécifiée dans le programme. Les informations concernant la séquence des enregistrements dans le fichier permet, après un incident, de vérifier qu'un enregistrement n'a pas été omis ou émis deux fois.

*NO

Les enregistrements ne sont pas ajoutés à la fin du fichier sauvegarde, mais ils remplacent les enregistrements existant dans le fichier. Si le fichier sauvegarde contient effectivement des enregistrements, un message d'interrogation sera envoyé. Vous pourrez alors annuler l'opération. Si aucune valeur n'est spécifiée pour ce paramètre par le programme ou dans une commande de substitution, cette valeur est prise par défaut lors de l'ouverture du fichier en écriture.

*YES

De nouveaux enregistrements sont ajoutés à la fin du fichier sauvegarde.

Position de début (POSITION)

Indique la position à partir de laquelle seront lus les enregistrements dans le fichier sauvegarde. Le premier enregistrement lu sera situé au début du fichier (*START) ou à une position relative sur le fichier (*RRN). Ce paramètre remplace la valeur indiquée dans le programme.

Valeurs uniques

*START

Le premier enregistrement lu est le premier enregistrement du fichier. Si aucune valeur n'est spécifiée pour ce paramètre par le programme ou dans une commande de substitution, cette valeur sera prise par défaut lors de l'ouverture du fichier en lecture.

Elément 1 : Option de position

*RRN

Le numéro relatif d'enregistrement indiqué pour le second élément de ce paramètre est le premier enregistrement à extraire.

Elément 2 : *RRN--Numéro enregistrement

entier-sans signe

Indiquez le numéro (sa position dans le fichier) de l'enregistrement à lire en premier.

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.

Protection autre substitution (SECURE)

Indique si le fichier est protégé contre les effets de commandes de substitution précédentes.

*NO

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

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

OVRSAVF   FILE(ONLINE)  POSITION(*RRN 100)  SECURE(*YES)

Cette commande permet de substituer le fichier ONLINE de sorte que le premier enregistrement obtenu après ouverture du fichier pour entrée possède le numéro d'enregistrement relatif 100. Le fichier est également protégé contre les substitutions (des appels de programme précédents).

Messages d'erreur

Messages *ESCAPE

CPF180C

Fonction &1 non admise.

CPF1892

Fonction &1 non admise.