RSTOBJ

La commande RSTOBJ (Restaurer un objet) permet de restaurer sur le système (dans une bibliothèque) un objet ou un groupe d'objets préalablement sauvegardés sur une bande ou un volume optique, ou dans un fichier sauvegarde, à l'aide d'une commande unique. Les objets à restaurer auraient pu être sauvegardés par la commande SAVOBJ (Sauvegarder un objet), SAVCHGOBJ (Sauvegarder les objets modifiés) ou SAVLIB (Sauvegarder une bibliothèque). La commande RSTOBJ (Restaurer un objet) permet de restaurer la description et le contenu de chaque objet indiqué.

Pour les files d'attente de travaux, les files d'attente de messages définies par l'utilisateur, les fichiers logiques et les files d'attente utilisateur, seules les descriptions d'objet sont restaurées ; le contenu des objets ne l'est pas. Cependant, les chemins d'accès des fichiers logiques peuvent être sauvegardés à l'aide d'une commande de sauvegarde comportant le paramètre ACCPTH(*YES). Dans ce cas, les chemins d'accès sont restauré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).

La commande peut être utilisée pour restaurer les objets, même si la mémoire secondaire a été libérée lors de la sauvegarde des objets ou si ces derniers ont été supprimés après leur sauvegarde. Si la mémoire secondaire n'a pas été libérée lors de la sauvegarde, chaque objet est restauré dans la zone de mémoire secondaire qu'il occupait précédemment. Si la version de l'objet en cours de restauration a une taille supérieure à la version existant sur le système (par exemple les enregistrements de données qui ont été supprimés du système existent encore dans la version sauvegardée d'un fichier), la mémoire secondaire supplémentaire requise pour l'objet est acquise. Si la version sauvegardée a une taille inférieure, (par exemple, des enregistrements de données qui sont ajoutés au système), la mémoire qui a été acquise pour l'objet reste affectée à celui-ci et disponible pour être utilisé par cet objet.

Si les chemins d'accès des fichiers logiques ont été sauvegardés (ACCPTH(*YES) a été indiqué lors de la sauvegarde de l'objet), ils sont restaurés si (1) tous les fichiers physiques sous-jacents sont également restaurés par la même commande de restauration, (2) le fichier logique est aussi restauré par la même commande de restauration ou existe déjà sur le système (le même fichier existe et non une version recréée) et (3) MAINT(*IMMED ou *DLY) est en effet pour le fichier logique si celui-ci existe encore sur le système.

Si la mémoire secondaire a été libérée, le système recherche l'espace requis pour stocker le contenu (uniquement la partie données) de chaque fichier, module, programme, programme de service, récepteur de journal et module SQL. Si les objets n'existent pas sur le système parce qu'ils ont été supprimés ou sont restaurés sur un autre système, le système doit rechercher la mémoire secondaire nécessaire au stockage de tous les éléments (partie description et données) de chaque objet inconnu.

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

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

ATTENTION : n'utilisez pas cette commande pour restaurer des logiciels sous licence dans la bibliothèque QSYS. Des résultats imprévus risquent de se produire.

Restrictions :

• Cette commande n'est pas fournie avec le droit public *EXCLUDE.
• 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.
• 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 où se trouve le fichier de base de données.
• Vous devez disposer du droit spécial *SAVSYS (Sauvegarder le système) ou de tous les droits sur les objets suivants :
  • Ajoutez le droit *ADD (ajout) et *EXECUTE (exécution) sur la bibliothèque indiquée et la bibliothèque du fichier sauvegarde.
  • Disposer du droit d'existence (*OBJEXIST) pour chaque objet défini, si l'objet existe dans la bibliothèque 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 dans la bibliothèque sur le système, vous devez disposer du droit d'ajout (*ADD) pour les profils utilisateur propriétaires de chaque objet 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 VOL(*SAVVOL) est indiqué, disposer du droit d'utilisation *USE de la bibliothèque d'origine.
