OVRDSPF

La commande OVRDSPF (Substituer un fichier écran) 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 remplacés par cette commande sont indiqués dans la description de fichier, dans le programme ou dans d'autres commandes de substitution de fichiers.

Si un fichier désigné dans le programme est remplacé, son nom est indiqué au paramètre FILE et le nom du fichier de substitution (correspondant au fichier à traiter) est indiqué au paramètre TOFILE. La commande OVRDSPF permet également de définir des paramètres pour remplacer les valeurs contenues dans la description du fichier de substitution. Si le fichier désigné dans le programme n'est pas remplacé mais que certains paramètres le sont, le nom du fichier est indiqué au paramètre FILE et *FILE est indiqué au paramètre TOFILE. Les paramètres à remplacer sont alors indiqués explicitement dans la commande OVRDSPF. Les paramètres non définis dans cette commande n'ont aucune incidence sur les paramètres indiqués dans la description de fichier, dans le programme ou dans les autres commandes de substitution de fichier appelées ultérieurement.

Pour plus d'informations sur les fichiers de substitution, reportez-vous au manuel Application Display Programming book, SC41-5715.

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. Il doit s'agir d'un fichier écran si le paramètre TOFILE (Fichier écran de substitution) a pour valeur *FILE. Sinon, 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 écran de substitution (TOFILE)

Indique le fichier écran 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 à celles des mêmes paramètres indiqués dans le fichier écran, le programme ou d'autres commandes OVRDSPF.

Valeurs uniques

*FILE

Certains paramètres du fichier écran indiqué au paramètre FILE sont remplacés par les valeurs précisées dans cette commande.

Qualificatif 1 : Fichier écran de substitution

nom

Indiquez le nom du fichier d'unité écran 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

Entrez le nom de la bibliothèque contenant le fichier d'unité.

Unité (DEV)

Désigne une ou plusieurs unités écran utilisées avec le fichier écran. *REQUESTER désigne l'unité spécifiée par défaut.

Ce paramètre remplace les noms d'unités indiqués dans le fichier unité, le programme ou d'autres commandes OVRDSPF.

*REQUESTER

L'unité écran qui a appelé le programme est celle assignée au fichier lors de son ouverture.

nom

Indiquez le nom des unités écran à utiliser avec ce fichier d'unité. Chaque nom doit être connu du système (en tant que description d'unité) avant la création de ce fichier. *REQUESTER peut faire partie de la liste.

