DSPTAP

Afficher contenu d'une bande

En bref

La commande DSPTAP permet d'afficher les informations (label du volume, labels de fichiers) d'une bande magnétique avec label ou bien le type et la densité du volume.

DSPTAP se lit DSP (Afficher) + TAP. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

DSPTAP DEV(…)

Paramètres

DEV Unité obligatoire
VOL Identificateur de volume
LABEL Label du fichier
SEQNBR Numéro de séquence
DATA Type de données
OUTPUT Sortie
ENDOPT Option fin de bande
OUTFILE Fichier recevant la sortie
OUTMBR Options pour membre de sortie

Astuce : dans une session 5250, tapez DSPTAP puis F4 pour l'invite de saisie, et F1 sur un paramètre pour son aide.

Aide IBM i de la commande

Texte du F1, IBM i 7.5 en français (bibliothèque QSYS)

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Non

La commande DSPTAP permet d'afficher les informations (label du volume, labels de fichiers) d'une bande magnétique avec label ou bien le type et la densité du volume. Les informations peuvent être soit imprimées soit affichées à l'écran. Des informations complémentaires, y compris la description de chaque objet sauvegardé dans le fichier bande et des informations récapitulatives sur les objets sauvegardés peuvent être affichées en indiquant *SAVRST à l'invite Type de données (paramètre DATA).

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
DEV	Unité	Nom	Obligatoire, positionnel 1
VOL	Identificateur de volume	Valeur caractère, *MOUNTED	Facultatif
LABEL	Label du fichier	Valeur caractère, *ALL	Facultatif
SEQNBR	Numéro de séquence	Valeurs uniques: ALL Autres valeurs: Liste d'éléments*	Facultatif
	Élément 1: Début au no séquence fichier	1-16777215, *FIRST
	Élément 2: Fin au no séquence fichier	1-16777215, ONLY, LAST
DATA	Type de données	LABELS, SAVRST	Facultatif
OUTPUT	Sortie	, PRINT, *OUTFILE	Facultatif
ENDOPT	Option fin de bande	REWIND, UNLOAD	Facultatif
OUTFILE	Fichier recevant la sortie	Nom d'objet qualifié	Facultatif
	Qualificatif 1: Fichier recevant la sortie	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
OUTMBR	Options pour membre de sortie	Liste d'éléments	Facultatif
	Élément 1: Membre recevant la sortie	Nom, *FIRST
	Élément 2: Remplacement ou ajout enregs	REPLACE, ADD

Unité (DEV)

Indique le nom de l'unité de bande ou de médiathèque sur laquelle se trouve le volume à afficher.

Ce paramètre est obligatoire.

Identificateur de volume (VOL)

Indique le volume de bande à afficher.

Remarque :Si l'unité spécifiée est une unité de bandothèque ou une unité de bande virtuelle, le volume indiqué doit être l'identificateur de cartouche ou le nom de volume virtuel à monter et à utiliser.

*MOUNTED: Le volume présent sur l'unité est utilisé. Dans le cas d'une unité de médiathèque, le volume à utiliser correspond à la cartouche suivante de la catégorie montée à l'aide de la commande SETTAPCGY (Définir une catégorie de bande). Dans le cas d'une unité de bande virtuelle, le volume à utiliser correspond à celui qui est monté ou, en l'absence de volume monté, au volume suivant dont l'état est Chargé dans le catalogue d'images de CD-ROM.
valeur-caractère: Indiquez l'identificateur du volume avec label. Cette valeur est comparée à l'identificateur de volume figurant sur la bande. Si le système ne trouve pas sur la bande l'identificateur de volume indiqué, il envoie un message d'arrêt programme.

Label du fichier (LABEL)

Indique si l'affichage concerne tous les identificateurs de fichiers de la bande dont les labels sont affichés. L'identificateur de fichier est stocké dans le label avant les données du fichier.

*ALL: La totalité des identificateurs de fichiers de la bande indiquée en regard de l'invite Unité bande (paramètre DEV) est affichée.
valeur-caractère: Indiquez l'identificateur du fichier (17 caractères maximum) concerné par les informations de label à afficher.

Numéro de séquence (SEQNBR)

Indique, pour les volumes avec plusieurs fichiers, la plage des numéros de séquence des fichiers dont les informations de label sont affichées. Si *ALL est indiqué en regard de l'invite Label du fichier (paramètre LABEL), tous les labels pour les fichiers contenus dans la plage de numéros de séquence indiquée sont affichés après le numéro de séquence de début indiqué.

Si vous avez précisé un identificateur LABEL spécifique, celui-ci est comparé à l'identificateur de label du fichier de données indiqué par le numéro de séquence de début. Si les identificateurs ne concordent pas, le système envoie un message d'erreur.

Valeurs uniques

*ALL: Tous les labels des fichiers figurant sur la bande sont affichés.

Elément 1 : Début au no séquence fichier

