DSPTAPSTS

Afficher l'état des bandes

En bref

La commande DSPTAPSTS (Afficher l'état des bandes) permet d'effectuer les opérations suivantes :

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

Syntaxe minimale

DSPTAPSTS

Paramètres

DEV Unité de médiathèque
OUTPUT Sortie
OUTFILE Fichier recevant la sortie
OUTMBR Options pour membre de sortie
OUTFILFMT Format du fichier de sortie

Astuce : dans une session 5250, tapez DSPTAPSTS 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 DSPTAPSTS (Afficher l'état des bandes) permet d'effectuer les opérations suivantes :

Affiche les informations d'emplacement associées à l'unité de médiathèque.
Affiche les informations sur les ressources associées à l'unité de médiathèque.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
DEV	Unité de médiathèque	Nom, *ALL	Facultatif, positionnel 1
OUTPUT	Sortie	, PRINT, *OUTFILE	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
OUTFILFMT	Format du fichier de sortie	TYPE1, TYPE2	Facultatif

Unité de médiathèque (DEV)

Indique le nom de l'unité de médiathèque pour laquelle les informations sont affichées.

*ALL: Indique que toutes les unités de médiathèque définies à l'aide de la commande CRTDEVMLB (Créer une unité de médiathèque) sont affichées.
nom: Indiquez le nom de l'unité. Ce nom doit être celui d'une unité de médiathèque ou d'une unité RACL (chargeur de cartouches d'accès sélectif). Le nom d'unité doit avoir déjà été créé sur le système à l'aide de la commande CRTDEVMLB (Créer une unité de bandothèque).

Sortie (OUTPUT)

Indique si le résultat de la commande s'affiche sur le poste de travail demandeur, s'imprime dans un fichier de sortie ou s'imprime avec la sortie spoule du travail.

*: La sortie s'affiche à l'écran. Si cette valeur est indiquée pour un travail par lots, le résultat est identique à celui obtenu avec *PRINT.
*PRINT: La sortie est imprimée dans un fichier spoule, qui se trouve dans la file d'attente en sortie du travail.
*OUTFILE: La sortie est dirigée dans le fichier base de données indiqué au paramètre OUTFILE. Ce fichier doit avoir le même format que le fichier base de données QATAIOF ou QATAIOF2.

Fichier recevant la sortie (OUTFILE)

Indique le fichier base de données vers lequel les informations concernant les bandothèques sont dirigées. Si le fichier base de données n'existe pas, cette commande en crée un dans la bibliothèque indiquée. Si un nouveau fichier est créé avec OUTFILFMT(*TYPE1), le système utilise QATAIOF de QSYS, comme modèle avec le format QTAIOUTF. Si un nouveau fichier est créé avec OUTFILFMT(*TYPE2), le système utilise QATAIOF2 de QSYS, comme modèle avec le format QTAIOF2. Ce paramètre n'est correct que si OUTPUT(*OUTFILE) est indiqué.

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 porte sur la bibliothèque en cours du travail. Si celle-ci n'est pas précisée, QGPL est utilisée par défaut.
nom: Indiquez le nom de la bibliothèque dans laquelle doit s'effectuer 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 crée un membre portant 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.

Options pour membre de sortie (OUTFILFMT)

Indique le format du fichier de sortie lorsque OUTPUT(*OUTFILE) est indiqué.

*TYPE1: Le format est défini par le fichier de sortie modèle QATAIOF de QSYS avec le nom de format d'enregistrement QTAIOUTF.
*TYPE2: Le format est défini par le fichier de sortie modèle QATAIOF2 de QSYS avec le nom de format d'enregistrement QTAIOF2.

Exemples

DSPTAPSTS   DEV(LIB01)  OUTPUT(*)

Cette commande affiche les informations valides concernant cette unité de bibliothèque à l'écran du poste de travail.

Messages d'erreur

*ESCAPE Messages

CPF6718: Impossible d'allouer l'unité &1.
CPF6745: &1 n'est pas une médiathèque.
CPF67E4: Echec de la fonction d'unité de bandothèque
CPF67E7: Aucune unité de bandothèque existante
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.
CPF9860: Erreur lors du traitement du fichier de sortie.
CPF9871: Erreur lors du traitement.