RCLOPT

Récupérer un volume optique

En bref

La commande RCLOPT (Récupérer un volume optique) permet de reconstruire les fichiers base de données de l'index optique et/ou les index des bibliothèques internes.

RCLOPT se lit RCL (Récupérer (libérer)) + OPT. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

RCLOPT MLB(…)

Paramètres

MLB Bibliothèque optique obligatoire
OPTION Option
VOL Identificateur de volume
DIR Reconstruire index répertoires

Astuce : dans une session 5250, tapez RCLOPT 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 RCLOPT (Récupérer un volume optique) permet de reconstruire les fichiers base de données de l'index optique et/ou les index des bibliothèques internes. Ces fichiers et index permettent de conserver les informations concernant le volume et les répertoires. Voici quelques unes des raisons pour lesquelles il peut être nécessaire de reconstruire les fichiers et index : après une migration de CICS vers RISC, après le déplacement ou le retrait manuel d'un support optique, après un incident matériel survenu au cours du déplacement d'un support, ou lorsqu'une base de données ou un index a été endommagé ou détruit. Cette commande nécessite l'utilisation exclusive de l'unité optique directement connectée.

Remarque :L'exécution de cette commande peut prendre beaucoup de temps, parfois plus de 24 heures. Le temps d'exécution dépend de divers facteurs, parmi lesquels : le nombre de bibliothèques optiques, le nombre de supports contenus dans chaque bibliothèque, la capacité de chaque support, le nombre de fichiers et répertoires contenus dans chaque support et les options indiquées dans la commande.

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

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
MLB	Bibliothèque optique	Nom, *ALL	Obligatoire, positionnel 1
OPTION	Option	SYNC, UPDATE, *RESET	Facultatif, positionnel 2
VOL	Identificateur de volume	Valeur caractère, *ALL	Facultatif
DIR	Reconstruire index répertoires	NO, YES	Facultatif

Bibliothèque optique (MLB)

Indique l'unité optique connectée directement, pour laquelle les index optiques sont reconstruits.

*ALL: Les index optiques de toutes les unités optiques connectées directement sont reconstruits.
nom-unité-optique: Indiquez le nom de l'unité optique connectée directement, pour laquelle les index optiques sont reconstruits.

Option (OPTION)

Indique le type de récupération qui est effectué.

*SYNC: L'index des volumes optiques est synchronisé avec l'index des unités internes. Si l'index des volumes optiques ne contient pas un volume particulier, les postes d'index de volumes et de répertoires sont créés pour ce volume. Cette option est généralement la plus rapide. Dans la majorité des cas, elle doit être lancée avant de lancer l'option *UPDATE ou *RESET.
*UPDATE: L'index des volumes optiques est reconstruit et l'index des répertoires optiques est reconstruit de façon facultative avec des informations lues à partir de la cartouche optique. Dans la plupart des cas, cette option est utilisée pour reconstruire les index d'un volume ou d'une cartouche optique unique.
*RESET: L'index des unités internes et l'index des volumes optiques sont reconstruits. La reconstruction de l'index des répertoires optiques avec des informations lues à partir de la cartouche optique est facultative. Pour que *RESET puisse être sélectionné, tous les volumes doivent être montés au moins une fois sur une unité. L'index des répertoires optiques est construit si le paramètre de reconstruction d'index de répertoires a pour valeur *YES. Pour que DIR(*YES) puisse être spécifié, tous les volumes doivent être montés une seconde fois. En général, *RESET doit être utilisé uniquement après une tentative avec *SYNC et/ou *UPDATE.

Identificateur de volume (VOL)

Indique les volumes qui sont utilisés au moment de la récupération, lorsque OPTION(*UPDATE) est spécifié.

*ALL: Tous les volumes de l'unité optique sont utilisés.
Identificateur-de-volume: Indiquez l'identificateur d'un volume particulier à utiliser lors de la récupération.

Reconstruire index répertoires (DIR)

Indique si l'index des répertoires optiques est reconstruit pour chaque volume traité au cours de l'exécution de la commande de récupération d'un volume optique. Ce paramètre s'applique uniquement aux options *UPDATE et *RESET. Lorsque *SYNC est spécifié, la variable DIR(*NO) doit être utilisée. De plus, cette option ne s'applique pas aux volumes dotés du type de format de support *UDF car les informations relatives aux index de répertoires ne sont pas maintenues pour les volumes *UDF. Lors du traitement de volumes *UDF, le paramètre DIR(*NO) est utilisé.

*NO: L'index des répertoires optiques n'est pas reconstruit pour chaque volume traité.
*YES: L'index des répertoires optiques est reconstruit pour chaque volume traité. Dans le cas des volumes non *UDF, cette option s'applique uniquement aux options *UPDATE et *RESET.
Remarque :En choisissant la valeur *NO, il se peut que l'exécution de la commande de récupération d'un volume optique soit plus rapide.

Exemples

RCLOPT   MLB(OPT01)  OPTION(*UPDATE)  VOL(VOL01)  DIR(*YES)

Cette commande recrée les index du volume optique et du répertoire optique pour le volume optique VOL01 dans la bibliothèque optique OPT01.

Messages d'erreur

*ESCAPE Messages

OPT0125: Commande &1 exécutée avec des erreurs. Pour plus d'informations, consultez l'historique du travail.
OPT1320: Volume optique &1 en cours d'utilisation.
OPT1325: Format de volume optique non reconnu.
OPT1330: Volume optique non trouvé ou inutilisable.
OPT1331: Volume optique &1 non trouvé.
OPT1346: Opération non admise pour un volume situé sur un lecteur de disque optique éloigné.
OPT1360: Répertoire de support endommagé sur le volume optique &1.
OPT1460: Le volume optique &1 ne se trouve pas dans un lecteur de disque optique.
OPT1530: &1 n'est pas un lecteur de disque optique correct.
OPT1555: Lecteur de disque optique &1 en cours d'utilisation.
OPT1605: Erreur de support ou d'unité.
OPT1640: Erreur lors de la lecture de fichiers ou de répertoires.
OPT1652: L'unité &1 n'est pas une bibliothèque optique.
OPT1790: Opération non admise ou incompatible avec une autre demande.
OPT1805: Erreur lors de l'accès au fichier d'index des volumes optiques.
OPT1810: Erreur lors de l'accès au fichier d'index des répertoires optiques.
OPT1815: Erreur de programme interne.
OPT1820: Une erreur interne s'est produite sur le lecteur de disque optique &1.
OPT1821: Une erreur s'est produite sur le lecteur de disque optique &1.
OPT1825: Index optiques incorrects pour le lecteur de disque optique &1.
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.
OPT1872: Dépassement de délai ou annulation suite à une demande sur un lecteur de disque optique.
OPT2040: Erreur lors de l'accès au fichier de contrôle de sauvegarde.
OPT2155: Echec de la commande RCLOPT pour le lecteur de disque optique &1.
OPT2165: Echec de la commande RCLOPT pour le volume &1.
OPT2187: Non concordance des index optiques, commande RCLOPT requise.
OPT2188: Fichiers d'index optiques endommagés.
OPT2190: Erreur lors du traitement de la commande RCLOPT pendant l'accès au volume &1.
OPT2191: Erreur lors de la lecture du répertoire du volume &1.
OPT2301: Objet système interne en cours d'utilisation.
OPT7740: Utilisateur non autorisé pour l'objet &2, bibliothèque &3, de type &4.