RSTCFG

La commande RSTCFG permet de restaurer sur le système un objet de configuration préalablement sauvegardé à l'aide de la commande SAVSYS (Sauvegarder le système) ou SAVCFG (Sauvegarder la configuration). La liste des types d'objets pouvant être restaurés à l'aide de cette commande figure dans le paramètre OBJTYPE (Types d'objets). Le profil utilisateur QDFTOWN devient le propriétaire par défaut des objets restaurés sur le système et dont le propriétaire est inconnu du système. Si un objet est restauré dans une bibliothèque alors qu'il y figure déjà, les droits publics et privés de cet objet sont conservés. S'il ne figure pas dans la bibliothèque de restauration, l'objet conserve tous ses droits publics mais les droits privés doivent être à nouveau définis.

Remarque :Cette commande ignore toutes les substitutions de fichier en cours pour ce travail, à l'exception du fichier de sortie.

Restrictions :

• Vous devez disposer du droit spécial de sauvegarde du système (*SAVSYS) ou du droit d'existence (*OBJEXIST) sur chacun des objets indiqués (ou en être le propriétaire) si ceux-ci existent déjà sur le système.
• Cette commande n'est pas fournie avec le droit public *EXCLUDE.
• L'objet de configuration d'unité doit être mis hors fonction au moment de sa restauration à l'aide de la commande VRYCFG.
• Les objets de gestion des ressources système (SRM) ne sont pas restaurés si un support créé avant l'édition V2R2M0 est utilisé pour lancer la commande RSTCFG.
• Si les commandes RSTCFG, SAVSYS et SAVCFG ne sont pas exécutées sur le même système, les objets de configuration peuvent ne pas correspondre au matériel physique du système cible.
• Si vous restaurez les objets de gestion des ressources système (SRM) sur un système autre que celui sur lequel la commande SAVSYS (Sauvegarder le système) ou SAVCFG (Sauvegarder la configuration) a été exécutée, le système considère que le matériel cible est nouveau et crée tous les noms de ressources, rendant ainsi les descriptions de configurations existantes inutiles. Dans ce cas, vous devez restaurer les objets de gestion des ressources système appropriés à partir de la sauvegarde la plus récente effectuée par la commande SAVSYS ou SAVCFG. Si aucune sauvegarde n'est disponible, vous devez modifier les descriptions de configurations existantes de sorte qu'elles comportent les nouveaux noms de ressources.

Paramètres

Objets (OBJ)

Indique les objets à restaurer. Un nom générique est composé d'un ou de plusieurs caractères suivis d'un astérisque (*). Un nom générique est composé d'un ou de plusieurs caractères suivis d'un astérisque (*). A défaut d'astérisque, le système considère que la chaîne de caractères entrée est un nom spécifique d'objet.

