Aller au contenu

RSTSYSINF

Restaurer infos système

En bref

La commande RSTSYSINF permet de restaurer un sous-ensemble des objets et des données système sauvegardés à l'aide de la commande SAVSYSINF.

RSTSYSINF se lit RST (Restaurer) + SYSINF. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

RSTSYSINF DEV(…)

Paramètres

  • DEV Unité obligatoire
  • VOL Identificateur de volume
  • SEQNBR Numéro de séquence
  • ENDOPT Option de fin de support
  • SAVF Fichier sauvegarde
  • OPTFILE Fichier optique
  • OUTPUT Sortie
  • OUTFILE Fichier recevant la sortie
  • OUTMBR Options pour membre de sortie

Astuce : dans une session 5250, tapez RSTSYSINF 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 RSTSYSINF permet de restaurer un sous-ensemble des objets et des données système sauvegardés à l'aide de la commande SAVSYSINF.

La commande RSTSYSINF ne doit pas être utilisée pour les mises à niveau ou les migrations de système.

Les valeurs système liées à la sécurité ne peuvent pas être restaurées si elles ont été verrouillées. Pour toute information sur la procédure de verrouillage et de déverrouillage des valeurs système liées à la sécurité, reportez-vous à IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

La valeur système QPWDLVL (niveau de mot de passe) ne sera pas restaurée. Reportez-vous à la section Planning Password Level Changes dans le chapitre 7 du manuel IBM i Security Reference, SC41-5302 avant de modifier la valeur système QPWDLVL. En outre, en fonction de la valeur en cours de la valeur système QPWDLVL, il se peut que les valeurs système QPWDMAXLEN, QPWDMINLEN et QPWDVLDPGM ne soient pas restaurées.

Remarque : La commande RSTSYSINF génère plusieurs commandes de restauration pour les objets. Des paramètres peuvent être utilisés ou non pour toutes les commandes de restauration.

Pour en savoir plus, reportez-vous à la rubrique Ensemble de rubriques Sauvegarde et reprise de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Paramètres

Mot-clé Description Valeurs possibles Remarques
DEV Unité Valeurs uniques: *SAVF
Autres valeurs (jusqu'à 4 répétitions): Nom
Obligatoire, positionnel 1
VOL Identificateur de volume Valeurs uniques: *MOUNTED
Autres valeurs (jusqu'à 75 répétitions): Valeur caractère
Facultatif
SEQNBR Numéro de séquence 1-16777215, *SEARCH Facultatif
ENDOPT Option de fin de support *REWIND, *LEAVE, *UNLOAD Facultatif
SAVF Fichier sauvegarde Nom d'objet qualifié Facultatif
Qualificatif 1: Fichier sauvegarde Nom
Qualificatif 2: Biblio Nom, *LIBL, *CURLIB
OPTFILE Fichier optique Chemin d'accès, * Facultatif
OUTPUT Sortie *NONE, *PRINT, *OUTFILE Facultatif
OUTFILE Fichier recevant la sortie Nom d'objet qualifié Facultatif
Qualificatif 1: Fichier recevant la sortie Nom
Qualificatif 2: Biblio Nom, *LIBL, *CURLIB
OUTMBR Options pour membre de sortie Liste d'éléments Facultatif
Élément 1: Membre recevant la sortie Nom, *FIRST
Élément 2: Remplacement ou ajout enregs *REPLACE, *ADD

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.

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.

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
Un fichier de données contenant les objets d'informations système sauvegardés est recherché dans le volume placé dans une unité. Lorsque la recherche aboutit, les objets d'informations système sont restaurés.
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é.

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.
'nom-de-chemin-du-fichier-optique'
Indiquez le nom de chemin du fichier optique.

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

Exemples

Exemple 1 : Informations système restaurées depuis TAP01

RSTSYSINF DEV(TAP01)

Cette commande restaure les informations système depuis la bande placée sur l'unité de bande TAP01.

Exemple 2 : Informations système restaurées depuis SAVF et sortie imprimée générée

RSTSYSINF DEV(*SAVF) SAVF(QGPL/SAVF) OUTPUT(*PRINT)

Cette commande restaure les informations système depuis le fichier sauvegarde SAVF de la bibliothèque QGPL. Les informations concernant les éléments restaurés seront écrites dans un fichier spoule.

Messages d'erreur

Messages *ESCAPE

CPF38A8
Commande RSTSYSINF exécutée. Un ou plusieurs objet(s) non restauré(s).

© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.