RSTLIB

La commande RSTLIB permet de restaurer sur le système une bibliothèque ou un groupe de bibliothèques sauvegardées à l'aide de la commande SAVLIB (Sauvegarder bibliothèque). La restauration est complète : elle porte sur la description de la bibliothèque, ainsi que sur la description et le contenu des objets.

Pour les files d'attente de travaux et de messages, les files d'attente utilisateur et les fichiers logiques, seules les descriptions d'objet sont restaurées car seules les définitions sont sauvegardées. De même, les chemins d'accès des fichiers logiques peuvent être restaurés s'ils ont été sauvegardés. Pour de plus amples informations sur la restauration des chemins d'accès, reportez-vous au manuel Rubrique Base de données de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/. Le contenu des fichiers spoule dans les files d'attente en sortie peut être restauré s'il a été sauvegardé, en indiquant *NEW au paramètre SPLFDTA (Données de fichier spoule).

Cette commande peut être utilisée pour restaurer les bibliothèques contenant des objets pour lesquels la mémoire secondaire a été libérée par la commande SAVLIB correspondante lors de l'opération de restauration, ou des bibliothèques supprimées par la commande DLTLIB (Supprimer une bibliothèque). Si les parties données des objets contenus dans les bibliothèques sauvegardées n'ont pas été libérées, chaque bibliothèque est copiée dans la zone de mémoire secondaire qu'elle occupait auparavant. Si la mémoire a été libérée, le système recherche la mémoire secondaire requise pour stocker le contenu de la bibliothèque (la description d'objet et la partie données de chaque fichier, module, programme, programme de service, module SQL et récepteur de journal de la bibliothèque). Si la bibliothèque n'existe pas sur le système parce qu'elle a été supprimée ou qu'elle est restaurée sur un autre système, le système doit trouver de la mémoire secondaire pour tous les éléments de la bibliothèque, y compris pour la description de cette dernière.

Si un objet restauré sur un objet existant sur le système, le propriétaire, le groupe principal, les droits publics et privés, la liste d'autorisations et la valeur d'audit des objets de l'objet existant sont conservés. Le paramètre Admettre différences d'objet (ALWOBJDIF) peut déterminer si l'objet est restauré et le paramètre Droits privés (PVTAUT) peut ajouter les droits privés sauvegardés aux droits privés existants. Les objets existants utilisés, tels que les files d'attente en sortie actives, ne sont pas restaurés. Les files d'attente de données existantes ne sont pas restaurées.

Si un objet est restauré comme nouvel objet sur le système, le nom du propriétaire, le nom du groupe principal, le droit public et la valeur d'audit d'objet sauvegardés sont utilisés. Le paramètre ALWOBJDIF peut déterminer si le nom de la liste d'autorisations sauvegardé est utilisé et le paramètre PVTAUT peut restaurer les droits privés sauvegardés. Si le profil utilisateur du propriétaire n'existe pas, c'est le propriétaire par défaut du système (QDFTOWN) qui devient le propriétaire de l'objet. Si le groupe principal n'existe pas, *NONE est utilisé.

Si une bibliothèque est restaurée dans une bibliothèque existante sur le système, le droit public par défaut et les valeurs d'audit pour les objets créés dans la bibliothèque existante sont conservés. Si la bibliothèque est restaurée comme nouvelle bibliothèque, ces valeurs sont restaurées à partir du support.

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

Restrictions :

• Cette commande n'est pas fournie avec le droit public *EXCLUDE.
• Vous devez bénéficier des droits spéciaux de sauvegarde du système (*SAVSYS) ou disposer de l'ensemble des droits suivants :
  1. Disposer du droit de lecture (*READ) et d'ajout (*ADD) sur toutes les bibliothèques indiquées ou être le propriétaire de ces dernières.
  2. Disposer du droit d'existence (*OBJEXIST) sur l'objet pour chaque objet de la bibliothèque si l'objet existe dans celle-ci sur le système, ou être propriétaire de ces objets. Les droits *OBJEXIST et d'utilisation (*USE) sont requis pour les objets de file d'attente de messages. Si l'objet n'existe pas, le droit d'ajout (*ADD) sur les profils utilisateur propriétaires de chaque objet est restauré. Dans le cas de données de fichier spoule, le droit *OBJEXIST est requis pour la file d'attente en sortie dans laquelle elles sont restaurées.

     Si vous ne disposez pas des droits requis sur toutes les bibliothèques et les objets spécifiés, seuls ceux sur lesquels vous disposez des droits appropriés sont restaurés.

  3. Si VOL(*SAVVOL) est indiqué, disposer du droit d'utilisation *USE de la bibliothèque d'origine.
  4. Disposer du droit d'utilisation *USE du fichier sauvegarde, dans le cas de restaurations de bibliothèques à partir d'un fichier sauvegarde. Le droit d'utilisation *USE de la description d'unité et le fichier unité sont requis pour la restauration de bibliothèques à partir d'une bande ou d'une unité optique.
• Vous devez disposer du droit d'utilisation (*USE) de la commande CRTSAVF (Créer un fichier sauvegarde) pour restaurer un fichier sauvegarde qui n'existe pas actuellement sur le système.
• Lorsque vous utilisez une définition de support, vous devez disposer du droit *USE sur la définition de support et du droit d'exécution *EXECUTE sur la bibliothèque de la définition de support.
• Lors d'une sauvegarde ou d'une restauration dans un fichier base de données existant, pour laquelle le paramètre OUTFILE est indiqué, vous devez disposer du droit d'exécution *EXECUTE sur la bibliothèque du fichier en sortie.
• Les versions en cours des programmes sur le système ne doivent pas être exécutées lorsque la bibliothèque les contenant est en cours de restauration. Si un programme OPM est exécuté alors qu'il est en cours de restauration, il se peut qu'il échoue ou qu'il se comporte de façon inattendue.

Paramètres

Biblio des objets sauvegardés (SAVLIB)

Indique les bibliothèques à restaurer sur le système.

Remarques :

