OVRDKTF

La commande OVRDKTF permet de (1) remplacer le fichier désigné dans le programme, (2) remplacer certains paramètres d'un fichier utilisés par le programme, ou (3) remplacer le fichier désigné dans le programme et remplacer certains paramètres du fichier traité. Les paramètres substitués par cette commande sont spécifiés dans la description de fichier, dans le programme ou dans d'autres commandes de substitution de fichiers. Si un fichier nommé dans le programme fait l'objet d'une substitution, le nom de ce fichier est spécifié au paramètre FILE et celui du fichier de substitution (fichier traité) est indiqué au paramètre TOFILE. La commande OVRDKTF spécifie également des paramètres permettant de remplacer des valeurs contenues dans la description du fichier de substitution. Si le fichier nommé dans le programme n'est pas remplacé mais que certains de ses paramètres le sont, le nom du fichier est spécifié au paramètre FILE et *FILE est indiqué au paramètre TOFILE. Les paramètres remplacés sont alors spécifiés par les autres paramètres de la commande OVRDKTF. Les paramètres non spécifiés n'ont pas d'effet sur les paramètres indiqués dans la description de fichier, dans le programme ou dans d'autres commandes de substitution.

Les 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/ contiennent des informations complémentaires sur la substitution de fichiers.

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

Paramètres

Fichier à substituer (FILE)

Désigne le fichier auquel s'applique cette commande de substitution. Le fichier spécifié doit être un fichier disquette si *FILE est indiqué au paramètre TOFILE (Fichier disquette de substit). 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.

Fichier disquette de substit (TOFILE)

Indique le fichier disquette 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. Les valeurs de ces paramètres se substituent aux valeurs de ces mêmes paramètres dans le fichier unité de disquette, le programme ou d'autres commandes (OVRDKTF).

Valeurs uniques

*FILE

Certains paramètres du fichier disquette indiqué au paramètre FILE (Fichier à substituer) sont remplacés par des valeurs de cette commande.

Qualificatif 1 : Fichier disquette de substit

nom

Indiquez le nom du fichier disquette 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 unité est recherché dans la bibliothèque en cours du travail. Si celle-ci ne figure pas dans la liste des bibliothèques, QGPL est prise par défaut.

nom

Indiquez le nom de la bibliothèque contenant le fichier unité.

Unité (DEV)

Indique l'unité de disquettes utilisée avec le fichier disquette pour les opérations d'E-S. Entrez le nom de l'unité qui remplace celle indiquée dans le fichier disquette, dans le programme ou dans d'autres commandes OVRDKTF (Substituer un fichier disquette). Le nom correspondant à la description d'unité de disquette fournie par IBM est DKT01. Ce paramètre n'est pas pris en compte si la valeur *YES, indiquée au paramètre SPOOL (Données en spoule), s'applique au fichier lors de son ouverture.

Ce paramètre remplace la valeur indiquée dans le fichier unité, dans le programme, ou dans d'autres commandes OVRDKTF appelées.

nom

Indiquez le nom de l'unité utilisée avec ce fichier disquette. Il doit s'agir d'un nom d'unité existant déjà sur le système avant que le fichier unité ne soit créé.

Identificateur de volume (VOL)

Indique un ou plusieurs identificateurs de volume devant être utilisés par le fichier disquette. Sur l'unité, les volumes doivent être écrits dans le même ordre que les identificateurs de volume dans ce paramètre. Si le fichier est ouvert pour être lu vers l'arrière, les identificateurs de volume de la liste sont traités du dernier au premier (tandis que les unités de la liste sont utilisées de la première à la dernière). Si une liste d'identificateurs de volume est fournie pour le fichier, des messages opérateur indiquent le nom du volume requis.

Remarque :Ce paramètre remplace les identificateurs de volume spécifiés dans le fichier unité de disquette, dans le programme ou dans d'autres commandes OVRDKTF appelées.

Valeurs uniques

*NONE

Les identificateurs de volume de disquette ne sont pas indiqués pour ce fichier dans cette commande. Ils peuvent être spécifiés ultérieurement avant l'ouverture du fichier unité, soit dans une commande OVRDKTF (Substituer fichier disquette), CHGDKTF (Modifier un fichier disquette) ou dans le programme en langage évolué. Sinon, aucune vérification d'identificateurs de volume n'est effectuée.

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

valeur-alphanumérique

Indiquez les identificateurs des volumes (6 caractères alphanumériques au maximum) dans l'ordre où les volumes seront écrits. Un blanc sert de caractère de séparation lorsque plusieurs identificateurs doivent être indiqués.

Label du fichier (LABEL)

Indique le label du fichier de données se trouvant sur disquette et devant être traité ou créé. Pour les fichiers d'entrée (dans le système), ce label désigne l'identificateur du fichier de la disquette. Pour les fichiers de sortie (sur disquette), il indique l'identificateur du fichier créé sur la disquette.