• La commande RSTOBJ ne restaure pas le dictionnaire de données de la bibliothèque ou les fichiers base de données associés. Pour le restaurer, utilisez la commande RSTLIB.
• Vous devez disposer du droit d'utilisation (*USE) du fichier sauvegarde pour pouvoir effectuer une restauration à partir de celui-ci. De plus, vous devez disposer du droit d'utilisation (*USE) de la description d'unité lorsque vous restaurez à partir d'une bande ou d'une unité optique.
• Lorsque vous utilisez une définition de support, vous devez disposer du droit *USE sur cette définition de support et du droit *EXECUTE sur la bibliothèque de cette définition de support.
• Si cette commande est utilisée pour restaurer un programme OPM, la copie du programme actuellement sur le système ne doit pas être en cours d'exécution lors de la restauration du programme. En effet, le programme pourrait échouer ou se comporter de façon inattendue.
• Les objets sauvegardés à l'aide de commandes distinctes doivent également être restaurés via des commandes distinctes. Si une commande unique est utilisée, certains objets ne seront pas restaurés.
• Si les objets du domaine utilisateur *USRSPC (espace utilisateur), *USRIDX (index utilisateur) ou *USRQ (file d'attente utilisateur) sont restaurés dans une bibliothèque non admise par la valeur système QALWUSRDMN (admettre les objets du domaine utilisateur dans les bibliothèques), l'objet est converti en objet domaine système.

Paramètres

Objets (OBJ)

Indique le nom (spécifique ou générique) des objets à restaurer. Ces objets seront restaurés à partir du premier fichier qui contient l'un d'entre eux et qui correspond à la valeur de recherche. Si une bande contient plusieurs fichiers de la même bibliothèque, vous devrez peut-être indiquer le numéro de séquence du fichier bande afin de vous assurer que tous les objets corrects sont restaurés.

Si le fichier ne contient pas tous les objets que vous avez indiqués, vous recevrez des messages de diagnostic pour les objets non trouvés. Le message d'achèvement contiendra le nombre des objets qui auront été restaurés et de ceux qui ne l'auront pas été.

Si le paramètre OBJTYPE (Types d'objets) n'est pas défini lorsque vous exécutez la commande, tous les types d'objets énumérés dans la description de ce paramètre sont restaurés, à condition qu'ils se trouvent dans la bibliothèque désignée sur le support ou dans le fichier sauvegarde et que leur nom ait été indiqué.

Ce paramètre est obligatoire.

Valeurs uniques

*ALL

Tous les objets sauvegardés à partir de la bibliothèque indiquée sont restaurés, en fonction des valeurs entrées pour les paramètres OBJTYPE (Types d'objets) et OPTION (Option).

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

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.

Biblio des objets sauvegardés (SAVLIB)

Indique les bibliothèques qui contenaient les objets sauvegardés. Si *SAVLIB est défini ou indiqué par défaut pour le paramètre RSTLIB (Bibliothèque de restauration), le nom de la bibliothèque dans laquelle les objets seront restaurés est identique à celui-ci.

Remarques :

1. Si vous définissez plusieurs bibliothèques, une valeur unique ou une valeur générique de bibliothèque :
   • 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. 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

*ANY

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

*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 des bibliothèques à 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.

Types d'objets (OBJTYPE)

Indique le type des objets système à restaurer.

Valeurs uniques

*ALL

Tous les types d'objets désignés et sauvegardés à partir de la bibliothèque indiquée sont restaurés. Si *ALL est également indiqué pour le paramètre OBJ (Objets), tous les objets sauvegardés pour la bibliothèque indiquée sont restaurés.

Autres valeurs

type-objet

Entrez le type d'objet à restaurer, c'est-à-dire une valeur telle que *CMD (commande), *FILE (fichier) ou *PGM (programme).

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

Remarque :Les types d'objets *CFGL peuvent être restaurés à l'aide de la commande RSTOBJ (Restaurer un objet) uniquement à partir d'objets sauvegardés dans des éditions antérieures à V2R2M0. Les types d'objets *CFGL sauvegardés en V2R2M0 et en éditions ultérieures peuvent être restaurés à l'aide de la commande RSTCFG (Restaurer la configuration).

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 version des objets restaurés est la première version trouvée à l'emplacement spécifié, sauf si une version spécifique est indiquée par les paramètres SAVDATE (Date de sauvegarde) et SAVTIME (Heure de sauvegarde).

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 sur la sauvegarde/restauration, identifie les volumes qui contiennent la dernière sauvegarde des objets.

Remarque :S'il s'agit d'une restauration d'une unité optique, seuls les six premiers caractères du nom de volume sont disponibles. Si le nom de volume du support optique dépasse six caractères, il se peut que le volume ne soit pas trouvé. Vous devez spécifier le nom de volume ou de fichier complet avec la commande plutôt que d'utiliser VOL(*SAVVOL) lorsque le nom du support optique dépasse six caractères.

Lorsque *SAVVOL est indiqué, les caractéristiques d'exploitation et les restrictions suivantes s'appliquent :

• Si les caractéristiques de l'unité indiquée au paramètre DEV ne correspondent pas à l'unité et à l'emplacement de la dernière version sauvegardée de la bibliothèque, un message d'erreur est envoyé à l'utilisateur et la fonction est arrêtée.
• Si un volume incorrect est placé dans une unité à l'emplacement indiqué par la commande, un message est envoyé à l'opérateur système. Il identifie le premier volume devant être placé dans l'unité avant que les objets soient restaurés.
• Lorsque OBJ(*ALL) et OBJTYPE(*ALL) sont indiqués, les objets sont traités dans l'ordre dans lequel ils apparaîtraient dans l'écran affiché par la commande DSPLIB (Afficher une bibliothèque). Les noms et types d'objet indiqués dans la commande RSTOBJ permettent de déterminer quel fichier d'objets sauvegardés doit être utilisé pour l'opération de restauration. Pour chaque commande SAVLIB ou SAVOBJ, un fichier est généré. Le fichier choisi est celui dans lequel le premier objet traité est le dernier sauvegardé. Les objets qui n'ont pas été sauvegardés dans le fichier choisi pour traitement ou qui ont été sauvegardés plus récemment ne sont pas restaurés. Un message d'erreur est envoyé à l'utilisateur pour chaque objet non restauré.
• Si *SAVVOL est indiqué, les paramètres SAVDATE et SAVTIME ne doivent pas figurer dans la commande.
• Si *SAVVOL est indiqué et que la valeur de RSTLIB est identique à celle de SAVLIB, OPTION(*NEW) ne doit pas figurer dans la commande.
• Si *SAVVOL est indiqué, SEQNBR(*SEARCH) et LABEL(*SAVLIB) doivent être spécifiés.

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.

Position de début (POSITION)

Indique à quel emplacement du fichier bande doit débuter la recherche des données à restaurer. L'indication d'une valeur ici peut accélérer l'opération de restauration si vous souhaitez uniquement restaurer des données qui ne sont pas enregistrées vers le début du fichier bande.

*FIRST

La recherche des données à restaurer commence au début du fichier bande.

valeur-hexadécimale

Indiquez la position de début dans le fichier bande pour le premier à objet à restaurer. La position de début de chaque objet a été renvoyée dans la sortie de l'opération de sauvegarde. Si vous souhaitez restaurer plusieurs objets, indiquez la plus petite des valeurs qui ont été renvoyées pour l'ensemble des objets à restaurer. Si vous indiquez une valeur hexadécimale, vous devez par ailleurs indiquer une valeur autre que *SEARCH pour le paramètre Numéro de séquence (SEQNBR).

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.

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

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.

Membre du fichier (FILEMBR)

Indique les membres du fichier base de données à restaurer. Ce paramètre est composé de deux parties : le nom de fichier et le nom de membre. Ce paramètre ne peut pas être défini si *MATCH est indiqué pour le paramètre MBROPT (Option membre base de données).

Chaque fichier de base de données indiqué ici doit également figurer dans le paramètre OBJ (Objets), où il peut être désigné par un nom spécifique, par un nom générique ou bien par *ALL. Le paramètre OBJTYPE (Types d'objets) doit avoir la valeur *ALL ou inclure *FILE. Les noms génériques ne peuvent être utilisés pour les fichiers base de données, mais sont admis pour les membres. Vous ne pouvez pas indiquer deux fois le même nom de fichier.

Vous pouvez indiquer jusqu'à 50 combinaisons membre/fichier pour ce paramètre.

Elément 1 : Fichier

*ALL

La liste des noms de membres qui figure à la suite de cette valeur s'applique à tous les fichiers désignés dans le paramètre OBJ.

nom

Entrez le nom du fichier base de données à partir duquel les membres de la liste sont restaurés.

Elément 2 : Membre

Valeurs uniques

*ALL

Tous les membres sont restaurés à partir du fichier indiqué.

*NONE

Aucun membre n'est restauré à partir du fichier indiqué. Seule la description de fichier est restaurée.

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

nom-générique

Entrez le nom générique des membres à restaurer à partir du fichier indiqué. 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 de membre.

nom

Entrez le nom du membre à restaurer à partir du fichier indiqué.

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.

*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 des objets. Si la version à restaurer n'est pas la version la plus récente, ou bien si plusieurs versions ont été sauvegardées sur les volumes, entrez la date de la version à restaurer. Lorsqu'un identificateur de volume ou *MOUNTED est entré pour le paramètre VOL (Identificateur de volume), sans que SAVDATE soit indiqué, la première version trouvée sur le volume est restaurée. Ce paramètre est admis uniquement si un identificateur de volume ou si *MOUNTED est indiqué au paramètre VOL, ou encore si un fichier sauvegarde est indiqué au paramètre SAVF (Fichier sauvegarde). Ce paramètre n'est pas pris en compte lorsque le paramètre SEQNBR (Numéro de séquence) est défini.

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 à laquelle les objets ont été sauvegardés.

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

Ce paramètre n'est pas pris en compte lorsqu'un nombre est défini pour le paramètre SEQNBR (Numéro de séquence).

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 les objets doivent être restaurés dans leur bibliothèque d'origine ou dans une autre.

*SAVLIB

Les objets sont restaurés dans la même bibliothèque que celle à partir de laquelle ils ont été sauvegardés.

nom

Entrez le nom de la bibliothèque où les objets sauvegardés doivent être restaurés.

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

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.

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

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.

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.

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 spécifiés aux paramètres Objets (OBJ),Biblio des objets sauvegardés (SAVLIB) et Types d'objets (OBJTYPE).

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 spécifiés au paramètre Objets (OBJ) 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 indiqués au paramètre Types d'objets (OBJTYPE) 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, le paramètre Membre du fichier (FILEMBR) ne peut pas être indiqué. 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 de la version sauvegardée la plus récente

RSTOBJ   OBJ(PAYROLL)  SAVLIB(LIBX)  DEV(TAP01)
         OBJTYPE(*PGM)  VOL(*SAVVOL)

Cette commande restaure vers LIBX le programme PAYROLL qui a été sauvegardé à partir de LIBX. L'unité de bande TAP01 est utilisée pour restaurer la version sauvegardée la plus récente du programme.

Exemple 2 : Indication de la date et de l'heure de sauvegarde

RSTOBJ   OBJ(PAY*)  SAVLIB(LIBX)  DEV(OPT01)  VOL(ABCD)
         OPTION(*OLD)  SAVDATE(102202)
         SAVTIME(143000)  RSTLIB(LIBY)

Tous les objets dont les noms commencent par PAY et qui ont été sauvegardés à partir de la bibliothèque LIBX sur le volume optique ABCD à 14:30:00 le 22/10/02 sont restaurés dans LIBY. Le volume ABCD doit être placé sur l'unité optique nommée OPT01. Du fait que OPTION(*OLD) ait été indiqué, seuls les objets de même nom et de même type figurant dans LIBY sur le système et dans LIBX sur le volume optique sont restaurés.

Exemple 3 : Ajout d'un nouveau programme à la bibliothèque QGPL

RSTOBJ   OBJ(NEWPROG)  SAVLIB(QGPL)  DEV(OPT01)  OBJTYPE(*PGM)
         VOL(PGMS)  OPTION(*NEW)  ALWOBJDIF(*AUTL)

Un nouveau programme nommé NEWPROG est ajouté à la bibliothèque générale QGPL. Il est restauré à partir d'un volume dont le label est PGMS et qui est placé dans l'unité optique OPT01. Si l'objet a été sauvegardé sur un autre système et qu'il était associé à une liste d'autorisation, il sera associée à celle qui porte le même nom sur ce système.

Exemple 4 : Impression d'une liste de sortie

RSTOBJ   OBJ(*ALL)  SAVLIB(LIB)  DEV(TAP01)  OBJTYPE(*PGM)
         VOL(SVOL)  SEQNBR(2)  SAVDATE(082392)
         SAVTIME(143000)  OUTPUT(*PRINT)

Tous les programmes ayant été sauvegardés à partir de la bibliothèque LIB, et qui existent dans la version sauvegardée sur le volume de bande nommé SVOL, numéro de séquence 2, sauvegardé à 14:30:00 le 23/08/92, sont restaurés dans la bibliothèque nommée LIB. Une liste de sortie de tous les objets restaurés et non restaurés est fournie.

Exemple 5 : Restauration de récepteurs de journal

RSTOBJ   OBJ(*ALL)  SAVLIB(BACKUP)  DEV(*SAVF)
         OBJTYPE(*JRNRCV)  SAVF(SAVEJ)  RSTASP(3)

Tous les récepteurs de journal ayant été sauvegardés à partir de la bibliothèque BACKUP dans le fichier sauvegarde SAVEJ sont restaurés dans la bibliothèque BACKUP. Les récepteurs de journal sont restaurés vers l'ASP utilisateur de base 3 (sauf s'ils existent déjà dans la bibliothèque BACKUP et se trouvent dans un autre ASP, ou si l'ASP 3 contient une bibliothèque).

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

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.

CPF3730

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

CPF3731

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

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

CPF374C

Aucun objet restauré dans l'ASP &2.

CPF3743

Restauration, affichage ou listage du fichier impossible.

CPF3748

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

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.

CPF3780

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

CPF3781

Bibliothèque &1 non trouvée.

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

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.

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.

CPF384F

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

CPF3867

Valeurs du paramètre FILEMBR incorrectes.

CPF3868

FILEMBR indiqué mais OBJTYPE doit être *ALL ou *FILE.

CPF3871

Aucun objet sauvegardé ou restauré ; &3 objet(s) exclu(s).

CPF3872

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

CPF38A2

Unité ASP &1 incorrecte.

CPF38A6

Une seule bibliothèque admise avec les paramètres indiqués.

CPF38AB

FILEMBR incorrect avec SELECT.

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