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
-
DEVUnité de médiathèque obligatoire -
CTGID cartouche -
CGYCatégorie -
OUTPUTSortie -
OUTFILEFichier recevant la sortie -
OUTMBROptions 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.
- 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.