ADDOPTCTG

Ajouter une cartouche optique

En bref

La commande ADDOPTCTG (Ajouter une cartouche optique) permet d'ajouter à une bibliothèque optique ou à une unité autonome une cartouche optique et les volumes de cette dernière.

ADDOPTCTG se lit ADD (Ajouter) + OPTCTG. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

ADDOPTCTG MLB(…)

Paramètres

MLB Lecteur de disque optique obligatoire
AUTL Liste d'autorisation
DIR Reconstruire index répertoires
MEDLOC Emplacement du support

Astuce : dans une session 5250, tapez ADDOPTCTG 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 ADDOPTCTG (Ajouter une cartouche optique) permet d'ajouter à une bibliothèque optique ou à une unité autonome une cartouche optique et les volumes de cette dernière. Une cartouche optique se compose d'une ou deux faces. Chaque face correspond à un volume optique.

Une valeur d'horodatage et de date de 12 caractères est attribuée par le système à un volume non initialisé ajouté à l'unité optique. Cette valeur permet d'identifier chaque volume jusqu'à ce que celui-ci soit initialisé. Vous pouvez conserver l'identificateur de volume qui est généré par le système ou en indiquer un nouveau lors de l'initialisation du volume.

Restriction : Pour utiliser cette commande, vous devez disposer du droit *USE. La commande est livrée avec le droit public *EXCLUDE.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
MLB	Lecteur de disque optique	Nom	Obligatoire, positionnel 1
AUTL	Liste d'autorisation	Nom, PRV, QOPTSEC, NONE	Facultatif, positionnel 2
DIR	Reconstruire index répertoires	NO, YES	Facultatif
MEDLOC	Emplacement du support	IOSTATION, MAGAZINE	Facultatif

Lecteur de disque optique (MLB)

Indique le nom de l'unité optique dans laquelle le support optique est ajouté.

Liste d'autorisation (AUTL)

Indique la liste d'autorisation permettant de vérifier les droits sur la cartouche optique et sur les volumes de cette dernière.

*PRV: La liste d'autorisation précédente est utilisée. Si celle-ci n'a pas été sauvegardée ou si elle n'existe pas, QOPTSEC est prise par défaut.
QOPTSEC: La liste d'autorisation par défaut QOPTSEC est utilisée pour les volumes optiques.
*NONE: Aucun contrôle d'autorisation d'accès n'est effectué pour les volumes optiques.
nom-liste-autorisation: Indiquez le nom de la liste d'autorisation utilisée.

Reconstruire index répertoires (DIR)

Indique si l'index des répertoires optiques est créé pour les volumes optiques en cours d'ajout. L'index des répertoires optiques est obligatoire pour pouvoir lancer les commandes WRKOPTDIR (Gérer les volumes optiques) et DSPOPT (Afficher un volume optique). Si l'index n'est pas créé à ce stade, il le sera ultérieurement lors du premier lancement de ces commandes.

*NO: L'index des répertoires optiques n'est pas créé pour les volumes optiques en cours d'ajout, mais ultérieurement si nécessaire. Avec cette option, vous pouvez obtenir pour la commande des performances supérieures à celles offertes par DIR(*YES).
*YES: L'index des répertoires optiques est immédiatement créé pour chaque volume.

Emplacement du support (MEDLOC)

Indique l'emplacement des volumes optiques à ajouter à une bibliothèque optique.

*IOSTATION: Ajoute une seule cartouche optique à une bibliothèque optique depuis le guichet d'entrée-sortie.
*MAGAZINE: Ajoute plusieurs cartouches optiques à une bibliothèque optique depuis le magasin de chargement en bloc.
Remarque :Toutes les bibliothèques optiques ne sont pas équipées d'un magasin de chargement en bloc.

Exemples

Exemple 1 : Définition d'une liste d'autorisation

ADDOPTCTG   MLB(OPTMLB01)  AUTL(MYAUTH)

Cette commande ajoute une cartouche optique et ses volumes au système de la bibliothèque optique OPT01. La cartouche optique est sécurisée par la liste d'autorisation MYAUTH.

Exemple 2 : Définition d'un emplacement de support pour *MAGAZINE

ADDOPTCTG   MLB(OPTMLB01)  AUTL(QOPTSEC) MEDLOC(*MAGAZINE)

Cette commande ajoute l'ensemble des cartouches et volumes optiques du magasin de chargement en bloc au système de la bibliothèque optique OPTMLB01. Tous les volumes ajoutés à la bibliothèque optique OPTMLB01 sont sécurisés par la liste d'autorisation QOPTSEC.

Messages d'erreur

*ESCAPE Messages

OPT1245: Erreur lors du traitement des répertoires du volume optique &1.
OPT1480: Echec de l'ajout de cartouche optique.
OPT1530: &1 n'est pas un lecteur de disque optique correct.
OPT1555: Lecteur de disque optique &1 en cours d'utilisation.
OPT1652: L'unité &1 n'est pas une bibliothèque optique.
OPT1671: Dispositif non installé sur le lecteur de disque optique &1.
OPT1672: Erreur d'accès au magasin de chargement en bloc du lecteur de disque optique &1.
OPT1675: Le magasin de chargement en bloc pour le lecteur de disque optique &1 est vide.
OPT1677: magasin de chargement en bloc pour le lecteur de disque optique &1 ouvert.
OPT1790: Opération non admise ou incompatible avec une autre demande.
OPT1815: Erreur de programme interne.
OPT1860: L'opération sur le lecteur de disque optique &1 n'a pas abouti.
OPT1861: Aucune description d'unité n'est configurée pour la ressource &1.
OPT1862: Aucune description d'unité active ne correspond à la ressource &1.
OPT1863: Les bibliothèques optiques doivent être récupérées.
OPT2040: Erreur lors de l'accès au fichier de contrôle de sauvegarde.
OPT2301: Objet système interne en cours d'utilisation.
OPT2410: Liste d'autorisation &1 non trouvée pour le volume &2.
OPT7740: Utilisateur non autorisé pour l'objet &2, bibliothèque &3, de type &4.