RMVTAPCTG

Enlever une cartouche de bande

En bref

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

Syntaxe minimale

RMVTAPCTG DEV(…)

Paramètres

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

Astuce : dans une session 5250, tapez RMVTAPCTG 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 RMVTAPCTG (Enlever une cartouche de bande) supprime les identificateurs de cartouche indiqués de leur catégorie en cours ou de la catégorie indiquée, et les place dans la catégorie *EJECT. La catégorie *EJECT n'est pas valide pour les opérations d'E-S ; les cartouches de la catégorie *EJECT ne peuvent pas être utilisées dans l'unité de bande.

Restrictions :

Seul un utilisateur disposant du droit spécial de sauvegarde du système (*SAVSYS) peut utiliser cette commande.

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 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
STATION	Station	DEV, CNV, *HIGHCAP	Facultatif

Unité de médiathèque (DEV)

Indique l'unité de bandothèque à utiliser. Ce nom doit avoir été créé auparavant sur 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é de bandothèque.

ID cartouche (CTG)

Indique les identificateurs de cartouche à supprimer.

Remarques :

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.
Ce paramètre est incompatible avec le paramètre CGY.

Valeurs uniques

*ALL: Toutes les cartouches sont supprimé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 à supprimer.

Catégorie (CGY)

Indique la catégorie dont les cartouches doivent être supprimées.

Remarque :Les paramètres CGY et CTG sont incompatibles.

Valeurs uniques

*SHARE400: Les identificateurs de cartouche affectés à la catégorie *SHARE400 sont supprimés. Une cartouche de cette catégorie peut être partagée avec d'autres systèmes connectés à la même unité.
*INSERT: Tous les identificateurs de cartouche affectés à la catégorie *INSERT sont supprimé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.

Elément 1 : Nom de la catégorie

*NOSHARE: Tous les identificateurs de cartouche affectés à la catégorie *NOSHARE sont supprimés. Ces cartouches ne peuvent être partagées avec d'autres systèmes.
*IPL: Tous les identificateurs de cartouche affectés à la catégorie *IPL sont supprimés. Les cartouches qui possèdent cet identificateur peuvent être utilisées pour un IPL bande.
*NL: Tous les identificateurs de cartouche affectés à la catégorie *NL sont supprimés. Les cartouches qui possèdent cet identificateur sont utilisées comme des bandes sans label.
*CNV: Tous les identificateurs de cartouche de la catégorie *CNV sont supprimés. Une cartouche de cette catégorie est automatiquement supprimée par le système si elle a été chargée et si un déchargement a été demandé par l'utilisateur.
valeur-alphanumérique: Indiquez le nom d'une catégorie définie par l'utilisateur. Les identificateurs de cartouche affectés à cette catégorie sont supprimés.

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

Station (STATION)

Indique la station qui reçoit les cartouches éjectées.

*DEV: Si la bandothèque dispose d'un guichet d'E-S en libre service, les cartouches sont placées dans ce guichet. Si la bandothèque ne dispose pas d'un guichet d'E-S en libre service, les cartouches sont placées dans le guichet de sortie à haute capacité. Si la bandothèque ne dispose pas d'un guichet de sortie à haute capacité, les cartouches sont placées dans un emplacement de stockage de la bibliothèque. Il est nécessaire d'ouvrir la porte de la bibliothèque pour retirer physiquement les cartouches du guichet de sortie à haute capacité ou d'un emplacement de stockage de la bibliothèque.
*CNV: La cartouche est éjectée dans le guichet d'E-S en libre service. Ce guichet permet l'introduction et le retrait des cartouches sans ouvrir la porte de la bandothèque. Si la bandothèque ne dispose pas d'un guichet d'E-S en libre service, les cartouches sont placées dans le guichet de sortie à haute capacité. Si la bandothèque ne dispose pas d'un guichet de sortie à haute capacité, les cartouches sont placées dans un emplacement de stockage de la bibliothèque. Il est nécessaire d'ouvrir la porte de la bibliothèque pour retirer physiquement les cartouches du guichet de sortie à haute capacité ou d'un emplacement de stockage de la bibliothèque.
*HIGHCAP: Les cartouches sont éjectées dans la sortie grande capacité de l'unité de bibliothèque. Si la bandothèque ne dispose pas d'un guichet de sortie à haute capacité, les cartouches sont placées dans le guichet d'E-S en libre service. Si la bandothèque ne dispose pas d'un guichet d'E-S en libre service, les cartouches sont placées dans un emplacement de stockage de la bibliothèque. Il est nécessaire d'ouvrir la porte de la bibliothèque pour retirer physiquement les cartouches du guichet de sortie à haute capacité ou d'un emplacement de stockage de la bibliothèque.

Exemples

Exemple 1: suppression d'une cartouche unique du guichet *HIGHCAP

RMVTAPCTG   DEV(LIB01)  CTG(VOL4)  STATION(*HIGHCAP)

Cette commande supprime l'identificateur de cartouche VOL4 de sa catégorie courante et le place dans la catégorie *EJECT. La cartouche est placée dans le guichet de sortie à haute capacité. Si aucune station de sortie à haute capacité n'a été définie, la cartouche sera placée dans un guichet d'E/S en libre service. Si aucune E/S en libre service n'est prise en charge, la cartouche reste dans un logement de stockage.

Exemple 2: Suppression de toutes les cartouches de la catégorie *IPL

RMVTAPCTG   DEV(LIB01)  CGY(*IPL)  STATION(*CNV)

Cette commande supprime tous les identificateurs de cartouche de la catégorie *IPL et les place dans la catégorie *EJECT. Les cartouches sont placées dans un guichet d'entrée/sortie en libre service.

Messages d'erreur

*ESCAPE Messages

CPF222E: Le droit spécial &1 est requis.
CPF67AF: &6 cartouches non enlevées
CPF6745: &1 n'est pas une médiathèque.