ADDTAPCTG
Ajouter une cartouche de bande
En bref
La commande ADDTAPCTG (Ajouter une cartouche de bande) ajoute dans une catégorie utilisable les identificateurs de cartouche indiqués.
ADDTAPCTG se lit ADD
(Ajouter) + TAPCTG.
Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.
Syntaxe minimale
ADDTAPCTG DEV(…) CTG(…)
Paramètres
-
DEVUnité de médiathèque obligatoire -
CTGID cartouche obligatoire -
CGYCatégorie -
CHKVOLVérifier l'ID volume
Astuce : dans une session 5250, tapez ADDTAPCTG 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 ADDTAPCTG (Ajouter une cartouche de bande) ajoute dans une catégorie utilisable les identificateurs de cartouche indiqués. Lorsque vous les rangez dans une unité de bandothèque, les cartouches sont placées dans la catégorie d'insertion. Elles doivent ensuite être transférées dans une catégorie utilisable pour pouvoir être lues par une unité de bande.
Dans une unité de bandothèque, chaque identificateur de cartouche doit être unique. En cas de duplicatas, les deux cartouches concernées sont inutilisables tant que l'une des deux n'a pas été physiquement retirée de l'unité de bandothèque.
Paramètres
| Mot-clé | Description | Valeurs possibles | Remarques |
|---|---|---|---|
| DEV | Unité de médiathèque | Nom | Obligatoire, positionnel 1 |
| CTG | ID cartouche | Values (jusqu'à 40 répétitions): Valeur caractère | Obligatoire, positionnel 2 |
| CGY | Catégorie | Valeurs uniques: *SHARE400 Autres valeurs: Liste d'éléments |
Facultatif |
| Élément 1: Nom de la catégorie | Valeur caractère, *NOSHARE, *IPL, *NL, *CNV | ||
| Élément 2: Système de la catégorie | Valeur caractère, *CURRENT | ||
| CHKVOL | Vérifier l'ID volume | *YES, *NO | Facultatif |
Unité de médiathèque (DEV)
Indique l'unité de bandothèque à utiliser. Ce nom d'unité doit avoir été créé précédemment sur le système, à l'aide de la commande CRTDEVMLB (Créer une unité de médiathèque).
Ce paramètre est obligatoire.
- nom
- Indiquez le nom de l'unité de bandothèque.
ID cartouche (CTG)
Indique les identificateurs des cartouches (40 au maximum) se trouvant dans la catégorie d'insertion et devant être ajoutées à la catégorie indiquée.
Ce paramètre est obligatoire.
- valeur-alphanumérique
- Indiquez l'identificateur de cartouche à ajouter. Un ID de cartouche peut comporter jusqu'à 6 caractères.
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.
Catégorie (CGY)
Indique la catégorie à laquelle est ajoutée la cartouche de bande. La cartouche est transférée dans un logement de la bandothèque, à moins qu'elle ne soit ajoutée à la catégorie libre-service (CNV).
Valeurs uniques
- *SHARE400
- L'identificateur de cartouche indiqué peut être partagé avec d'autres systèmes connectés à la même unité.
Elément 1 : Nom de la catégorie
- *NOSHARE
- L'identificateur de cartouche indiqué ne peut pas être partagé avec d'autres systèmes connectés à la même unité.
- *IPL
- L'identificateur de cartouche indiqué peut être utilisé pour un IPL bande. La gestion des cartouches appartenant à cette catégorie doit être effectuée par l'utilisateur.
****Attention************************************* Si vous utilisez la catégorie *IPL pour un IPL bande, vérifiez que les cartouches peuvent être utilisées. Des conflits peuvent se produire si des systèmes haut de gamme et bas de gamme sont connectés simultanément à la même unité de bandothèque. **************************************************
- *NL
- La cartouche est utilisée comme bande sans label.
- *CNV
- La cartouche est ajoutée à la catégorie spéciale libre-service. Elle n'est pas transférée dans un logement de la bandothèque. Lorsque la cartouche est déchargée d'une unité, elle est transférée (exportée) vers 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égories associées à toutes les cartouches de bande des unités de bandothèque ne sont pas valides. *************************************************
- *CURRENT
- La catégorie appartient au système sur lequel s'exécute actuellement la commande.
- valeur-alphanumérique
- Indiquez le nom du système auquel appartient la catégorie.
Vérifier l'ID volume (CHKVOL)
Indique si l'identificateur de volume logique doit être identique à l'identificateur externe si l'unité de bandothèque dispose d'un lecteur de codes à barres pour lire l'identificateur.
- *YES
- Le système vérifie que la cartouche de bande possède un identificateur de volume logique correct, en lisant le label de volume existant sur cette cartouche.
- *NO
- La cartouche de bande n'est pas vérifiée. Si une cartouche est ajoutée et que l'identificateur externe ne correspond pas à l'identificateur de volume logique, la cartouche est utilisable en lecture seulement. Les opérations de sortie sur la cartouche de bande ne sont admises que si l'identificateur de volume logique est initialisé pour correspondre à l'identificateur externe. Si la bande n'a pas de label, cette correspondance n'a pas lieu, dans la mesure où il n'y a pas d'identificateur de volume logique.
Exemples
Exemple 1: ajout d'une cartouche unique à la catégorie *SHARE400
ADDTAPCTG DEV(LIB01) CTG(VOL4) CGY(*SHARE400) CHKVOL(*NO)
Cette commande ajoute l'identificateur de cartouche VOL4 à la catégorie utilisable *SHARE400. L'identificateur de volume logique des labels de volume de VOL4 n'est pas vérifié.
Exemple 2: ajout de plusieurs cartouches à la catégorie *NOSHARE
ADDTAPCTG DEV(LIB01) CTG(VOL1 VOL2 VOL3)
CGY(*NOSHARE) CHKVOL(*YES)
Cette commande ajoute les identificateurs de cartouche VOL1, VOL2 et VOL3 à la catégorie utilisable *NOSHARE. Les identificateurs de volume logique des cartouches sont vérifiés lorsque la commande est exécutée.
Messages d'erreur
*ESCAPE Messages
- CPF67AB
- &6 cartouches non ajoutées
- CPF67A6
- Catégorie inexistante
- CPF67D2
- La commande de cartouche a échoué.
- CPF67E4
- Echec de la fonction d'unité de bandothèque
- CPF67EA
- Echec de la fonction
- CPD67EB
- Cartouche &2 non incluse dans la catégorie *INSERT
- 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é.
- CPF6708
- Commande arrêtée par suite d'erreur.
- CPF6718
- Impossible d'allouer l'unité &1.
- CPF6745
- &1 n'est pas une médiathèque.
- 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.