DLTOVR

La commande DLTOVR permet de supprimer une ou plusieurs substitutions de fichiers (y compris les substitutions de fichiers de messages) précédemment indiquées dans un niveau d'appel. Pour chacun des fichiers indiqués dans la commande DLTOVR, la substitution spécifiée au même niveau d'appel que celui de la commande est supprimée. Lorsque la commande est spécifiée de manière interactive ou à l'extérieur d'un programme dans un travail par lots, les substitutions de fichiers du niveau d'appel sont supprimées. Lorsque la commande est utilisée dans un programme CL, les substitutions de fichiers pour le niveau d'appel de ce programme sont supprimées. Une substitution de fichier résulte d'une commande de substitution de fichier.

La commande DLTOVR permet de supprimer toutes les substitutions de tous les fichiers du même niveau d'appel ou les substitutions de certains de ces fichiers. Seules sont supprimées les substitutions du niveau d'appel dans lequel la commande est spécifiée. Si, par exemple, une commande de substitution est spécifiée dans un programme d'une phase d'activation, et si un autre programme contenant également des commandes de substitution est appelé, une commande DLTOVR spécifiée dans le second programme pourra supprimer uniquement les substitutions de ce programme. La commande DLTOVR n'a aucun effet sur la commande de substitution indiquée avant l'appel du programme. Les substitutions supprimées n'ont pas d'effet sur les utilisations ultérieures du fichier.

Restrictions :

• Dans un travail à unités d'exécution multiples, cette commande ne peut être émise qu'à partir de l'unité d'exécution initiale.

Paramètres

Nom de fichier substitué (FILE)

Indique les noms des fichiers substitués dans le niveau d'appel, dont les substitutions de fichiers doivent être supprimées.

Valeurs uniques

*ALL

Toutes les substitutions de fichiers du niveau d'appel sont supprimées.

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

*PRTF

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

nom

Indiquez le nom du ou des fichiers dont les substitutions doivent être supprimées dans le niveau d'appel.

Niveau d'appel (LVL)

Indique le niveau d'appel des substitutions de fichiers supprimées. Une correspondance biunivoque est établie entre les postes de liste d'appel affichés par 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.

*ACTGRPDFN

Le niveau d'appel des substitutions de fichiers à supprimer est défini par le groupe d'activation du programme qui appelle cette commande. S'il s'agit du groupe d'activation par défaut, le niveau d'appel des substitutions à supprimer correspond à celui du programme qui appelle. Dans le cas contraire, le niveau d'appel des substitutions à supprimer correspond au groupe d'activation du programme appelant.

*

Le niveau d'appel des substitutions de fichiers à supprimer correspond à celui du programme qui a appelé le programme de traitement de la commande DLTOVR. Si cette commande est appelée via QCMDEXC, le niveau d'appel a la même valeur que celui du programme appelant de QCMDEXC.

*JOB

Les substitutions de fichiers dont la portée est le travail sont supprimées. En d'autres termes, seules les substitutions au niveau du travail pour lesquelles OVRSCOPE(*JOB) est indiqué sont supprimées.

Exemples

Exemple 1 : suppression de substitutions d'un niveau d'appel

1. OVRDBF FILE(A) TOFILE(B)
2. OVRPRTF FILE(C) TOFILE(D)
3. OVRTAPF FILE(E) TOFILE(F)

   :

4. DLTOVR FILE(A C)
5. DLTOVR FILE(*ALL)

Si les trois premières commandes de substitution ont été indiquées précédemment dans le niveau d'appel, les fichiers B, D et F remplacent les fichiers A, C et E. La quatrième commande supprime uniquement les substitutions de fichiers qui concernent les fichiers A et C. La dernière commande supprime toutes les substitutions de fichiers existantes dans le niveau d'appel, ce qui correspond dans ce cas à la commande remplaçant le fichier E (troisième commande).

Messages d'erreur

Messages *ESCAPE

CPF180C

Fonction &1 non admise.

CPF9841

Substitution non trouvée au niveau indiqué.