DSPOVR

La commande DSPOVR (Afficher les substitutions) permet d'afficher les substitutions de fichiers à n'importe quel niveau d'appel actif d'un travail. Peuvent être affichées toutes les substitutions de fichiers ou les substitutions d'un fichier donné.

Les substitutions de fichier peuvent être fusionnées avant d'être affichées. Une substitution fusionnée résulte de la combinaison de toutes les substitutions d'un fichier du niveau d'appel 1 au niveau d'appel spécifié. Elle est appliquée lors de l'ouverture du fichier au niveau d'appel spécifié.

Un niveau d'appel est associé à chaque poste de la liste d'appel. L'appel d'un programme ou d'une procédure entraîne l'ajout d'un autre poste dans la liste d'appel. Lorsqu'une procédure ou un programme est appelé via la commande TFRCTL (Transférer le contrôle à un programme), celui-ci prend la place d'un poste déjà existant dans la liste d'appel ; aucun nouveau numéro de niveau d'appel n'est créé.

Remarque :Il est également possible d'accéder à cette commande via l'option 15 de la commande WRKJOB (Gérer un travail).

Paramètres

Nom du fichier substitué (FILE)

Indique si l'affichage porte sur toutes les substitutions de fichiers ou uniquement sur les substitutions d'un fichier spécifique.

*ALL

Toutes les substitutions existant entre le niveau d'appel 1 et le niveau d'appel indiqué sont affichées.

*PRTF

La substitution de fichier *PRTF existant dans le niveau d'appel où est entrée cette commande est affichée.

nom

Indiquez le nom du fichier pour lequel sont affichées toutes les substitutions de fichiers comprises entre le niveau d'appel 1 et le niveau d'appel indiqué.

Fusionner les substitutions (MRGOVR)

Indique si les substitutions affichées sont fusionnées. Seuls les paramètres correspondant à ceux de la dernière substitution fusionnée permettent d'identifier la substitution effectuée pour le niveau d'appel spécifié.

*YES

Les substitutions de fichier affichées sont fusionnées.

*NO

Les substitutions de fichier affichées ne sont pas fusionnées.

Niveau d'appel (LVL)

Indique les niveaux d'appel des substitutions de fichiers affichées. Une correspondance biunivoque est établie entre les postes de liste d'appel affichés via la commande WRKJOB (Gérer un travail) et le niveau d'appel du poste concerné.

Dans la liste d'appel, le premier nom de programme ou de procédure correspond au niveau d'appel 1. Le second nom correspond au niveau d'appel 2 et ainsi de suite jusqu'au dernier programme (ou jusqu'à la dernière procédure) qui a le niveau d'appel le plus élevé du travail.

• Si une substitution fusionnée est affichée, elle réunit l'ensemble des substitutions du niveau 1 au niveau d'appel spécifié.
• Si *NO est spécifié au paramètre MRGOVR (Fusionner les substitutions) et que *ALL est indiqué au paramètre FILE (Fichier à substituer), toutes les substitutions de fichiers du niveau d'appel 1 au niveau d'appel spécifié sont affichées avec leur niveau d'appel.
• Si *NO est spécifié au paramètre MRGOVR (Fusionner les substitutions) et qu'une substitution est indiquée au paramètre FILE (Fichier à substituer), toutes les substitutions concernant ce fichier, du niveau d'appel 1 au niveau d'appel spécifié, sont affichées, ainsi que leur niveau d'appel.

*

Le niveau d'appel de la substitution affichée correspond à celui du programme qui a appelé le programme de traitement de la commande DSPOVR. Si cette commande est démarrée par l'intermédiaire de QCMDEXC, le niveau d'appel a la même valeur que celui du programme appelant QCMDEXC. Les substitutions dont le numéro d'appel est supérieur à 999 ne sont pas affichées.

*JOB

Seules les substitutions au niveau du travail pour lesquelles OVRSCOPE(*JOB) est indiqué sont affichées.

1 à 999

Indiquez les niveaux d'appel des substitutions de fichiers à afficher. Un niveau d'appel spécifique permet d'afficher les substitutions à des niveaux d'appel inférieurs au niveau en cours.

Groupe d'activation (ACTGRP)

Indique le niveau de substitutions à afficher pour un groupe d'activation. Si MRGOVR(*YES) est indiqué, les substitutions de niveau groupe d'activation sont traitées lorsque toutes les substitutions dont le niveau d'appel est supérieur ou égal à celui de la procédure la plus ancienne du groupe d'activation ont été traitées.

*

Les substitutions de niveau du groupe d'activation du demandeur sont affichées.

valeur-alphanumérique

Indiquez le nom du groupe d'activation indiquant les substitutions de niveaux de groupes d'activation.

Sortie (OUTPUT)

Indique si la sortie générée par la commande doit être affichée sur le poste de travail demandeur, ou imprimée avec la sortie spoule du travail.

*

La sortie demandée par un travail interactif s'affiche à l'écran. La sortie demandée par un travail par lots est imprimée avec la sortie spoule du travail.

*PRINT

Le résultat est placé dans un fichier spoule de la file d'attente en sortie du travail.

Exemples

Exemple 1 : affichage de substitutions fusionnées

DSPOVR   FILE(REPORTS)  MRGOVR(*YES)  LVL(3)  OUTPUT(*)

Cette commande permet d'afficher la substitution fusionnée pour le fichier REPORTS dans le niveau d'appel 3 avec une description de chaque mot clé et paramètre. Les substitutions applicables dans les niveaux d'appel 1, 2 et 3 sont utilisées pour former la substitution fusionnée.

Exemple 2 : affichage de substitutions de fichiers

DSPOVR   FILE(REPORTS)  MRGOVR(*NO)  LVL(2)  OUTPUT(*)

Cette commande permet d'afficher toutes les substitutions de fichiers pour le fichier REPORTS jusqu'au niveau d'appel 2. Elle génère un affichage qui présente le nom du fichier, le niveau d'appel pour lequel la substitution a été demandée, le type de substitution et les paramètres de substitution. Si aucune substitution de fichiers n'est trouvée pour le fichier jusqu'au niveau d'appel indiqué (inclus), le message d'arrêt programme CPF9842 est envoyé.

Messages d'erreur

Messages *ESCAPE

CPF180C

Fonction &1 non admise.

CPF1892

Fonction &1 non admise.

CPF9842

Substitutions non trouvées pour le fichier &1.

CPF9845

Erreur lors de l'ouverture du fichier &1.

CPF9846

Erreur lors du traitement du fichier &1 de &2.

CPF9847

Erreur lors de la fermeture du fichier &1 de bibliothèque &2.

CPF9850

Substitution non admise pour fichier imprimante &1.

CPF9851

Valeur de ligne fin de page trop faible pour fichier &1 dans &2.

CPF9852

Largeur de page insuffisante pour le fichier &1 de &2.