Un maximum de 50 noms (y compris *REQUESTER) peuvent être indiqués, mais le total ne peut excéder le nombre précisé au paramètre MAXDEV (Nombre maximal d'unités).

Identificateur de caractères (CHRID)

Indique l'identificateur de caractères (jeu de caractères graphiques et page de codes) pour le fichier. Lorsqu'un fichier écran contenant le mot clé CHRID dans ses DDS est utilisé avec une unité écran, le système convertit les données envoyées et reçues afin d'assurer l'exactitude des caractères affichés et des valeurs hexadécimales renvoyées au programme d'application. Pour plus d'informations sur le mot clé CHRID et sur les tables de conversion utilisées pour traiter les données envoyées et reçues, reportez-vous au manuel Application Display Programming book, SC41-5715.

Valeurs uniques

*DEVD

La valeur CHRID spécifiée dans la description d'unité de l'écran sur lequel fonctionne l'application est utilisée. Cette valeur signifie qu'aucune conversion n'est nécessaire car le fichier possède le même identificateur de caractères que le poste de travail. Pour obtenir la liste des valeurs admises, demandez l'invite du paramètre CHRID dans la commande CRTDEVDSP.

*SYSVAL

La valeur CHRID spécifiée pour le système sur lequel fonctionne l'application est utilisée. Une conversion peut être nécessaire, suivant l'identificateur de caractères du poste de travail.

*JOBCCSID

Les données alphanumériques sont modifiées du CHRID de l'unité vers le CCSID du travail en sortie du fichier écran, et du CCSID du travail vers le CHRID de l'unité, en sortie du fichier écran. Les données alphanumériques sont converties, si nécessaire, du CCSID de l'unité du travail, en entrée, et du CCSID du travail vers le CHRID de l'unité, en sortie.

Remarque :Cette valeur n'est pas admise si le fichier a été créé sur un système dont le niveau d'édition est antérieur à V2R3M0.

*CHRIDCTL

Le système vérifie l'attribut de définition de travail CHRIDCTL afin de déterminer si la valeur *JOBCCSID ou *DEVD doit être utilisée au paramètre de commande CHRID de ce fichier.

Elément 1 : Jeu de caractères graphiques

entier

Indiquez la valeur de jeu de caractères graphiques correspondant aux attributs de l'unité écran. Ces valeurs doivent être comprises entre 1 et 32767.

Elément 2 : Page de codes

entier

Indiquez la valeur de page de codes correspondant aux attributs de l'unité écran. Ces valeurs doivent être comprises entre 1 et 32767.

Format décimal (DECFMT)

Indique la valeur de format décimal utilisée lors de l'édition de zones numériques avec le mot clé DDS EDTCDE. La valeur de format décimal détermine l'utilisation de virgules et de points pour la position décimale et de séparateurs à position fixe composés de trois chiffres sur les zones éditées.

*FILE

La valeur de format décimal stockée avec le fichier lors de sa création est utilisée.

*JOB

La valeur de format décimal extraite de l'attribut de travail DECFMT lors de l'ouverture du fichier est utilisée.

Texte SFLEND (SFLENDTXT) - Aide

Indique d'où le texte A suivre et Fin est extrait lors de l'affichage d'un sous-fichier. Le texte A suivre... et Fin s'affiche dans un sous-fichier quand le mot clé SFLEND(*MORE) DDS est indiqué dans l'enregistrement de contrôle du sous-fichier.

*MSG

Utilisez le texte A suivre et Fin extrait des messages CPX6AB1 et CPX6AB2 existant dans le langage actif en cours du système quand le fichier est ouvert.

*FILE

Utilisez le texte A suivre et Fin enregistré dans le fichier lors de sa création. Ce texte a été extrait des messages CPX6AB1 et CPX6AB2 existant dans le langage actif du système lors de la création du fichier.

User specified DBCS data (IGCDTA)

Considérations DBCS : non applicable.

Pour les fichiers décrits par programme : For program-described files:

*NO

Considérations DBCS : non applicable.

*YES

Considérations DBCS : non applicable.

Pour les fichiers DDS : For DDS files:

*NO

Les seuls attributs DBCS du fichier sont ceux définis dans les DDS. The only DBCS attributes of the file are those defined in the DDS.

*YES

Les attributs DBCS en plus de ceux définis dans les DDS comprennent (1) la mise en vigueur du mot clé DDS de type de données alternatif (IGCALTTYP) et (2) l'identification des attributs DBCS des zones ou des messages non identifiés dans les DDS. DBCS attributes in addition to those defined in the DDS, include (1) putting the DDS keyword for alternative data type (IGCALTTYP) into effect, and (2) identifying DBCS attributes of fields or messages not identified in the DDS.

DBCS extension characters (IGCEXNCHR)

Indique si le système traite les caractères d'extension du jeu de caractères double octet (DBCS). Specifies whether the system processes double-byte character set (DBCS) extension characters.

*YES

Le système traite les caractères d'extension DBCS. The system processes DBCS extension characters.

*NO

Le système ne traite pas les caractères d'extension DBCS ; il les affiche comme des caractères non définis. The system does not process DBCS extension characters; it displays them as undefined characters.

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.

L'annexe A du manuel Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/ contient davantage d'informations sur ce paramètre.

Remarque :L'allocation de l'unité par la ressource doit être immédiate lorsqu'une acquisition est exécutée sur le fichier.

Ce paramètre remplace le temps d'attente indiqué dans le fichier unité, le programme ou d'autres commandes OVRDSPF.

*IMMED

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

*CLS

Le temps d'attente par défaut précisé dans la description de classe est utilisé.

entier

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

Temps d'attente maxi enreg (WAITRCD)

Indique, en secondes, le temps d'attente maximal nécessaire à la réalisation d'une opération de lecture sur les unités invitées effectuée sur un fichier à unités multiples dans un programme en langage évolué. Pour plus d'informations concernant les fichiers à unités multiples, reportez-vous à la brochure de référence du langage évolué. Le programme effectuant l'opération de lecture attend les données de toutes les unités invitées acquises par le fichier. Si un enregistrement n'est pas renvoyé à partir d'une unité invitée dans le délai imparti, un message de notification est envoyé au programme. Ce paramètre n'a aucune incidence sur les opérations d'entrée sur une unité.

Ce paramètre est également utilisé pour indiquer le temps d'attente (en secondes) observé par un programme CL pour traiter une commande WAIT. Si, passé ce délai, un enregistrement n'est pas renvoyé par une unité sollicitée, un message d'arrêt programme est envoyé au programme CL.

Ce paramètre remplace le temps d'attente indiqué dans le fichier unité, le programme ou d'autres commandes OVRDSPF.

*NOMAX

Le temps d'attente n'est pas limité.

*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

Indique, en secondes, le temps d'attente maximal nécessaire à la réalisation d'une opération de lecture sur les unités invitées effectuée sur un fichier à unités multiples dans un programme en langage évolué.

Vérification niveau de format (LVLCHK)

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

La vérification de niveau ne peut être effectuée que si le programme contient les identificateurs des formats d'enregistrement. Cette commande ne permet pas de remplacer la valeur de vérification de niveau *NO par *YES.

*NO

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

Protection autre substitution (SECURE)

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

*NO

Ce fichier n'est pas protégé des substitutions précédentes. Ses valeurs peuvent être remplacées.

*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 qui devra recevoir un poste du système lorsqu'un événement donnée disponible est signalé par une unité écran invitée. Il n'est pas nécessaire que la file d'attente de données existe lorsque le fichier écran est créé car le nom indiqué à ce paramètre n'est évalué que lors de l'utilisation du fichier. Pour plus d'informations sur la fonction de file d'attente de données, reportez-vous au manuel Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Valeurs uniques

*NONE

Aucune file d'attente de données n'est indiqué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.

Le manuel Rubrique Base de données de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/ contient davantage d'informations sur les fichiers base de données partagés.

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

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

OVRDSPF   FILE(DISPLAY75)  WAITFILE(30)

Cette commande permet de substituer le temps d'attente du fichier indiqué dans la description du fichier unité DISPLAY75, dans le programme ou dans d'autres commandes OVRDSPF appelées. Le programme dans lequel s'exécute cette commande attend jusqu'à 30 secondes (si nécessaire) pour allouer les ressources de fichier requises au fichier DISPLAY75.

Messages d'erreur

Messages *ESCAPE

CPF1892

Fonction &1 non admise.