Si le paramètre OBJTYPE (Types d'objets) a la valeur *ALL, tous les types d'objets énumérés dans la description de ce paramètre sont restaurés, à condition qu'un nom ait été affecté à chacun.

Les objets de gestion des ressources système (SRM) ne peuvent pas être restaurés un par un ni à l'aide d'un nom générique. Pour ne restaurer que les objets de gestion des ressources du système, indiquez *SRM pour ce paramètre, ainsi qu'une valeur pour le paramètre SRM (Gestion des ressources système).

Ce paramètre est obligatoire.

Valeurs uniques

*ALL

Tous les objets de configuration des unités sont restaurés en fonction des valeurs indiquées pour le paramètre OBJTYPE.

*SRM

Les objets de configuration des unités ne sont pas restaurés, mais les objets de gestion des ressources du système (SRM) sont restaurés en fonction de la valeur indiquée au paramètre SRM.

ATTENTION Pour éviter la restauration des données SRM, vous devez indiquer SRM(*NONE) dans RSTCFG, à moins que le système sur lequel vous effectuez la restauration ait exactement la même configuration matérielle que celui de la sauvegarde initiale. Les objets de configuration sont susceptibles d'être inutilisables lorsque les données SRM sont restaurées.

Autres valeurs (jusqu'à 300 répétitions)

nom-générique

Entrez un ou plusieurs noms génériques d'objets à restaurer dans la bibliothèque.

Remarque :Un nom générique est indiqué sous la forme d'une chaîne d'un ou plusieurs caractères suivis d'un astérisque (*). Si un nom générique est spécifié, tous les noms d'objets ayant le même préfixe que le nom générique seront sélectionnés.

nom

Indiquez un ou plusieurs noms d'objets spécifiques à restaurer. Une commande peut comporter à la fois des noms génériques et spécifiques. Vous pouvez spécifier jusqu'à 300 noms d'objets.

Unité (DEV)

Indique le nom de l'unité utilisée pour la restauration. Ce nom doit être connu du système en tant que description d'unité.

Ce paramètre est obligatoire.

Valeurs uniques

*SAVF

L'opération de restauration est effectuée à l'aide du fichier sauvegarde spécifié à l'invite Fichier sauvegarde (paramètre SAVF).

Autres valeurs

nom-unité-optique

Indiquez le nom de l'unité optique utilisé pour l'opération de restauration.

nom-unité-bandothèque

Indiquez le nom de l'unité de bandothèque utilisée pour l'opération de restauration.

nom-unité-bande

Indiquez le nom d'une ou plusieurs unités de bande utilisées pour l'opération de restauration. Si une unité de bande virtuelle est utilisée, aucune autre unité ne peut être spécifiée. Dans le cas d'unités de bande multiples (quatre maximum), précisez leurs noms dans l'ordre dans lequel elles sont utilisées. Lorsque vous vous servez de plusieurs unités de bande pour la restauration de plusieurs volumes, vous pouvez rembobiner un volume, pendant qu'une autre unité de bande traite le volume suivant.

Types d'objets (OBJTYPE)

Indique le type des objets système à restaurer.

Valeurs uniques

*ALL

Tous les types d'objets de configuration des unités désignés sont restaurés. Si *ALL est également indiqué pour le paramètre OBJ (Objets), le système restaurera tous les objets de configuration des unités sauvegardés.

Autres valeurs (jusqu'à 10 répétitions)

valeur-alphanumérique

Indiquez la valeur correspondant à chaque type d'objet à restaurer.

Les types d'objets présentés sont ceux qui sont sauvegardés dans le fichier de configuration des unités à l'aide de la commande SAVSYS (Sauvegarder le système) ou SAVCFG (Sauvegarder la configuration).

*CFGL

Listes de configuration

*CNNL

Liste de connexion

*COSD

Description de classe de service

*CTLD

Description de contrôleur

*DEVD

Description d'unité

*IPXD

Description IPX

*LIND

Description de ligne

*MODD

Description de mode

*NTBD

Description NetBIOS

*NWID

Description d'interface de réseau

*NWSD

Description de serveur de réseau

Remarque :*SRMSPC peut être sauvegardé mais ne peut pas être restauré en type d'objet. Pour restaurer les données *SRM, indiquez *SRM pour le paramètre OBJ.

Identificateur de volume (VOL)

Indique les identificateurs utilisés pour la restauration des objets : ID volume du support ou ID cartouche des bandes d'une unité de bandothèque. Vous devez placer les volumes en respectant l'ordre dans lequel ils se trouvaient lors de la sauvegarde des données. Vous devez placer dans l'unité le volume qui contient le début du fichier à restaurer.

Remarque :La première version des objets trouvés à l'emplacement spécifié est restaurée, sauf si les paramètres SAVDATE et SAVTIME (ou SEQNBR dans le cas d'une bande) indiquent une version spécifique.

Valeurs uniques

*MOUNTED

Les objets sont restaurés à partir des volumes montés sur l'unité indiquée à l'invite Unité (paramètre DEV). Dans le cas d'une unité de médiathèque, le volume à utiliser correspond à la cartouche suivante de la catégorie montée à l'aide de la commande SETTAPCGY (Définir une catégorie de bande).

Remarque :Vous ne pouvez pas indiquer cette valeur si vous utilisez une unité de bibliothèque optique.

Autres valeurs (jusqu'à 75 répétitions)

valeur-alphanumérique

Indiquez les identificateurs d'un ou de plusieurs volumes selon l'ordre dans lequel ils sont montés sur l'unité et utilisés pour la restauration des données.

Numéro de séquence (SEQNBR)

Indique le numéro de séquence utilisé pour la restauration.

*SEARCH

Le fichier de données contenant les objets de configuration sauvegardés est recherché. Les objets sont restaurés lorsque le fichier correspondant est trouvé.

1-16777215

Indiquez le numéro de séquence du fichier à utiliser pour la restauration.

Option de fin de support (ENDOPT)

Indique l'opération automatiquement exécutée sur le volume de bande ou optique une fois la restauration terminée. Si vous vous servez de plusieurs volumes, ce paramètre ne s'applique qu'au dernier utilisé. Lorsque la fin de volume est atteinte, tous les autres volumes sont déchargés.

Remarque :Ce paramètre est admis uniquement si un nom d'unité de bande ou optique est indiqué pour le paramètre DEV. Pour les unités optiques, seule la valeur spéciale *UNLOAD est acceptée. Les valeurs *REWIND et *LEAVE ne seront pas prises en compte.

*REWIND

A la fin de l'opération, la bande est rebobinée automatiquement, mais elle n'est pas déchargée.

*LEAVE

La bande n'est pas rembobinée ou déchargée à la fin de l'opération. Elle conserve sa position.

*UNLOAD

La bande est automatiquement rembobinée et déchargée à la fin de l'opération. Certaines unités optiques éjecteront le volume une fois l'opération terminée.

Fichier sauvegarde (SAVF)

Indique le fichier sauvegarde à utiliser pour restaurer les données.

Remarque :Vous devez indiquer une valeur pour ce paramètre si la valeur *SAVF est spécifiée au paramètre DEV (Unité).

Qualificatif 1 : Fichier sauvegarde

nom

Indiquez le nom du fichier sauvegarde à utiliser.

Qualificatif 2: Biblio

*LIBL

La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB

Bibliothèque de l'unité d'exécution en cours utilisée pour localiser le fichier sauvegarde. S'il n'existe aucune entrée de bibliothèque en cours dans la liste des bibliothèques, la bibliothèque QGPL est utilisée.

nom

Indiquez le nom de la bibliothèque dans laquelle le fichier sauvegarde est situé.

Gestion des ressources système (SRM)

Indique le type d'informations de gestion des ressources système (SRM) à restaurer. Vous ne pouvez préciser ce paramètre que si *ALL ou *SRM est indiqué pour le paramètre OBJ (Objets).

ATTENTION Pour éviter la restauration des données SRM, vous devez indiquer SRM(*NONE) dans cette commande, à moins que le système sur lequel vous effectuez la restauration ait exactement la même configuration matérielle que celui de la sauvegarde initiale. Les objets de configuration sont susceptibles d'être inutilisables lorsque les données SRM sont restaurées sur un système de configuration matérielle différente.

*ALL

Toutes les informations de gestion des ressources système sont restaurées.

*NONE

Aucune information de gestion des ressources système n'est restaurée.

*HDW

Toutes les informations de matériel sont restaurées.

*TRA

Toutes les informations d'adaptateur d'anneau à jeton sont restaurées.

Fichier optique (OPTFILE)

Indique le nom de chemin du fichier optique utilisé pour la restauration ; ce nom doit commencer par le répertoire principal du volume.

Pour obtenir de plus amples informations relatives à la spécification des noms de chemin, reportez-vous à "Object naming rules" dans la rubrique Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

*

Le système recherche, dans le répertoire principal du volume optique, le nom par défaut généré par l'opération de sauvegarde correspondante.

'nom-chemin-répertoire-optique/*'

Le système recherche, dans le répertoire indiqué du volume optique, le nom par défaut généré par l'opération de sauvegarde correspondante.

Admettre différences d'objet (ALWOBJDIF)

Indique si des différences sont admises entre les objets sauvegardés et les objets restaurés.

Remarques :

1. Vous devez disposer du droit spécial *ALLOBJ pour pouvoir indiquer une valeur autre que *NONE pour ce paramètre.
2. Si des différences sont constatées, la fin de la restauration est signalée par un message d'arrêt programme, et non pas par le message d'achèvement normal.

Il peut s'agir des différences suivantes :

• Liste d'autorisation : L'objet sauvegardé comportait une liste d'autorisation et soit l'objet existe sur le système mais il ne comporte pas la même liste d'autorisation, soit l'objet n'existe pas et il est restauré sur un autre système que le système de sauvegarde.

  Remarque :Ce paramètre n'est pas pris en compte si l'objet sauvegardé ne comportait pas de liste d'autorisation. Si l'objet existe, il est restauré avec la liste d'autorisation de l'objet existant. Si l'objet n'existe pas, il est restauré sans liste d'autorisation.

• Propriété : Le propriétaire de l'objet sur le système est différent de celui de l'objet sauvegardé.

• Groupe principal : Le groupe principal de l'objet sur le système est différent de celui de l'objet sauvegardé.

Valeurs uniques

*NONE

Aucune des différences mentionnées ci-dessus n'est permise lors de la restauration. Reportez-vous à la description associée à chaque valeur pour déterminer le mode de gestion des différences.

*ALL

Toutes les différences mentionnées ci-dessus sont admises lors de la restauration. Reportez-vous à la description associée à chaque valeur pour déterminer le mode de gestion des différences.

Autres valeurs (jusqu'à 3 répétitions)

*AUTL

Les différences de listes d'autorisation sont permises. Si l'objet sauvegardé comportait une liste d'autorisation et que l'objet existe sur le système mais qu'il n'est pas associé à la même liste d'autorisation, l'objet est restauré avec la liste d'autorisation de l'objet existant. Si l'objet sauvegardé comportait une liste d'autorisation, que l'objet n'existe pas sur le système et qu'il est restauré sur un autre système que le système de sauvegarde, l'objet est restauré, puis lié à la liste d'autorisation. Si la liste d'autorisation n'existe pas, le droit public prend la valeur *EXCLUDE.

Si cette valeur n'est pas définie, les différences de liste d'autorisation ne sont pas permises. Si l'objet sauvegardé comportait une liste d'autorisation et que l'objet existe sur le système mais qu'il n'est pas associé à la même liste d'autorisation, l'objet n'est pas restauré. Si l'objet sauvegardé comportait une liste d'autorisation, que l'objet n'existe pas sur le système et qu'il est restauré sur un autre système que le système de sauvegarde, l'objet est restauré, mais il n'est pas lié à la liste d'autorisation et le droit public prend la valeur *EXCLUDE.

*OWNER

Les différences de propriété sont permises. Si un objet existe déjà sur le système avec un propriétaire différent de celui de l'objet sauvegardé, l'objet est restauré et le propriétaire qui lui est attribué est celui de l'objet sur le système.

Si cette valeur n'est pas définie, les différences de propriété ne sont pas permises. Si un objet existe déjà sur le système avec un propriétaire différent de celui de l'objet sauvegardé, l'objet n'est pas restauré.

*PGP

Les différences de groupe principal sont permises. Si un objet existe déjà sur le système avec un groupe principal différent de celui de l'objet sauvegardé, l'objet est restauré avec son groupe principal sur le système.

Si cette valeur n'est pas définie, les différences de groupe principal ne sont pas permises. Si un objet existe déjà sur le système avec un groupe principal différent de celui de l'objet sauvegardé, l'objet n'est pas restauré.

Sortie (OUTPUT)

Indique si une liste présentant des informations sur l'état des objets est créée puis dirigée vers un fichier en sortie. Cette liste contient des informations relatives à la restauration ainsi qu'aux objets restaurés, non restaurés et exclus. Les informations relatives à la sécurité de chaque objet restauré sont également incluses.

*NONE

Aucune sortie n'est créée.

*PRINT

Le résultat est placé dans un fichier spoule de la file d'attente en sortie du travail.

*OUTFILE

La sortie est dirigée vers le fichier base de données indiqué à l'invite Fichier recevant la sortie (paramètre OUTFILE).

Remarque :Vous devez préciser un nom de fichier de base de données pour le paramètre OUTFILE lorsque OUTPUT(*OUTFILE) est indiqué.

Fichier recevant la sortie (OUTFILE)

Indique le fichier de base de données vers lequel la sortie générée par la commande est dirigée. Si ce fichier n'existe pas, la commande en crée un dans la bibliothèque précisée. S'il existe déjà, les droits publics sur le fichier sont les mêmes que le droit de création de la pour la bibliothèque contenant le fichier. Pour afficher ce droit, utilisez la commande DSPLIBD (Afficher une description de bibliothèque).

Qualificatif 1 : Fichier recevant la sortie

nom

Indiquez le nom du fichier de base de données vers lequel la sortie générée de la commande est dirigée.

Qualificateur 2: Biblio

*LIBL

Le fichier est recherché dans la liste des bibliothèques. Si le système ne le trouve pas, il en crée un dans la bibliothèque en cours. S'il n'existe pas de bibliothèque en cours, le fichier est créé dans la bibliothèque QGPL.

*CURLIB

Bibliothèque de l'unité d'exécution en cours utilisée pour localiser le fichier. Si cette bibliothèque n'est pas indiquée, QGPL est utilisée par défaut.

nom

Indiquez le nom de la bibliothèque dans laquelle doit s'effectuer la recherche.

Remarque :Si un fichier est créé, le système utilise le fichier fourni par IBM, QASRRSTO, avec le nom de format QSRRST comme modèle.

Options pour membre de sortie (OUTMBR)

Indique le nom du membre de fichier de base données vers lequel est dirigé la sortie lorsque *OUTFILE est précisé à l'invite Sortie (paramètre OUTPUT).

Elément 1 : Membre recevant la sortie

*FIRST

Le premier membre du fichier reçoit la sortie. Si OUTMBR(*FIRST) est indiqué et que le membre n'existe pas, le système en crée un du nom indiqué à l'invite Fichier recevant la sortie (paramètre OUTFILE).

nom

Indiquez le nom du membre de fichier destiné à recevoir la sortie. Si ce membre n'existe pas, il est créé par le système.

Si le membre existe, vous pouvez ajouter des enregistrements à la fin du membre existant ou le mettre à blanc, puis ajouter les enregistrements.

Elément 2 : Remplacement ou ajout enregs

*REPLACE

Les enregistrements existant dans le membre du fichier base de données indiqué sont remplacés par les nouveaux enregistrements.

*ADD

Les nouveaux enregistrements sont ajoutés aux données existant déjà dans le membre de fichier base de données indiqué.

Objets à omettre (OMITOBJ)

Indique les objets à exclure de l'opération. Vous pouvez indiquer jusqu'à 300 objets ou objets génériques.

Elément 1 : Objet

Qualificatif 1 : Objet

*NONE

Aucun objet n'est exclu de l'opération.

*ALL

Tous les objets du type défini sont exclus de l'opération.

nom-générique

Indiquez le nom générique des objets à exclure.

Remarque :Un nom générique est indiqué sous la forme d'une chaîne d'un ou plusieurs caractères suivis d'un astérisque (*). Si un nom générique est spécifié, tous les noms d'objets ayant le même préfixe que le nom générique seront sélectionnés.

nom

Indiquez le nom de l'objet à exclure de l'opération.

Elément 2 : Type d'objet

*ALL

Tous les types d'objet sont exclus de l'opération, en fonction de la valeur indiquée pour le nom d'objet.

valeur-alphanumérique

Indiquez le type des objets à exclure de l'opération.

Pour obtenir la liste complète des types d'objet, placez le curseur dans la zone de ce paramètre et appuyez sur F4 (Invite). Pour obtenir une description des types d'objet, reportez-vous à "Types d'objet" dans Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Exemples

Exemple 1 : Restauration de tous les objets

RSTCFG   OBJ(*ALL)  DEV(TAP01)  OBJTYPE(*ALL)

Cette commande restaure toute la configuration de l'unité et tous les objets de gestion des ressources du système (SRM) à partir de la bande figurant dans l'unité TAP01.

Exemple 2 : Restauration d'une description d'unité

RSTCFG   OBJ(PRT01)  DEV(TAP01)  OBJTYPE(*DEVD)  VOL(ABCD)

La description de l'unité PRT01 ayant été sauvegardée sur le volume de bande ABCD est restaurée sur le système. Si la description du système PRT01 existe déjà sur le système, elle doit être mise hors fonction pour pouvoir être restaurée.

Exemple 3 : Restauration d'une description de serveur réseau

RSTCFG   OBJ(SERVER1)  DEV(TAP01)  OBJTYPE(*NWSD)  VOL(SAV1)

La description de serveur réseau SERVER1 ayant été sauvegardée sur le volume de bande SAV1 est restaurée sur le système. Si la description du serveur réseau SERVER1 existe déjà sur le système, elle doit être mise hors fonction pour pouvoir être restaurée.

Messages d'erreur

Messages *ESCAPE

CPF26C1

Le serveur de réseau &1 n'a pas été mis hors fonction.

CPF370C

Non autorisé au paramètre ALWOBJDIF.

CPF3707

Le fichier sauvegarde &1 de &2 ne contient aucune donnée.

CPF3709

Les unités de bande n'acceptent pas la même densité.

CPF3727

Unité &1 indiquée plusieurs fois dans la liste des noms d'unités.

CPF3728

Unité &1 indiquée avec d'autres unités.

CPF3733

&2 &1 de &3 endommagé précédemment.

CPF3738

L'unité &1 utilisée pour la sauvegarde/restauration est endommagée.

CPF3743

Restauration, affichage ou listage du fichier impossible.

CPF3748

Informations sur l'objet endommagées pour la bibliothèque &1.

CPF376B

Fichier &1 introuvable.

CPF3767

Unité &1 non trouvée.

CPF3768

Unité &1 incorrecte pour la commande indiquée.

CPF3769

Données chiffrées ou données non sauvegardées.

CPF377B

Aucun objet restauré. &3 objets exclus.

CPF377C

&1 objet(s) restauré(s) ; &2 non restauré(s) ; &6 exclu(s).

CPF3780

Fichier indiqué pour bibliothèque &1 non trouvé.

CPF3782

Le fichier &1 de &2 n'est pas un fichier sauvegarde.

CPF379B

Objets du fichier sauvegarde &1 de &2 non restaurés.

CPF3791

Fin du fichier &4 pendant traitement &2 &1 de &3.

CPF3793

Limite mémoire atteinte sur la machine ou dans l'ASP.

CPF3794

La sauvegarde ou la restauration n'a pas abouti.

CPF3796

Limite mémoire dépassée pour profil utilisateur &4.

CPF3805

Objets du fichier sauvegarde &1 de &2 non restaurés.

CPF3807

Erreur de décompression de données pour fichier sauvegarde &1 de &2.

CPF3812

Fichier sauvegarde &1 de &2 en cours d'utilisation.

CPF3883

Objets de configuration d'unité de l'IBM 38 non restaurés.

CPF5729

Allocation de l'objet &1 impossible.

CPF9809

Accès à la bibliothèque &1 impossible.

CPF9812

Fichier &1 non trouvé dans la bibliothèque &2.

CPF9820

Non autorisé à utiliser la bibliothèque &1.

CPF9822

Non autorisé au fichier &1 de &2.

CPF9825

Accès non autorisé à l'unité &1.