Remarque :Ce paramètre remplace le label indiqué dans le fichier disquette, dans le programme ou dans d'autres commandes OVRDKTF appelées.

valeur-alphanumérique

Indiquez un identificateur comportant 8 caractères au maximum pour le fichier de données utilisé avec le fichier disquette.

Type échange fichier disquette (EXCHTYPE)

Indique, pour les fichiers de sortie sur disquette uniquement, le type d'échange utilisé par le fichier unité lors d'une opération d'écriture sur disquette.

Ce paramètre remplace la valeur indiquée dans le fichier unité, dans le programme, ou dans d'autres commandes OVRDKTF appelées.

*STD

Le format d'échange BASIC est utilisé pour une disquette de type 1 ou 2. Le format d'échange H est utilisé pour une disquette de type 2D .

*BASIC

le type d'échange BASIC est utilisé.

*H

Le type d'échange H est utilisé.

*I

Le type d'échange I est utilisé.

Code (CODE)

Indique le type du code caractère utilisé par le fichier unité lorsque le système lit ou écrit des données sur disquette. Ce code peut être *EBCDIC ou *ASCII.

Ce paramètre remplace la valeur indiquée dans le fichier unité, dans le programme, ou dans d'autres commandes OVRDKTF appelées.

*EBCDIC

Le code caractère EBCDIC est utilisé avec ce fichier disquette.

*ASCII

Le code caractères ASCII est utilisé.

Date de création (CRTDATE)

Indique, pour les fichiers d'entrée sur disquette uniquement, la date de création du fichier sur la disquette. Si la date de création éventuellement spécifiée dans ce paramètre ne correspond pas à la date indiquée sur la disquette, un message d'erreur est envoyé au programme.

Ce paramètre remplace les valeurs indiquées dans le fichier unité, dans le programme ou dans d'autres commandes OVRDKTF appelées.

*NONE

La date de création du fichier de données n'est pas vérifiée, sauf si elle est fournie avant l'ouverture du fichier unité, soit dans une commande OVRDKTF ou CHGDKTF, soit dans le programme en langage évolué.

date

Indiquez la date de création du fichier dans le format défini par les attributs de travail DATFMT et, si des séparateurs sont utilisés, par les attributs DATSEP. Toutefois, la date spécifiée est indiquée sur le label de disquette au format aammjj.

Date d'expiration du fichier (EXPDATE)

Indique, pour les fichiers de sortie sur disquette uniquement, la date de péremption du fichier de données utilisé par ce fichier unité. Le fichier de données sera protégé en écriture jusqu'à cette date incluse.

Remarque :La date de péremption remplace la valeur indiquée dans le fichier unité, dans le programme, ou dans d'autres commandes OVRDKTF appelées.

*NONE

Le fichier est protégé uniquement le jour de sa création.

*PERM

Le fichier est protégé de façon permanente. La valeur 999999 est écrite sur la disquette.

date

Indiquez la date de péremption du fichier dans un format défini par les attributs de travail DATFMT et, si des séparateurs sont utilisés, DATSEP. Toutefois, la date spécifiée est indiquée sur le label de disquette au format aammjj.

Données en spoule (SPOOL)

Indique si les données en entrée ou en sortie du fichier disquette doivent être placées dans le spoule.

Ce paramètre remplace la valeur de spoule indiquée dans le fichier unité, dans le programme ou dans d'autres commandes OVRDKTF appelées.

*NO

Les données ne sont pas envoyées dans le spoule. Si ce fichier est ouvert en entrée, les données sont lues directement sur la disquette. S'il s'agit d'un fichier en sortie, les données sont écrites directement sur la disquette au fur et à mesure qu'elles sont traitées par le programme.

Remarque :Si SPOOL(*NO) est spécifié, les paramètres suivants sont ignorés : OUTQ, MAXRCDS, SCHEDULE, HOLD, SAVE, OUTPTY et USRDTA.

*YES

Les données sont envoyées dans le spoule. Si ce fichier est ouvert en lecture, le fichier spoule en entrée désigné ou le fichier spoule en entrée suivant non désigné sera traité. S'il s'agit d'un fichier de sortie, les données sont envoyées dans le spoule en attendant d'être traitées par un éditeur de spoule. 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/ contient des informations sur les fichiers spoule en entrée désignés et non désignés.

File d'attente en sortie (OUTQ)

Indique, pour les sorties spoule uniquement, la file d'attente en sortie du fichier spoule en sortie.

Ce paramètre remplace la file d'attente en sortie indiquée dans le fichier unité ou dans d'autres commandes OVRDKTF appelées.

Qualificatif 1 : File d'attente en sortie

