Aller au contenu

DSPTAPCTG

Afficher cartouches de bande

En bref

La commande DSPTAPCTG (Afficher les cartouches de bande) affiche les attributs des cartouches de bande.

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

Syntaxe minimale

DSPTAPCTG DEV(…)

Paramètres

  • DEV Unité de médiathèque obligatoire
  • CTG ID cartouche
  • CGY Catégorie
  • OUTPUT Sortie
  • OUTFILE Fichier recevant la sortie
  • OUTMBR Options pour membre de sortie

Astuce : dans une session 5250, tapez DSPTAPCTG 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 DSPTAPCTG (Afficher les cartouches de bande) affiche les attributs des cartouches de bande.

Paramètres

Mot-clé Description Valeurs possibles Remarques
DEV Unité de médiathèque Nom Obligatoire, positionnel 1
CTG ID cartouche Valeurs uniques: *ALL
Autres valeurs (jusqu'à 40 répétitions): Valeur caractère
Facultatif
CGY Catégorie Valeurs uniques: *SHARE400, *INSERT, *EJECT
Autres valeurs: Liste d'éléments
Facultatif
Élément 1: Nom de la catégorie Valeur caractère, *ALL, *NOSHARE, *IPL, *NL, *SYSGEN, *CNV
Élément 2: Système de la catégorie Valeur caractère, *CURRENT, *ALL
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

Unité de médiathèque (DEV)

Indique l'unité de bandothèque à utiliser. La description d'unité doit avoir été créée précédemment sur le système, à l'aide de la commande CRTDEVMLB.

Ce paramètre est obligatoire.

nom
Indiquez le nom de l'unité de bandothèque.

ID cartouche (CTG)

Indique de 1 à 40 identificateurs de cartouche à afficher.

Remarque :Si l'unité de bandothèque est équipée d'un lecteur de codes à barres lui permettant de lire les identificateurs externes, l'identificateur de cartouche doit être le même que l'identificateur externe.

Valeurs uniques

*ALL
Toutes les cartouches de bande de l'unité ou de la catégorie indiquée sont affichées.

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

identificateur-générique
Indiquez le nom générique de l'identificateur de cartouche. Un nom générique est une chaîne comprenant un ou plusieurs caractères suivis d'un astérisque (*), par exemple, ABC*. L'astérisque remplace des caractères valides quelconques. Un nom générique regroupe tous les identificateurs de cartouche dont le nom commence par le préfixe générique. Si le nom (préfixe) générique ne comporte pas d'astérisque, le système considère que ce nom est l'identificateur complet de la cartouche.
identificateur
Indiquez l'identificateur de cartouche.

Catégorie (CGY)

Indique la catégorie des cartouches de bande à afficher.

Valeurs uniques

*SHARE400
Les identificateurs de cartouche de la catégorie *SHARE400 sont affichés. Une cartouche de cette catégorie peut être partagée avec d'autres systèmes connectés à la même unité.
*INSERT
Les identificateurs de cartouche de la catégorie *INSERT sont affichés. Une cartouche de cette catégorie a été placée dans l'unité de bandothèque mais son identificateur n'a pas été ajouté dans le système.
*EJECT
Les identificateurs de cartouche de la catégorie *EJECT sont affichés. L'identificateur d'une cartouche de cette catégorie a été supprimé du système et celle-ci n'est plus utilisable.

Elément 1 : Nom de la catégorie

*ALL
La recherche des identificateurs de cartouche indiqués au paramètre CTG porte sur toutes les catégories, qui sont toutes affichées.
*NOSHARE
Les identificateurs de cartouche de la catégorie *NOSHARE sont affichés. Ces cartouches ne peuvent être partagées avec d'autres systèmes.
*IPL
Les identificateurs de cartouche de la catégorie *IPL sont affichés. Les cartouches qui possèdent cet identificateur peuvent être utilisées pour un IPL bande.
*NL
Les identificateurs de cartouche de la catégorie *NL sont affichés. Les cartouches qui possèdent cet identificateur sont utilisées comme des bandes sans label.
*SYSGEN
Les identificateurs de cartouche de la catégorie *SYSGEN sont affichés. Si l'unité de bandothèque est en mode *SYSGEN, les cartouches ne peuvent pas être retirées de la catégorie *SYSGEN.
*CNV
Les identificateurs de cartouche de la catégorie *CNV sont affichés. Lorsqu'une cartouche se trouve dans cette catégorie, elle doit être utilisée avec le guichet en libre-service.
valeur-alphanumérique
Indiquez le nom d'une catégorie définie par l'utilisateur. Ce nom doit avoir été créé auparavant à l'aide de la commande CRTTAPCGY (Créer une catégorie de bande).

Elément 2 : Système de la catégorie

Cet élément indique le système auquel la catégorie appartient. Le nom du système provient de la zone relative au nom du système en instance indiqué par la commande DSPNETA (Afficher les attributs du réseau). S'il n'existe aucun système en instance, l'attribut du nom du système en cours est utilisé.

***** Attention *****************************
Si le nom du système est modifié, les catégo-
ries associées à toutes les cartouches de bande
des unités de bandothèque ne sont pas valides.
*********************************************

*CURRENT
Système sur lequel s'exécute actuellement la commande.
*ALL
Tous les systèmes propriétaires de catégories disponibles sur le système qui exécute cette commande sont utilisés.
valeur-alphanumérique
Indiquez le nom du système auquel appartient la catégorie.

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 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 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 QSYS/QATAVOF.

Fichier recevant la sortie (OUTFILE)

Indique le nom qualifié du fichier base de données dans lequel les informations concernant les volumes de bande sont stockées. Si le fichier n'existe pas, cette commande en crée un dans la bandothèque spécifiée. Dans ce cas, le système utilise QATAVOF dans QSYS comme modèle avec le nom de format QTAVOLOF.

Remarque :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 cette valeur est indiquée 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.

Exemples

Exemple 1: affichage des cartouches de bande de la catégorie *SHARE400

DSPTAPCTG   DEV(LIB01)  CGY(*SHARE400)  OUTPUT(*)

Cette commande affiche les attributs de toutes les cartouches de bande de la catégorie *SHARE400 à l'écran du poste de travail.

Exemple 2: affichage de la cartouche de bande pour VOL3

DSPTAPCTG   DEV(LIB01)  CTG(VOL3)  OUTPUT(*)  CGY(*ALL)

Cette commande affiche les attributs de l'identificateur de cartouche VOL3.

Messages d'erreur

*ESCAPE Messages

CPF6708
Commande arrêtée par suite d'erreur.
CPF6711
Commande non admise
CPF6718
Impossible d'allouer l'unité &1.
CPF6745
&1 n'est pas une médiathèque.
CPF67A6
Catégorie inexistante
CPF67D2
La commande de cartouche a échoué.
CPF67D4
Catégorie non disponible
CPF67E4
Echec de la fonction d'unité de bandothèque
CPF67E6
Volume &2 incorrect
CPF67EA
Echec de la fonction
CPF67EC
Description d'unité de bandothèque &1 inexistante
CPF67ED
Unité de bandothèque &1 non disponible
CPF67F5
Nom de cartouche ou de volume virtuel en double trouvé.
CPF9814
Unité &1 non trouvée.
CPF9825
Accès non autorisé à l'unité &1.

© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.