Aller au contenu

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

  • DEV Unité de médiathèque obligatoire
  • CTG ID cartouche obligatoire
  • CGY Catégorie
  • CHKVOL Vé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.