nom

Indiquez le nom de la file d'attente en sortie dans laquelle les données sont envoyées.

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

nom

Indiquez la bibliothèque contenant la file d'attente en sortie.

Nombre maxi enreg en sortie (MAXRCDS)

Indique, pour une sortie spoule uniquement, le nombre maximal d'enregistrements contenus dans le fichier spoule en sortie pour des travaux spoule utilisant le fichier disquette.

Ce paramètre remplace la valeur indiquée dans le fichier disquette ou dans d'autres commandes OVRDKTF appelées.

*NOMAX

Le nombre d'enregistrements dans le fichier spoule en sortie est illimité.

1 à 500000

Indiquez le nombre maximal d'enregistrements pouvant être contenus dans le fichier spoule en sortie.

Prévision de sortie spoule (SCHEDULE)

Indique à quel moment le fichier spoule en sortie est mis à la disposition d'un éditeur de spoule. Ce paramètre ne concerne que les fichiers spoule en sortie.

Ce paramètre remplace la valeur de prévision indiquée dans le fichier unité, ou dans d'autres commandes OVRDKTF appelées.

*JOBEND

Le fichier spoule en sortie est mis à la disposition de l'éditeur de spoule une fois le travail terminé.

*FILEEND

Le fichier spoule en sortie est mis à la disposition de l'éditeur de spoule dès sa fermeture dans le programme.

*IMMED

Le fichier spoule en sortie est mis à la disposition de l'éditeur de spoule dès son ouverture dans le programme.

Suspendre fichier spoule (HOLD)

Indique, pour un fichier spoule en sortie uniquement, si le fichier est suspendu. Ce fichier peut alors être libéré via la commande RLSSPLF (Libérer un fichier spoule).

Remarque :Ce paramètre remplace la valeur de suspension indiquée dans le fichier disquette ou dans d'autres commandes OVRDKTF appelées.

*NO

Le fichier spoule en sortie n'est pas suspendu dans la file d'attente en sortie. La sortie spoule est disponible pour un éditeur, en fonction de la valeur indiquée au paramètre SCHEDULE (Prévision de sortie spoule).

*YES

Le fichier spoule en sortie est suspendu jusqu'à ce qu'il soit libéré via la commande RLSSPLF (Libérer un fichier spoule).

Conserver fichier spoule (SAVE)

Indique, pour un fichier spoule en sortie uniquement, si le fichier est sauvegardé (c'est-à-dire laissé en file d'attente) une fois la sortie produite.

Remarque :Ce paramètre remplace la valeur de sauvegarde indiquée dans le fichier disquette ou dans d'autres commandes OVRDKTF appelées.

*NO

Les données du fichier spoule ne sont pas sauvegardées dans la file d'attente en sortie.

*YES

Les données du fichier spoule sont sauvegardées dans la file d'attente en sortie jusqu'à ce que le fichier soit supprimé. Une fois le fichier produit, son état passe de WTR à SAV.

Priorité de sortie (en OUTQ) (OUTPTY)

Indique la priorité de sortie pour les fichiers spoule en sortie produits par ce travail. Le niveau de priorité le plus élevé est 1, et le niveau le plus bas est 9.

*JOB

La priorité de sortie du travail qui a créé le fichier spoule est utilisée.

1 à 9

Indiquez un nombre de 1 (priorité la plus élevée) à 9 (priorité la plus faible) correspondant à la priorité de sortie du fichier spoule.

Référence utilisateur (USRDTA)

Pour les sorties spoule, indique la référence définie par l'utilisateur pour identifier le fichier.

*BLANK

Dix blancs sont utilisés comme référence utilisateur.

valeur-alphanumérique

Entrez un descriptif de 10 caractères au maximum.

User specified DBCS data (IGCDTA)

Considérations DBCS : non applicable.

*NO

Considérations DBCS : non applicable.

*YES

Considérations DBCS : non applicable.

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

Protection autre substitution (SECURE)

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

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

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

Exemple 1 : modification de spécifications de spoule

OVRDKTF   FILE(OUT)  VOL(DPT706)  LABEL(STATUSR)  SPOOL(*YES)

Cette commande permet de modifier la spécification de spoule pour le fichier en sortie OUT. Lorsqu'un programme génère des données en sortie pour le fichier OUT, les données sont envoyées dans le spoule en attendant d'être traitées par un éditeur de spoule. Ce dernier traite les données en les écrivant dans un fichier de données nommé STATUSR qui se trouve sur une disquette possédant l'identificateur de volume DPT706.

Considérations DBCS, non applicable

Considérations DBCS, non applicable

Considérations DBCS, non applicable

Messages d'erreur

Messages *ESCAPE

CPF180C

Fonction &1 non admise.

CPF1892

Fonction &1 non admise.