*FIRST: Les labels de fichier de données affichés commencent par le premier ou le seul fichier figurant sur la bande.
1 à 16777215: Indiquez le numéro de séquence de fichier de début. Si le système ne trouve pas le numéro de séquence de fichier de début sur la bande, il envoie un message d'erreur.

Elément 2 : Fin au no séquence fichier

*LAST

La plage des labels de fichier de données affichée commence par le numéro de séquence de fichier de début et se termine par le dernier label de fichier de données sur la bande.

*ONLY

Seul le fichier indiqué à la séquence de début est affiché.

1 à 16777215

Indiquez le numéro de séquence de fichier d'arrêt. Le numéro de séquence de fichier d'arrêt doit être supérieur ou égal au numéro de séquence de fichier de début.

Remarque :Le numéro de séquence de fichier d'arrêt est ignoré pour OUTPUT(*) pour un travail interactif. L'utilisateur peut contrôler et continuer à afficher les informations ou arrêter dès qu'il le souhaite.

Remarque :Le numéro de séquence de fichier d'arrêt est ignoré si un identificateur LABEL spécifique est indiqué.

Type de données (DATA)

Indique le type d'information à afficher.

*LABELS: Les labels du volume et des fichiers sont affichés.
*SAVRST: Un récapitulatif sur la commande et sur chacun des objets sauvegardés est affiché.

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 est affichée (s'il s'agit d'un travail interactif) ou imprimée avec la sortie spoule du travail (s'il s'agit d'un travail par lots).

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

*OUTFILE: La sortie est dirigée vers le fichier base de données indiqué au paramètre OUTFILE.

Option fin de bande (ENDOPT)

Indique l'opération qui doit automatiquement faire suite à une opération donnée sur le volume de bande. Si plusieurs volumes sont impliqués, ce paramètre ne s'applique qu'au dernier volume utilisé, les volumes précédents étant tous rembobinés et déchargés en fin de bande.

*REWIND: A la fin de l'opération, la bande est rebobinée automatiquement, mais elle n'est pas déchargée.
*UNLOAD: La bande est automatiquement rembobinée et déchargée à la fin de l'opération.

Fichier recevant la sortie (OUTFILE)

Indique le nom qualifié du fichier base de données vers lequel sont dirigées les informations concernant les fichiers bande. Si le fichier n'existe pas, cette commande en crée un dans la bandothèque spécifiée. Si un nouveau fichier est créé, le système utilise QATADOF de QSYS, comme modèle avec le format QTADOUTF.

Remarque :Ce paramètre n'est admis que lorsque OUTPUT(*OUTFILE) et DATA(*LABELS) sont spécifiés.

Qualificatif 1 : Fichier recevant la sortie

nom: Indiquez le nom du fichier base 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 recherche s'effectue dans la bibliothèque en cours du travail. Si celle-ci n'est pas précisée, QGPL est prise par défaut.
nom: Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche.

Options pour membre de sortie (OUTMBR)

Indique le nom du membre de fichier base de données vers lequel est dirigée la sortie lorsque OUTPUT(*OUTFILE) est précisé.

Elément 1 : Membre recevant la sortie

*FIRST: Le premier membre du fichier reçoit la sortie. Si OUTMBR(*FIRST) est indiqué et que le membre n'existe pas, le système en crée un et lui attribue le nom du fichier indiqué au paramètre OUTFILE.
nom: Indiquez le nom du membre de fichier qui doit recevoir la sortie. Si un nom de membre est indiqué alors que le membre n'existe pas, le système le crée.

Elément 2 : Remplacement ou ajout enregs

*REPLACE: Les enregistrements existant dans le membre de fichier base de données indiqué sont remplacés par les nouveaux enregistrements.
*ADD: Le système ajoute les nouveaux enregistrements à la fin du membre existant.

Exemples

DSPTAP   DEV(QTAPE2)  LABEL(*ALL)

Cette commande affiche le label de volume et les labels de fichier du volume de bande se trouvant sur l'unité de bande nommée QTAPE2.

Messages d'erreur

Messages *ESCAPE

CPD375A: Erreur sur le support de sauvegarde.
CPF3704: Demande terminée. Erreur du gestionnaire des données.
CPF3743: Restauration, affichage ou listage du fichier impossible.
CPF3792: Informations non affichées. Une erreur s'est produite.
CPF3793: Limite mémoire atteinte sur la machine ou dans l'ASP.
CPF6708: Commande arrêtée par suite d'erreur.
CPF6718: Impossible d'allouer l'unité &1.
CPF6721: &1 n'est pas une unité de bande.
CPF6723: Fichier non trouvé sur volume &2 de l'unité &1.
CPF6724: Label fichier &5 non trouvé sur volume &2.
CPF6745: &1 n'est pas une médiathèque.
CPF6751: Incident de chargement sur unité &4.
CPF6760: L'unité &1 n'est pas prête.
CPF6772: Le volume chargé sur l'unité &1 ne peut pas être traité.
CPF9814: Unité &1 non trouvée.
CPF9825: Accès non autorisé à l'unité &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.