1. Si vous définissez plusieurs bibliothèques, des valeurs spécifiques ou une valeur générique :
   • Le paramètre DEV (Unité) ne doit pas indiquer *SAVF.
   • Le paramètre RSTLIB (Bibliothèque de restauration) doit indiquer *SAVLIB.
   • Le paramètre LABEL (Label) doit indiquer *SAVLIB.
   • Le paramètre OPTFILE (Fichier optique) doit indiquer * ou se terminer par /*.
2. Dans le cas des valeurs *NONSYS et *IBM, vous devez arrêter toutes les autres opérations sur le système avant d'indiquer cette option. Pour arrêter tous les sous-systèmes, utilisez les commandes ENDSBS ou ENDSYS.
3. Le fichier bande ou optique que vous avez choisi de restaurer peut contenir une bibliothèque qui ne correspond pas à la valeur indiquée pour ce paramètre. Ce paramètre permet de déterminer la valeur LABEL par défaut pour un fichier bande et la valeur OPTFILE par défaut pour un fichier optique mais l'opération de restauration ne vérifie pas que ce paramètre correspond à la bibliothèque sauvegardée.

Ce paramètre est obligatoire.

Valeurs uniques

*NONSYS

La restauration s'effectue pour toutes les bibliothèques sauvegardées à l'aide de la commande SAVLIB, avec *NONSYS indiqué à l'invite Bibliothèque (paramètre LIB).

Vous pouvez exécuter successivement les commandes RSTLIB SAVLIB LIB(*IBM) et RSTLIB SAVLIB LIB(*ALLUSR) à partir de la commande SAVLIB LIB(*NONSYS).

*ALLUSR

Toutes les bibliothèques utilisateur sont restaurées. Toutes les bibliothèques dont le nom ne commence pas par la lettre Q sont restaurées, à l'exception de :

#CGULIB     #DSULIB     #SEULIB
#COBLIB     #RPGLIB
#DFULIB     #SDALIB

Bien que les bibliothèques Qxxx suivantes soient fournies par IBM, elles contiennent généralement des données utilisateur qui sont fréquemment modifiées. Ces bibliothèques sont donc considérées comme des "bibliothèques utilisateur" et sont elles aussi restaurées.

QDSNX       QRCLxxxxx   QUSRDIRDB   QUSRVI
QGPL        QSRVAGT     QUSRIJS     QUSRVxRxMx
QGPL38      QSYS2       QUSRINFSKR  QWQCENT
QMGTC       QSYS2xxxxx  QUSRNOTES   QWQREPOS
QMGTC2      QS36F       QUSROND
QMPGDATA    QUSER38     QUSRPOSGS
QMQMDATA    QUSRADSM    QUSRPOSSA
QMQMPROC    QUSRBRM     QUSRPYMSVR
QPFRDATA    QUSRDIRCF   QUSRRDARS
QRCL        QUSRDIRCL   QUSRSYS

*IBM

Restaure toutes les bibliothèques IBM, à l'exception des bibliothèques suivantes :

QDOC        QRCL        QSYS2xxxxx  QUSRPOSGS
QDOCxxxx    QRCLxxxxx   QS36F       QUSRPOSSA
QDSNX       QRCYxxxxx   QTEMP       QUSRPYMSVR
QGPL        QRECOVERY   QUSER38     QUSRRDARS
QGPL38      QRPLOBJ     QUSRADSM    QUSRSYS
QMGTC       QRPLxxxxx   QUSRBRM     QUSRVI
QMGTC2      QSPL        QUSRDIRCF   QUSRVxRxMx
QMPGDATA    QSPLxxxx    QUSRDIRCL   QWQCENT
QMQMDATA    QSRV        QUSRDIRDB   QWQREPOS
QMQMPROC    QSRVAGT     QUSRIJS
QPFRDATA    QSYS        QUSRINFSKR
QPTFOBJ1    QSYSxxxxx   QUSRNOTES
QPTFOBJ2    QSYS2       QUSROND

Remarque :L'utilisateur peut créer une bibliothèque de nom différent, au format QUSRVxRxMx, pour chacune des éditions précédentes prises en charge par IBM, afin d'y stocker les commandes utilisateur à compiler dans un programme CL pour une édition précédente. En ce qui concerne la bibliothèque utilisateur QUSRVxRxMx, VxRxMx correspond à une version, édition et niveau de modification précédents encore admis par IBM.

Les bibliothèques suivantes, dont le nom ne commence pas par Q, sont également restaurées :

#CGULIB     #DSULIB     #SEULIB
#COBLIB     #RPGLIB
#DFULIB     #SDALIB

*ANY

Restaure la première version de toutes les bibliothèques sauvegardées sur la bande en commençant par le numéro de séquence défini pour le paramètre SEQNBR (Numéro de séquence), ou restaure toutes les bibliothèques sauvegardées sur le support optique dans le répertoire défini par le paramètre OPTFILE (Fichier optique).

*SELECT

Les bibliothèques identifiées au paramètre Sélection (SELECT) sont restaurées. Une seule bibliothèque peut être indiquée dans le critère de sélection lors de la restauration à partir d'un fichier sauvegarde.

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

nom-générique

Indiquez le nom générique de la bibliothèque à restaurer.

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 la bibliothèque à restaurer. Le nom de la bibliothèque à restaurer doit être exactement tel qu'il a été indiqué lors de la sauvegarde.

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

*MEDDFN

L'opération de restauration est effectuée sur les unités et supports indiqués dans la définition de support précisée à l'invite Définition de support (paramètre MEDDFN).

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. Pour pouvoir utiliser plusieurs unités de bande en parallèle, vous devez indiquer une définition de support.

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 de la bibliothèque sauvegardée trouvée sur le support est restaurée, sauf si une version spécifique est identifiée par les paramètres SAVDATE (Date de sauvegarde) et SAVTIME (Heure de sauvegarde) ou, dans le cas d'une bande, par le paramètre SEQNBR (Numéro de séquence).

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.

*SAVVOL

Le système, à l'aide de l'historique de sauvegarde/restauration, identifie les volumes qui contiennent la dernière sauvegarde de la bibliothèque. Lorsque le type d'unité indiqué pour le paramètre DEV (Unité) ne correspond pas au type d'unité utilisé pour la dernière sauvegarde, un message d'erreur est envoyé à l'utilisateur et la fonction est arrêtée. Si *SAVVOL est indiqué, les paramètres SAVDATE et SAVTIME ne doivent pas figurer dans la commande. Si *SAVVOL est indiqué, *SEARCH doit être spécifié pour le paramètre SEQNBR.

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 lorsqu'une bande est utilisée.

*SEARCH

Un fichier de données avec un identificateur correspondant à la valeur du paramètre FROMLABEL est recherché sur le volume de l'unité. Lorsque cet identificateur est trouvé, l'objet est restauré. Si la dernière opération sur l'unité indiquait *LEAVE à l'invite Option fin de bande (paramètre ENDOPT) pour préciser que la bande est positionnée à l'endroit exact de la fin de la dernière opération, la recherche de fichier commence par le premier fichier de données rencontré après la position en cours de la bande. Si *LEAVE n'a pas été utilisé à l'invite Option fin de bande (paramètre ENDOPT) de la dernière opération ou si la bande a été rembobinée manuellement depuis l'opération, la recherche débute à partir du premier fichier de données du volume.

1 à 16777215

Indiquez le numéro de séquence du fichier à utiliser pour l'opération de restauration.

Si vous indiquez *NONSYS, *ALLUSR ou *IBM au paramètre SAVLIB (Biblio des objets sauvegardés), le numéro de séquence définit l'emplacement du fichier QFILE. Ce fichier est le premier fichier sauvegardé lorsque vous utilisez *NONSYS, *ALLUSR ou *IBM. Le fichier QFILE contient la liste des bibliothèques sauvegardées.

Label (LABEL)

Indique le nom qui identifie le fichier de données à utiliser pour l'opération de restauration. Ce label doit avoir été indiqué dans la commande de sauvegarde.

*SAVLIB

Le label du fichier correspond au nom spécifié à l'invite Biblio des objets sauvegardés (paramètre SAVLIB).

valeur-alphanumérique

Indiquez l'identificateur du fichier de données utilisé pour la restauration. Vous pouvez utiliser 17 caractères au maximum. Cette option n'est admise que pour la restauration d'une seule bibliothèque.

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.

Bibliothèque de début (STRLIB)

Indique le nom de la bibliothèque marquant le point de départ d'une restauration *NONSYS, *IBM ou *ALLUSR.

Si une erreur de support irrémédiable se produit au cours de la sauvegarde, vous pouvez utiliser ce paramètre pour redémarrer l'opération.

Remarque :Dans les étapes de reprise suivantes, *NONSYS est indiqué pour le paramètre SAVLIB (Biblio des objets sauvegardés) de la commande. Si vous restaurez des bibliothèques fournies par IBM ou toutes les bibliothèques utilisateur et les bibliothèques IBM, indiquez *IBM ou *ALLUSR.

Les principales étapes de reprise d'une restauration sont les suivantes :

1. Consultez l'historique du travail afin de trouver la bibliothèque sur laquelle la précédente commande de restauration (RSTLIB SAVLIB(*NONSYS)) a échoué. Déterminez la dernière bibliothèque restaurée ; celle-ci est signalée par un message indiquant que la restauration a abouti.
2. Chargez la première bande du support SAVLIB LIB(*NONSYS).
3. Tapez la commande suivante, puis appuyez sur ENTREE :

   RSTLIB   SAVLIB(*NONSYS)  DEV(TAP01)  ENDOPT(*LEAVE)
            STRLIB(nom-bibliothèque) OMITLIB(nom-bibliothèque)
   

   où le nom-bibliothèque indiqué pour les paramètres STRLIB et OMITLIB est celui de la bibliothèque sur laquelle RSTLIB a échoué. Cette commande permet de démarrer la restauration sur la bibliothèque suivante.

4. Lorsque vous y êtes invité, chargez le volume de bande contenant la première bibliothèque.
5. Lorsque la restauration est terminée, restaurez la bibliothèque pour laquelle la restauration a échoué, à l'aide du support d'une sauvegarde antérieure.

   Remarque :N'oubliez pas de retirer la bande comportant une erreur afin d'éviter toute nouvelle erreur liée au support.

Remarque :Ce paramètre n'est correct que si *NONSYS, *IBM ou *ALLUSR est indiqué pour le paramètre SAVLIB.

*FIRST

La restauration commence par la première bibliothèque sauvegardée.

nom

Indiquez le nom de la bibliothèque marquant le point de départ de la restauration.

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

Définition de support (MEDDFN)

Indique l'objet de définition du support (*MEDDFN) qui identifie les unités et supports utilisés pour restaurer les données. Pour plus d'informations sur la création et l'utilisation d'une définition de support, reportez-vous au manuel Reprise du système, SC41-5304 et à l'API de création de définition de support dans le manuel Ensemble de rubriques API de la catégorie Programmation de l'IBM i Information Center (http://www.ibm.com/systems/i/infocenter/).

Si une définition de support est indiquée, aucune valeur ne peut être spécifiée aux paramètres VOL, SEQNBR, SAVF et OPTFILE, car Les identificateurs et numéros de séquence des volumes figurent déjà dans la définition de support.

Qualificatif 1 : Définition de support

nom

Indiquez le nom de la définition de support à 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

La recherche porte sur la bibliothèque en cours de l'unité d'exécution. Si aucune bibliothèque n'est définie comme bibliothèque en cours pour l'unité d'exécution, la recherche porte sur la bibliothèque QGPL.

nom

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

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.

Bibliothèques à omettre (OMITLIB)

Indique une liste de bibliothèques à exclure de l'opération de restauration.

Valeurs uniques

*NONE

Aucune bibliothèque n'est exclue de l'opération de restauration.

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

nom-générique

Indiquez le nom générique des bibliothèques à 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-bibliothèque

Indiquez le nom de la bibliothèque à exclure de l'opération de restauration.

Option (OPTION)

Indique la façon dont est restauré chaque objet.

*ALL

Tous les objets de la bibliothèque de sauvegarde sont restaurés dans la bibliothèque. Ils remplacent les versions en cours dans la bibliothèque système. Les objets sans version en cours sont ajoutés dans la bibliothèque système. Les objets figurant dans la bibliothèque, mais pas sur le support, restent dans cette dernière.

*NEW

La restauration ne s'applique qu'aux objets de la bibliothèque de sauvegarde n'existant pas dans la version en cours de la bibliothèque système. Elle ne porte que sur les objets non connus de la bibliothèque système. Cette option permet de restaurer les objets qui ont été supprimés après leur sauvegarde, ou qui sont nouveaux pour cette bibliothèque. Si des objets sauvegardés ont une version existante dans la bibliothèque système, ils ne sont pas restaurés et un message d'information est envoyé pour chacun d'eux, mais l'opération de restauration continue.

*OLD

La restauration ne s'applique qu'aux objets de la bibliothèque pour lesquels il existe une version de sauvegarde. Cette dernière va remplacer la version en cours dans la bibliothèque. La restauration ne porte que sur les objets connus de la bibliothèque. Si des objets sauvegardés ne font plus partie de la bibliothèque en ligne, ils ne sont pas restaurés et un message d'information est envoyé pour chacun d'eux, mais l'opération de restauration continue.

*FREE

Les objets sauvegardés ne sont restaurés que s'ils existent dans la bibliothèque système et que l'espace correspondant est libre. La version sauvegardée de chaque objet est restaurée dans l'espace libéré lors de la sauvegarde. Si des objets sauvegardés ne font plus partie de la bibliothèque en cours ou que l'espace correspondant n'est pas libre, les objets ne sont pas restaurés et un message d'information est envoyé pour chacun d'eux. Toutefois l'opération de restauration continue et tous les objets libérés sont restaurés.

Option membre base de données (MBROPT)

Indique, pour les fichiers base de données existant sur le système, quels membres doivent être restaurés. Si *MATCH est utilisé, la liste des membres contenue dans le fichier sauvegarde doit correspondre, membre pour membre, à la version en cours dans le système. Lorsqu'un fichier qui n'existe pas déjà est restauré, tous ses membres sont restaurés.

*MATCH

Les membres sauvegardés sont restaurés si les listes des membres de la sauvegarde correspondent, membre pour membre, aux listes de la version du système. MBROPT(*MATCH) n'est pas admis lorsque *ALL est indiqué à l'invite Admettre différences d'objet (paramètre ALWOBJDIF).

*ALL

Tous les membres du fichier sauvegardé sont restaurés.

*NEW

Seuls les membres nouveaux (non identifiés sur le système) sont restaurés.

*OLD

Seuls les membres déjà identifiés sur le système sont restaurés.

ID mise en différé (DFRID)

Indique l'identificateur à utiliser si vous souhaitez mettre en différé la restauration ou les demandes de démarrage de journalisation des objets qui dépendent d'autres objets qui ne sont pas encore disponibles. Pour effectuer la restauration ou les demandes de démarrage de journalisation des objets mis en différé, restaurez les objets dont ils dépendent et indiquez le même ID mise en différé. Si des objets sont toujours mis en différé lorsque les autres objets sont disponibles, utilisez la commande RSTDFROBJ (Restaurer les objets mis en différé) et indiquez le même ID mise en différé. Ce paramètre permet de restaurer tous les objets d'un ensemble de bibliothèques lorsque les bibliothèques qui contiennent des objets dépendants sont restaurées avant les bibliothèques qui contiennent les objets dont ils dépendent.

Les objets mis en différé sont les suivants :

• Les fichiers logiques, lorsque les fichiers sous-jacents sont manquants. Un fichier logique mis en différé n'existe pas sur le système tant que la restauration n'est pas terminée.
• Les tables de requêtes matérialisées SQL, lorsque les fichiers sous-jacents sont manquants. Une table de requêtes matérialisée existe sur le système, mais les fonctions exécutées sur cette dernière qui nécessitent un accès aux fichiers sous-jacents échoueront.
• Les demandes de démarrage de journalisation pour les objets fichier (*FILE), zone de données (*DTAARA), file d'attente de données (*DTAQ) et bibliothèque (*LIB), lorsque les journaux sont manquants. Lorsque les objets mis en différé sont traités, la journalisation démarre si les journaux sont disponibles.

Remarques :

1. Si les conditions ci-dessous sont vraies, la restauration d'un objet mis en différé peut être effectuée automatiquement lorsque les objets dont il dépend sont restaurés :
   • L'objet mis en différé est restauré dans la bibliothèque dans laquelle il a été sauvegardé.
   • Le même ID mise en différé est indiqué pour les opérations de restauration pour l'objet mis en différé et les objets dont il dépend.

*DFT

Si *NONSYS, *ALLUSR ou *IBM est spécifié pour le paramètre Biblio des objets sauvegardés (SAVLIB) et que vous disposer du droit spécial *SAVSYS (Sauvegarder le système), l'identificateur QRSTLIB est utilisé. Les objets sont mis en différé s'ils dépendent d'autres objets qui ne sont pas disponibles. Le plus souvent, les objets mis en différé sont terminés lorsque cette opération de restauration restaure les autres objets.

Si une autre valeur est indiquée pour le paramètre SAVLIB ou si vous ne disposez pas du droit spécial *SAVSYS, aucun identificateur n'est utilisé. Les objets ne sont pas mis en différé s'ils dépendent d'autres objets qui ne sont pas disponibles.

*NONE

Les objets ne sont pas mis en différé s'ils dépendent d'autres objets qui ne sont pas disponibles.

nom

Indique un identificateur pour mettre en différé la restauration des objets qui dépendent d'autres objets qui ne sont pas encore disponibles. Vous devez disposer du droit spécial *SAVSYS (Sauvegarder le système) pour indiquer un nom.

Données de fichier spoule (SPLFDTA)

Permet d'indiquer si les données et les attributs de fichier spoule doivent être restaurés.

*NEW

Pour chaque file d'attente en sortie restaurée, les données de fichier spoule sauvegardées en même temps sont restaurées si elles n'existent pas sur le système.

*NONE

Aucune donnée de fichier spoule n'est restaurée.

Droits privés (PVTAUT)

Indique si les droits privés doivent être restaurés avec les objets restaurés.

*NO

Aucun droit privé n'est restauré.

*YES

Les droits privés sont restaurés avec les objets. Les objets ne sont restaurés qu'à partir des opérations de sauvegarde indiquant que les droits privés doivent être sauvegardés avec les objets.

Remarque :Vous devez disposer du droit spécial *ALLOBJ (Tous les objets) pour indiquer cette valeur.

Démarrer journalisation (STRJRN)

Indique si la journalisation des nouveaux objets restaurés doit être démarrée.

Remarques :

1. Les informations de journal ayant été sauvegardées seront restaurées pour les nouveaux objets, que la journalisation soit démarrée ou non.
2. La journalisation ne change pas pour les objets existants.

*YES

La journalisation est démarrée pour les nouveaux objets qui étaient journalisés lors de leur sauvegarde.

*NO

La journalisation n'est pas démarrée pour les objets qui sont restaurés.

Date de sauvegarde (SAVDATE)

Indique la date de sauvegarde de la bibliothèque. Si vous ne restaurez pas la version la plus récente, ou si plusieurs versions sauvegardées figurent sur les volumes, entrez la date de la version à restaurer.

Si un identificateur de volume ou *MOUNTED est indiqué pour le paramètre VOL (Identificateur de volume), mais que ce paramètre n'est pas défini, le système restaurera la première version de bibliothèque trouvée sur le volume. Ce paramètre est incompatible avec VOL(*SAVVOL).

date

Définissez la date de sauvegarde de la bibliothèque à restaurer. Cette date doit être conforme au format de date du travail.

Heure de sauvegarde (SAVTIME)

Indique l'heure de sauvegarde de la bibliothèque, si la restauration ne porte pas sur la version en cours.

Si un identificateur de volume ou *MOUNTED est indiqué pour le paramètre VOL (Identificateur de volume), mais que ce paramètre n'est pas défini, le système restaurera la première version de bibliothèque trouvée sur le volume. Ce paramètre n'est admis que si le paramètre SAVDATE (Date de sauvegarde) est également défini.

heure

Définissez l'heure de sauvegarde de la bibliothèque à restaurer. L'heure peut être indiquée avec ou sans séparateur horaire :

• Si vous n'utilisez pas de séparateur d'heure, indiquez une chaîne au format hhmm ou hhmmss (4 ou 6 chiffres), où hh = heures, mm = minutes et ss = secondes.
• Dans le cas contraire, entrez une chaîne de 5 ou 8 chiffres dans laquelle le séparateur d'heure défini pour votre travail permet de séparer les heures, les minutes et les secondes. Si vous entrez cette commande sur la ligne de commande, vous devez la placer entre apostrophes. Si vous utilisez un autre séparateur d'heure que celui défini pour votre travail, cette commande n'aboutira pas.

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.

• ID de niveau de fichier : la date et l'heure de création du fichier de base de données sur le système ne correspondent pas à celles du fichier sauvegardé.

• ID de niveau de membre : la date et l'heure de création du membre de fichier de base de données sur le système ne correspondent pas à celles du fichier sauvegardé.

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

*COMPATIBLE

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. Cette valeur admet les différences compatibles avec les fichiers base de données physique existants. Cette valeur admet également les différences de niveau de fichier avec les fichiers base de données logique existants. Elle est généralement préférable à la valeur *ALL, laquelle admet des différences qui ne sont pas compatibles avec les fichiers base de données existants.

*ALL

Toutes les différences mentionnées ci-dessus sont admises lors de la restauration. Les différences d'ID de niveau de fichier et de niveau de membre sont prises en compte différemment de la valeur *FILELVL. S'il existe une différence de niveau de fichier et que la valeur *ALL est définie pour le paramètre MBROPT (Option membre base de données), la version existante du fichier est renommée et sa version sauvegardée est restaurée. S'il existe une différence de niveau de membre, la version existante du membre est renommée et sa version sauvegardée est restaurée. Cette valeur restaure les données enregistrées, mais le résultat peut s'avérer incorrect. Vous devrez déterminer si les données restaurées ou les données renommées sont correctes, et vous devrez effectuer les corrections nécessaires dans la base de données. Pour savoir comment gérer les autres types de différences, reportez-vous à la description relative à chaque valeur.

Autres valeurs (jusqu'à 4 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.

*FILELVL

Les différences d'ID de niveau de fichier et de niveau de membre sont permises. Une tentative sera lancée pour restaurer les fichiers physiques existants, même si le fichier physique du support de sauvegarde porte un ID de niveau de fichier ou de membre différent du fichier physique du système. Les données du fichier physique ne seront restaurées que pour les fichiers physiques dont les ID de niveau de format sur le support de sauvegarde correspondent à ceux du fichier physique adéquat sur le système.

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

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

Forcer conversion d'objet (FRCOBJCVN)

Indique si la conversion des objets utilisateur au format requis pour la version en cours du système d'exploitation doit être effectuée, ou s'ils sont compatibles avec l'ordinateur actuel, lors de la restauration de ces derniers.

Remarques :

1. Ce paramètre ne s'applique qu'aux objets utilisateur de type *MODULE, *PGM, *SRVPGM et *SQLPKG.
2. Un objet doit disposer de données de création (observables ou non) pour être converti.
3. Si la conversion d'un objet est requise (car il est formaté pour une version antérieure du système d'exploitation ou est incompatible avec l'ordinateur actuel) mais non effectuée lors de cette opération de restauration, l'objet est automatiquement converti lorsqu'il est utilisé pour la première fois.

Valeurs uniques

*SYSVAL

Les objets sont convertis en fonction de la valeur système QFRCCVNRST.

*NO

Les objets ne sont pas convertis pendant l'opération de restauration.

Remarque :Si FRCOBJCVN(*NO) est indiqué, la valeur système QFRCCVNRST doit avoir la valeur "0" ou "1".

Elément 1 : Conversion à la restauration

*YES

Les objets sont convertis pendant l'opération de restauration.

Remarques :

1. Si FRCOBJCVN(*YES *RQD) est indiqué, la valeur système QFRCCVNRST doit être "0", "1" ou "2". FRCOBJCVN(*YES *RQD) va remplacer une valeur QFRCCVNRST de "0" ou "1". Si FRCOBJCVN(*YES *ALL) est indiqué, QFRCCVNRST peut avoir une valeur correcte et FRCOBJCVN(*YES *ALL) remplace la valeur système QFRCCVNRST.
2. Le fait de spécifier cette valeur a pour conséquence d'augmenter la durée de l'opération de restauration, toutefois, il n'est plus nécessaire de convertir les objets lorsqu'ils sont utilisés pour la première fois.

Elément 2 : Objets à convertir

*RQD

Les objets ne sont convertis que si le système d'exploitation requiert cette opération pour pouvoir utiliser ces derniers ou pour être compatibles avec l'ordinateur actuel. Si les objets ne disposent pas de toutes les données de création (observables ou non), ils ne peuvent pas être convertis et ne vont pas être restaurés.

*ALL

Tous les objets sont convertis quel que soit leur format actuel et la compatibilité avec l'ordinateur, y compris ceux qui sont déjà au format en cours. Toutefois, si les objets ne disposent pas de toutes les données de création (observables ou non), ils ne peuvent pas être convertis et ne vont pas être restaurés.

Bibliothèque de restauration (RSTLIB)

Indique si le contenu de la bibliothèque doit être restauré dans la bibliothèque de sauvegarde ou bien dans une autre.

*SAVLIB

Les données sont restaurées dans la ou les bibliothèques où elles ont été sauvegardées.

nom

Indiquez le nom de la bibliothèque où les données sauvegardées sont restaurées. Si *NONSYS, *IBM ou *ALLUSR est indiqué pour le paramètre SAVLIB (Biblio des objets sauvegardés), un nom de bibliothèque ne peut pas être indiqué ce paramètre.

Remarque :Si une base de données SQL est restaurée dans une autre bibliothèque que celle où elle a été sauvegardée, les journaux ne sont pas restaurés.

Unité ASP de restauration (RSTASPDEV)

Indique l'unité ASP (pool de mémoire secondaire) vers laquelle les données sont restaurées.

Remarque :Vous pouvez spécifier le paramètre RSTASPDEV ou RSTASP, mais pas les deux.

*SAVASPDEV

Les données sont restaurées vers le même ASP où elles ont été sauvegardées.

nom

Indiquez le nom de l'unité ASP à utiliser.

Numéro d'ASP de restauration (RSTASP)

Indique si les objets sont restaurés dans le pool de mémoire secondaire (ASP) à partir duquel ils ont été sauvegardés, dans l'ASP système (ASP 1) ou dans un ASP utilisateur de base (ASP 2 à 32).

Certains objets ne peuvent pas être restaurés dans des ASP utilisateur. Le manuel Reprise du système, SC41-5304, contient de plus amples informations sur les types d'objets pouvant être restaurés dans les ASP utilisateur. Si la bibliothèque existe dans l'ASP système ou y est restaurée, les journaux, les récepteurs de journal et les fichiers sauvegarde pourront être restaurés dans les ASP utilisateur de base. En revanche, tous les autres types d'objets seront restaurés dans l'ASP de la bibliothèque.

ATTENTION : Les bibliothèques système ou de logiciel (dont le nom commence par Q ou #) ne doivent pas être créées ni restaurées dans un ASP utilisateurs. Une telle opération pourrait générer des résultats imprévisibles.

*SAVASP

Les objets sont restaurés dans l'ASP à partir duquel ils ont été sauvegardés.

1-32

Indique le numéro de l'ASP. Lorsque l'ASP 1 est indiqué, les objets précisés sont restaurés dans l'ASP système. Lorsque les ASP 2 à 32 sont indiqués, les objets sont restaurés dans l'ASP utilisateur de base précisé.

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

Type d'informations en sortie (INFTYPE)

Indique le type d'informations imprimées ou acheminées vers le fichier base de données.

*OBJ

La liste contient un poste pour chaque objet à restaurer.

*MBR

La liste contient un poste pour chaque objet, membre de fichier base de données et fichier spoule à restaurer.

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.

Qualificatif 2 : Biblio

*ALL

Les objets indiqués sont exclus de toutes les bibliothèques faisant partie de l'opération.

nom-générique

Indiquez le nom générique des bibliothèques qui contiennent les 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 la bibliothèque contenant 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/.

Sélection (SELECT)

Indique le critère de sélection des objets à restaurer. Vous pouvez effectuer une sélection parmi les objets des bibliothèques spécifiées au paramètre Biblio des objets sauvegardés (SAVLIB).

Elément 1 : Inclure ou omettre

Indique si les objets sélectionnés doivent être inclus ou omis dans l'opération de restauration.

*INCLUDE

Les objets sélectionnés sont restaurés, sauf s'ils sont remplacés via une spécification *OMIT ou omis via le paramètre Bibliothèques à omettre (OMITLIB) ou Objets à omettre (OMITOBJ).

*OMIT

Les objets sélectionnés ne sont pas inclus dans l'opération de restauration.

Elément 2 : Objet

Qualificatif 1 : Objet

*ALL

Tous les noms d'objet sont sélectionnés.

nom-générique

Indiquez le nom générique des objets à sélectionner.

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 à sélectionner.

Qualificatif 2 : Biblio

*ALL

Tous les noms de bibliothèque indiqués au paramètre Biblio des objets sauvegardés (SAVLIB) sont sélectionnés.

nom-générique

Indiquez le nom générique des bibliothèques à sélectionner.

nom

Indiquez le nom de la bibliothèque à sélectionner.

Elément 3 : Type d'objet

*ALL

Tous les types d'objet sont sélectionnés.

valeur-alphanumérique

Indiquez le type d'objet à sélectionner.

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

Elément 4 : Attribut d'objet

*ALL

Tous les attributs d'objet sont sélectionnés.

*BLANK

Seuls les objets sans valeur d'attribut sont sélectionnés.

valeur-attribut

Indiquez l'attribut des objets à sélectionner.

valeur-attribut-générique

Indiquez l'attribut générique des objets à sélectionner.

Elément 5 : Membre du fichier

Indique les membres de fichier base de données à sélectionner.

Si *ALL est spécifié, les objets sélectionnés par les éléments précédents sont inclus ou omis.

Si une valeur autre que *ALL est spécifiée, les objets sélectionnés par les éléments précédents sont inclus, même s'il ne s'agit pas de fichiers base de données. Si les objets sélectionnés sont des fichiers base de données, les membres de fichier sélectionnés sont inclus ou omis.

*ALL

Tous les membres de fichier sont sélectionnés. Pour une spécification *OMIT, le fichier ou l'objet sélectionné est également omis.

*ALLMBR

Tous les membres de fichier sont sélectionnés. Pour une spécification *OMIT, le fichier ou l'objet sélectionné est inclus et tous les membres de fichier sont omis.

nom-générique

Indiquez le nom générique des membres de fichier à sélectionner. Le fichier ou l'objet sélectionné est inclus même s'il ne contient pas les membres spécifiés.

nom

Indiquez le nom du membre de fichier à sélectionner. Le fichier ou l'objet sélectionné est inclus même s'il ne contient pas le membre spécifié.

Exemples

Exemple 1 : Restauration des nouveaux objets

RSTLIB   SAVLIB(JOE)  DEV(TAP01)  OPTION(*NEW)

Cette commande restaure la version sauvegardée de la bibliothèque JOE à partir de la l'unité de bande TAP01. Seuls les nouveaux objets sont restaurés dans la bibliothèque (objets qui se trouvaient dans la bibliothèque lorsqu'ils ont été sauvegardés, puis supprimés).

Exemple 2 : Impression d'une sortie

RSTLIB   SAVLIB(*NONSYS)  DEV(TAP01)  OUTPUT(*PRINT)
         DFRID(*DFT)

Cette commande restaure toutes les bibliothèques non-système sauvegardées, depuis la bande vers le système. Le contenu des bibliothèques est restauré exactement tel qu'il avait été sauvegardé. Les nouveaux objets (sur bande) sont ajoutés au système. Les anciens objets du système sont remplacés par la version des anciens objets figurant sur bande. Du fait que OUTPUT(*PRINT) a été indiqué, une sortie imprimée de tous les objets (restaurés ou non) de chaque bibliothèque, est envoyée à l'imprimante avec la sortie spoule du travail. Chaque bibliothèque suivant la première démarre sur une nouvelle page. Après chaque bibliothèque, un message de fin indique combien d'objets ont été restaurés et combien ne l'ont pas été. A la fin de l'impression, une liste des objets mis en différé est imprimée et un message de fin indique le nombre de bibliothèques restaurées et le nombre de bibliothèques non restaurées.

Exemple 3 : Spécification du point de départ de l'opération de restauration

RSTLIB   SAVLIB(*NONSYS)  DEV(TAP01)  STRLIB(MIKESLIB)

Cette commande restaure les bibliothèques non-système sauvegardées en commençant par la bibliothèque MIKESLIB, à partir de l'unité de bande TAP01. La première bande de la sauvegarde non-système doit être chargée. Un message d'interrogation indique à l'utilisateur qu'il doit charger la bande contenant MIKESLIB. Le cas échéant, le même message est envoyé jusqu'à ce que la bande contenant MIKESLIB soit trouvée.

Exemple 4 : Restauration d'une version à une date et une heure précises

RSTLIB   SAVLIB(PAYROLL)  DEV(TAP01)  SAVDATE(060193)
         SAVTIME(103214)  RSTLIB(OLDPAY)  VOL(PAY)

Cette commande restaure la version de la bibliothèque PAYROLL à partir de l'unité de bande TAP01, dont l'identificateur de volume est PAY. La version à restaurer a été sauvegardée à 10:32:14 le 01/06/93. Tous les objets de la bibliothèque PAYROLL sauvegardée sont restaurés vers la bibliothèque OLDPAY. Tous les nouveaux fichiers sont restaurés. Les anciens fichiers ne sont restaurés que si les listes de membres de la bande correspondent aux listes de membres des fichiers sur le système.

Exemple 5 : Restauration à partir de plusieurs volumes de bande

RSTLIB   SAVLIB(QGPL)  DEV(TAP01)  VOL(QGPL QGPL)

Cette commande restaure la bibliothèque QGPL à partir de deux volumes de bande nommés tous les deux QGPL. Bien que les identificateurs de volume soient identiques, ils doivent être indiqués tous les deux.

Exemple 6 : Restauration en série à partir de plusieurs unités de bande

RSTLIB  SAVLIB(USRLIB)  DEV(TAP01 TAP02 TAP03)
        VOL(USRA USRB USRC USRD)  ENDOPT(*UNLOAD)

Cette commande restaure la bibliothèque USRLIB à partir de quatre unités de bande. Le volume USRA est placé sur l'unité de bande TAP01, le volume USRB sur l'unité de bande TAP02, le volume USRC sur l'unité de bande TAP03 et le volume USRD sur l'unité de bande TAP01. L'opérateur supprime le volume USRA de l'unité de bande TAP01, de façon à ce que TAP01 soit utilisable par le volume USRD. Si les volumes de bande sont placés dans un ordre erroné, un message d'erreur est envoyé dans la file d'attente des messages de l'opérateur système.

Exemple 7 : Restauration en parallèle à partir de plusieurs unités

RSTLIB   SAVLIB(USRLIB)  DEV(*MEDDFN)  MEDDFN(LIBA/MEDDFNA)

Cette commande restaure la bibliothèque USRLIB en utilisant les unités et les volumes indiqués dans la définition de support MEDDFNA de la bibliothèque LIBA. Pour plus d'informations concernant la création et l'utilisation d'une définition de support, consultez la rubrique sur la sauvegarde, la restauration et la disponibilité du Centre de documentation.

Exemple 8 : Restauration d'une version spécifique

RSTLIB   SAVLIB(LIB1)  DEV(TAP01)  MBROPT(*ALL)
         SAVDATE(082392)  SAVTIME(123251)
         RSTLIB(LIB2)  OUTPUT(*PRINT)

Cette commande restaure la version de la bibliothèque LIB1 à partir de l'unité de bande TAP01. La version à restaurer a été sauvegardée à 12:32:51 le 23/08/92. Tous les objets de la bibliothèque LIB1 sauvegardée sont restaurés vers la bibliothèque LIB2. La liste des objets restaurés et non restaurés est fournie. Tous les fichiers et membres de fichier sont restaurés.

Exemple 9 : Restauration d'une bibliothèque à partir d'un fichier sauvegarde

RSTLIB   SAVLIB(LIB1)  DEV(*SAVF)  SAVF(SAVF1)

Cette commande restaure la bibliothèque LIB1 à partir du fichier sauvegarde SAVF1.

Exemple 10 : Restauration vers un ASP utilisateur de base

RSTLIB   SAVLIB(LIB1)  DEV(*SAVF)  SAVF(SAVF1)  RSTASP(2)

Cette commande restaure la bibliothèque LIB1 à partir du fichier sauvegarde SAVF1. La bibliothèque et tous les objets de la version sauvegardée de LIB1 sont restaurés dans le pool de mémoire secondaire (ASP) 2 sauf des les cas suivants :

• La bibliothèque existe déjà dans un ASP différent.
• L'ASP 2 contient un journal, un récepteur du journal ou un fichier SAVF faisant partie d'une bibliothèque de l'ASP système.
• L'ASP 2 n'existe pas sur le système.
• Il existe des types d'objet dans la bibliothèque qui ne peuvent pas être restaurés vers des ASP utilisateur. Ces objets ne seront pas restaurés.

Exemple 11 : Restauration dans un ASP indépendant

RSTLIB   SAVLIB(LIB1)  DEV(*SAVF)  SAVF(SAVF1)
         RSTASPDEV(DIVISION1)

Cette commande restaure la bibliothèque LIB1 à partir du fichier sauvegarde SAVF1. La bibliothèque et tous les objets de la version sauvegardée de LIB1 sont restaurés dans l'ASP indépendant DIVISION1 sauf des les cas suivants :

• La bibliothèque existe déjà dans l'ASP système, un ASP utilisateur de base ou un ASP indépendant différent du même groupe d'ASP lié en tant que DIVISION1.
• L'ASP DIVISION1 n'est pas disponible sur le système.
• Il existe des types d'objet dans la bibliothèque qui ne peuvent pas être restaurés dans des ASP indépendants. Ces objets ne seront pas restaurés.

Exemple 12 : Restauration de plusieurs bibliothèques à partir d'une bande

RSTLIB   SAVLIB(*ANY)  DEV(TAP01)  SEQNBR(75)

Cette commande restaure la première version sauvegardée de chaque bibliothèque à partir de l'unité de bande TAP01, en commençant au numéro de séquence 75 du fichier de bande.

Exemple 13 : Restauration de plusieurs bibliothèques à partir d'un volume optique

RSTLIB   SAVLIB(A* B*)  DEV(OPT01)  OPTFILE('/BACKUP/*')

Cette commande restaure toutes les bibliothèques dont les noms commencent par A ou B se trouvant dans le répertoire BACKUP du volume optique figurant dans l'unité OPT01.

Exemple 14 : Restauration de fichiers spoule

RSTLIB   SAVLIB(JOE)  DEV(TAP01)  SPLFDTA(*NEW)

Cette commande restaure la version sauvegardée de la bibliothèque JOE à partir de la l'unité de bande TAP01. Les fichiers spoule qui n'existent pas sur le système et qui ont été sauvegardés avec des files d'attente en sortie dans cette bibliothèque sont restaurés.

Messages d'erreur

Messages *ESCAPE

CPF370C

Non autorisé au paramètre ALWOBJDIF.

CPF3705

&2 &1 dans &3 non journalisé.

CPF3706

Objet &1 de type &2 non restauré dans la bibliothèque &3.

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

CPF372C

Bibliothèque &1 non restaurée dans l'ASP &2.

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.

CPF373E

Bibliothèque &1 non restaurée dans l'ASP &2.

CPF3730

Non autorisé à sauvegarder ou restaurer &2 &1 dans &3.

CPF3731

Impossible d'utiliser &2 &1 de la bibliothèque &3.

CPF3732

Erreur d'état de &1 de type &2 au cours de la restauration.

CPF3733

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

CPF3738

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

CPF3739

Membre du fichier base de données &1 de &3 endommagé.

CPF3740

Objet &1 de type &2 non trouvé dans &3.

CPF3743

Restauration, affichage ou listage du fichier impossible.

CPF3748

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

CPF375F

Fichier non sélectionné. Restauration impossible à partir de &1.

CPF3752

Aucune trace de l'opération de sauvegarde n'existe pour la biblio &1.

CPF3757

&2 &1 non restauré dans &3.

CPF3758

&2 &1 non restauré dans &3.

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.

CPF3770

Aucun objet de &1 n'a été sauvegardé ou restauré.

CPF3773

&1 objets restaurés. &2 non restauré(s) dans &4.

CPF3779

&1 biblio restaurées ; &4 restaurées partiellement ; &2 non restaurées.

CPF378B

La bibliothèque &1 n'a pas été créée.

CPF3780

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

CPF3782

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

CPF3783

Emplacement de VOL(*SAVVOL) inconnu. Aucun objet restauré.

CPF3784

Unité de restauration indiquée au paramètre DEV incompatible avec unité VOL(*SAVVOL).

CPF3785

Tous les sous-systèmes ne sont pas arrêté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.

CPF37A5

RSTASP &1 n'est pas en ligne.

CPF37B8

Non autorisé à restaurer les droits privés.

CPF37C2

Non autorisé à utiliser DFRID.

CPF380E

Profil utilisateur &1 non restauré. Impossible de créer un UID ou un GID.

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.

CPF3818

Bibliothèque de début &1 non trouvée.

CPF384F

Objet &1 de type &2 non restauré dans la bibliothèque &3.

CPF3894

Réponse d'annulation reçue pour message &1.

CPF38A2

Unité ASP &1 incorrecte.

CPF38A6

Une seule bibliothèque admise avec les paramètres indiqué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.

CPF9814

Unité &1 non trouvée.

CPF9820

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

CPF9822

Non autorisé au fichier &1 de &2.

CPF9825

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

CPF9829

Pool de mémoire secondaire &1 non trouvé.

CPFB8ED

La description d'unité &1 est incorrecte pour l'opération.

OPT1498

Liste de noms de volume épuisée sur l'unité &1.

OPT1502

Tentative de traitement d'un volume à la fin d'un jeu de volumes.

OPT1605

Erreur de support ou d'unité.

Messages *STATUS

CPF3770

Aucun objet de &1 n'a été sauvegardé ou restauré.

CPF3773

&1 objets restaurés. &2 non restauré(s) dans &4.