CHGTAPCTG

Modifier cartouche de bande

En bref

La commande CHGTAPCTG (Modifier une cartouche de bande) fait passer la cartouche indiquée d'une catégorie dans une autre.

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

Syntaxe minimale

CHGTAPCTG DEV(…)

Paramètres

DEV Unité de médiathèque obligatoire
CTG ID cartouche
CGY Catégorie

Astuce : dans une session 5250, tapez CHGTAPCTG 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 CHGTAPCTG (Modifier une cartouche de bande) fait passer la cartouche indiquée d'une catégorie dans une autre.

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, *ALL	Facultatif
CGY	Catégorie	Valeurs uniques: SHARE400 Autres valeurs: Liste d'éléments*	Facultatif
	Élément 1: Nom de la catégorie	Valeur caractère, SAME, NOSHARE, IPL, NL, *CNV
	Élément 2: Système de la catégorie	Valeur caractère, SAME, CURRENT

Unité de médiathèque (DEV)

Indique l'unité à utiliser. Ce nom doit avoir été créé au préalable dans le système à l'aide de la commande CRTDEVMLB (Créer une unité de bandothèque).

Ce paramètre est obligatoire.

nom: Indiquez le nom de l'unité.

ID cartouche (CTG)

Indique les identificateurs de cartouche qui doivent passer de leurs catégories respectives à la catégorie indiquée.

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.

*ALL: Toutes les cartouches de bande de l'unité sont changées.
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 de 1 à 40 identificateurs de cartouche devant changer de catégorie.

Catégorie (CGY)

Indique la nouvelle catégorie de la cartouche de bande. Cette commande ne permet pas de modifier la catégorie *NOSHARE, sauf si elle est exécutée à partir d'un système qui dispose des droits de *NOSHARE.

Valeurs uniques

*SHARE400: Les identificateurs de cartouche indiqués passent dans la catégorie *SHARE400.

Elément 1 : Nom de la catégorie

*SAME: Les catégories ne sont pas modifiées.
*NOSHARE: Les identificateurs de cartouche indiqués passent dans la catégorie *NOSHARE.
*IPL: Les identificateurs de cartouche indiqués passent dans la catégorie *IPL.
*NL: Les identificateurs de cartouche indiqués passent dans la catégorie *NL.
valeur-alphanumérique: Indiquez le nom d'une catégorie définie par l'utilisateur. Les identificateurs de cartouche indiqués passent dans cette catégorie.

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

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.
*********************************************

*SAME: Le système ne change pas.
*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.

Exemples

CHGTAPCTG   DEV(LIB01)  CTG(VOL1)  CGY(*SHARE400)

Cette commande change la catégorie associée à l'identificateur de cartouche VOL1 à la catégorie *SHARE400.

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
CPF67EA: Echec de la fonction
CPF67F5: Nom de cartouche ou de volume virtuel en double trouvé.
CPF67F9: &6 cartouches non modifiées
CPF9814: Unité &1 non trouvée.
CPF9825: Accès non autorisé à l'unité &1.