Aller au contenu

RSTDLO

Restaurer document ou dossier

En bref

La commande RSTDLO vous permet de restaurer sur le système des documents, dossiers et objets de distribution (courrier).

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

Syntaxe minimale

RSTDLO DLO(…) DEV(…)

Paramètres

  • DLO Document ou dossier obligatoire
  • SAVFLR Dossier des objets sauvegardés
  • RENAME Nouveau nom d'objet
  • RSTFLR Dossier de restauration
  • DEV Unité obligatoire
  • SYSOBJNAM Nom d'objet système
  • VOL Identificateur de volume
  • SEQNBR Numéro de séquence
  • ENDOPT Option de fin de support
  • LABEL Label
  • SAVF Fichier sauvegarde
  • OPTFILE Fichier optique
  • NEWOBJ Génération nom d'objet
  • SAVDATE Date de sauvegarde
  • SAVTIME Heure de sauvegarde
  • ALWOBJDIF Admettre différences d'objet
  • SAVASP Numéro d'ASP de sauvegarde
  • RSTASP Numéro d'ASP de restauration
  • OUTPUT Sortie
  • OUTFILE Fichier recevant la sortie
  • OUTMBR Options pour membre de sortie

Astuce : dans une session 5250, tapez RSTDLO puis F4 pour l'invite de saisie, et F1 sur un paramètre pour son aide.

Aide IBM i de la commande

Texte du F1, IBM i 7.5 en français (bibliothèque QSYS)

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Non

La commande RSTDLO vous permet de restaurer sur le système des documents, dossiers et objets de distribution (courrier).

Cette commande peut être utilisée pour restaurer les documents et les dossiers, qu'ils aient été libérés ou non à l'aide de la commande SAVDLO (Sauvegarder un document ou un dossier), ou encore pour restaurer les documents et les dossiers supprimés à l'aide de la commande DLTDLO (Supprimer un document ou un dossier).

La restauration d'un document a pour effet soit de remplacer, soit de créer le contenu et les informations de contrôle de ce document, selon qu'il existe déjà sur le système ou non.

Pour un document archivé (courrier électronique ou document stocké dans la bibliothèque de documents), le document et son nom de dossier sur le support doivent être les mêmes que sur le système, sauf si le document est renommé et mis dans un autre dossier pendant l'opération de restauration.

Remarque :Les noms de dossiers doivent correspondre exactement à ceux des dossiers restaurés. Tous les objets non utilisés sont restaurés à partir du dossier du support ou fichier sauvegarde dans le dossier existant. La restauration d'un dossier en crée un nouveau si le dossier n'existe pas et ajoute à ce nouveau dossier tous les objets sauvegardés avec l'ancien sur le support ou dans le fichier sauvegarde. Si le dossier existe, tous les objets dossier ou document non existants à l'intérieur de ce dossier sont créés. Les documents existants sont remplacés par la version provenant du support.

Pour un document archivé restauré sur le système et dont le propriétaire n'est pas connu du système ou n'est pas inscrit dans le répertoire de distribution, le profil utilisateur du propriétaire par défaut (QDFTOWN) devient propriétaire du document ou dossier.

La date de création d'un document ne change pas si ce document existe. Dans le cas contraire, cette date est fixée à la date à laquelle le document a été créé.

La sécurité ne change pas si un document ou dossier existe sur le système où il doit être restauré. S'il n'existe pas, les droits publics, la liste d'autorisation et l'état personnel sont restaurés ; toutefois, tous les autres droits privés sur le document et le dossier ne sont pas restaurés. Ces droits doivent être rétablis par le propriétaire.

Si un document restauré avait un poste de registre courrier lors de sa sauvegarde, ce poste est restauré si le suivi de distribution existe sur le système. S'il n'existe pas, un message indiquant que le document a été restauré sans poste de registre courrier est envoyé.

Si cette commande s'achève de manière anormale, des objets sont laissés sur le système en état inconnu et sont introuvables en bibliothèque. Cela peut se produire si une panne d'électricité se produit lors de l'exécution de cette commande. La commande RCLSTG (Récupérer mémoire secondaire) peut être utilisée pour nettoyer la mémoire secondaire et supprimer la plupart de ces objets du système ; toutefois, les objets courrier inconnus ne sont pas éliminés avec cette commande.

Lorsqu'un ensemble de documents et de dossiers est restauré, tous les documents et dossiers de cet ensemble doivent se trouver sur la même bande, le même volume optique ou le même fichier sauvegarde.

Si un document existe dans plusieurs fichiers bande, l'utilisateur peut décider du document à restaurer en spécifiant le fichier de support via le paramètre numéro de séquence ou label. S'il existe plusieurs versions du document, les paramètres SAVDATE et SAVTIME peuvent également être utilisés pour sélectionner le document approprié.

S'il existe des fonctions de recherche de texte sur le système et que l'utilisateur restaure un objet de la bibliothèque de documents, l'index de recherche de texte pour cet objet est restauré.

Restrictions :

  • Cette commande est fournie sans le droit public (*EXCLUDE).
  • Pour pouvoir exécuter cette commande, vous devez posséder le droit spécial de sauvegarde du système (*SAVSYS) ou le droit spécial sur tous les objets (*ALLOBJ), ou être inscrit dans le répertoire de distribution du système.
  • Cette commande ne peut pas être exécutée en même temps que RCLDLO DLO(*ALL) car RCLDLO exige une utilisation exclusive d'objets internes.
  • Lorsque vous effectuez une opération de sauvegarde ou de restauration vers une base de données à l'aide du paramètre OUTFILE, vous devez disposer du droit d'exécution (*EXECUTE) sur la bibliothèque dans laquelle se trouve le fichier de base de données en sortie.

Paramètres

Mot-clé Description Valeurs possibles Remarques
DLO Document ou dossier Valeurs uniques: *ALL, *SYSOBJNAM, *MAIL
Autres valeurs (jusqu'à 300 répétitions): Valeur caractère
Obligatoire, positionnel 1
SAVFLR Dossier des objets sauvegardés Valeurs uniques: *ANY, *NONE
Autres valeurs (jusqu'à 300 répétitions): Valeur caractère
Facultatif
RENAME Nouveau nom d'objet Valeurs uniques: *SAME
Autres valeurs (jusqu'à 300 répétitions): Valeur caractère
Facultatif
RSTFLR Dossier de restauration Valeur caractère, *SAME Facultatif
DEV Unité Valeurs uniques: *SAVF
Autres valeurs (jusqu'à 4 répétitions): Nom
Obligatoire, positionnel 2
SYSOBJNAM Nom d'objet système Values (jusqu'à 300 répétitions): Nom, *NONE Facultatif
VOL Identificateur de volume Valeurs uniques: *MOUNTED
Autres valeurs (jusqu'à 75 répétitions): Valeur caractère
Facultatif
SEQNBR Numéro de séquence Valeurs uniques: *SEARCH
Autres valeurs: Liste d'éléments
Facultatif
Élément 1: Numéro de séquence de début 1-16777215
Élément 2: Numéro de séquence de fin 1-16777215, *ONLY
ENDOPT Option de fin de support *REWIND, *LEAVE, *UNLOAD Facultatif
LABEL Label Valeur caractère, *GEN Facultatif
SAVF Fichier sauvegarde Nom d'objet qualifié Facultatif
Qualificatif 1: Fichier sauvegarde Nom
Qualificatif 2: Biblio Nom, *LIBL, *CURLIB
OPTFILE Fichier optique Chemin d'accès, * Facultatif
NEWOBJ Génération nom d'objet *SAME, *NEW Facultatif
SAVDATE Date de sauvegarde Date Facultatif
SAVTIME Heure de sauvegarde Heure Facultatif
ALWOBJDIF Admettre différences d'objet *NONE, *ALL Facultatif
SAVASP Numéro d'ASP de sauvegarde 1-32, *ANY Facultatif
RSTASP Numéro d'ASP de restauration 1-32, *SAVASP Facultatif
OUTPUT Sortie *NONE, *PRINT, *OUTFILE Facultatif
OUTFILE Fichier recevant la sortie Nom d'objet qualifié Facultatif
Qualificatif 1: Fichier recevant la sortie Nom
Qualificatif 2: Biblio Nom, *LIBL, *CURLIB
OUTMBR Options pour membre de sortie Liste d'éléments Facultatif
Élément 1: Membre recevant la sortie Nom, *FIRST
Élément 2: Remplacement ou ajout enregs *REPLACE, *ADD

Document ou dossier (DLO)

Indique les documents ou dossiers à restaurer.

Ce paramètre est obligatoire.

Valeurs uniques

*ALL
Les documents, dossiers et objets de distribution (courrier) sauvegardés sur un support et répondant aux critères spécifiés pour le paramètre SAVFLR (Dossier des objets sauvegardés) sont restaurés.
*MAIL
Tous les objets de distribution et les documents mentionnés dans un historique du courrier sont restaurés.
*SYSOBJNAM
Tous les documents dont le nom d'objet système est spécifié pour le paramètre SYSOBJNAM (Nom d'objet système) sont restaurés.

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

nom-document
Indiquez le nom attribué par l'utilisateur aux documents à restaurer. Tous les documents nommés doivent se trouver dans le dossier indiqué pour le paramètre SAVFLR.

Dossier des objets sauvegardés (SAVFLR)

Indique le nom du dossier figurant sur le support à partir duquel les documents ou les dossiers sont restaurés.

Valeurs uniques

*ANY
Tous les documents ou dossiers correspondant aux valeurs attribuées au paramètre DLO (Document ou dossier) sont restaurés, à partir de n'importe quel dossier (s'il y en a) utilisé pour la sauvegarde. Cette valeur n'est admise que si *ALL, *MAIL ou *SYSOBJNAM est indiqué pour le paramètre DLO.
*NONE
Tous les documents sauvegardés comme documents hors dossier sont restaurés. La valeur *NONE n'est admise que pour les documents, et seulement si *ALL est indiqué pour le paramètre DLO.

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

nom-dossier
Indiquez le nom du dossier sauvegardé à partir duquel les documents sont restaurés, ou le nom des dossiers à restaurer si *ALL est indiqué pour le paramètre DLO. Les noms de dossier peuvent comporter jusqu'à 63 caractères. Lorsque la valeur *ALL est attribuée au paramètre DLO, vous pouvez indiquer jusqu'à 300 noms de dossier. Lorsque DLO(nom-objet) est mentionné, le nom du dossier sauvegardé doit être indiqué.

Nouveau nom d'objet (RENAME)

Indique le nouveau nom attribué au document restauré.

Valeurs uniques

*SAME
Les documents sont restaurés sous le nom qu'ils portaient lors de leur sauvegarde.

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

nom-document
Indiquez le nouveau nom attribué par l'utilisateur aux documents restaurés. Si le paramètre DLO (Document ou dossier) est utilisé, vous pouvez préciser au maximum 300 noms pour les documents à restaurer.

Dossier de restauration (RSTFLR)

Indique le nom du dossier dans lequel seront stockés les dossiers ou documents à restaurer. Ce dossier doit exister sur le système, ou bien sur le support s'il s'agit d'un dossier sauvegardé et si vous avez attribué la valeur *ALL au paramètre DLO (Document ou dossier).

*SAME
Les documents ou dossiers à restaurer sont stockés dans le dossier à partir duquel ils ont été sauvegardés.
nom-dossier
Indiquez le nom du dossier dans lequel seront stockés les documents ou dossiers restaurés.

Unité (DEV)

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

Ce paramètre est obligatoire.

Valeurs uniques

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

Autres valeurs

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

Nom d'objet système (SYSOBJNAM)

Indique les noms d'objet système des documents à restaurer lorsque *SYSOBJNAM est indiqué pour le paramètre DLO (Document ou dossier).

Valeurs uniques

*NONE
Aucun nom d'objet système n'est indiqué.

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

nom-objet-système
Indiquez les noms d'objet système des documents à restaurer.

Identificateur de volume (VOL)

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

Valeurs uniques

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

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

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

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

Numéro de séquence (SEQNBR)

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

Remarque : Lors de la restauration d'objets de la bibliothèque de documents à partir de plusieurs pools de mémoire secondaire (ASP), un numéro de séquence de début et de fin doit être spécifié. Ces numéros étaient indiqués dans le message d'achèvement de la commande SAVDLO utilisée pour la création des fichiers bande. Vous pouvez également lancer la commande DSPTAP (Afficher contenu d'une bande) pour rechercher les numéros de séquence des fichiers QDOC et QDOCnnnn, où nnnn représente le numéro d'ASP.

Valeurs uniques

*SEARCH
Le premier fichier de données dont l'identificateur est identique à la valeur du paramètre LABEL (Label), et dont le contenu correspond à celui d'un ou de plusieurs des documents ou des dossiers indiqués, est recherché sur la bande. Si la dernière opération sur l'unité indiquait ENDOPT(*LEAVE) (signifiant que la bande est positionnée au point où s'est arrêtée la dernière opération), la recherche commence au premier fichier de données situé au-delà de ce point. Si ENDOPT(*LEAVE) n'était pas indiqué à la dernière opération (ou si la bande a été rembobinée depuis l'opération ENDOPT(*LEAVE)), la recherche commence au premier fichier de données sur le volume.

Elément 1: Numéro de séquence de début

1-16777215
Indiquez le numéro de séquence du premier fichier utilisé pour la restauration.

Elément 2: Numéro de séquence de fin

*ONLY
Le numéro de séquence de fin est identique au numéro de séquence de début.
1-16777215
Indiquez le numéro de séquence du dernier fichier utilisé pour la restauration.

Option de fin de support (ENDOPT)

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

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

*REWIND
A la fin de l'opération, la bande est rebobinée automatiquement, mais elle n'est pas déchargée.
*LEAVE
La bande n'est pas rembobinée ou déchargée à la fin de l'opération. Elle conserve sa position.
*UNLOAD
La bande est automatiquement rembobinée et déchargée à la fin de l'opération. Certaines unités optiques éjecteront le volume une fois l'opération terminée.

Label (LABEL)

Indique le label utilisé pour la recherche du fichier écrit sur le support lors de la sauvegarde.

*GEN
Le système génère le nom par défaut du label du fichier à rechercher.
valeur-alphanumérique
Indiquez le label du fichier contenant les documents ou dossiers à restaurer. Vous pouvez utiliser 17 caractères alphanumériques au maximum.

Fichier sauvegarde (SAVF)

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

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

Qualificatif 1 : Fichier sauvegarde

nom
Indiquez le nom du fichier sauvegarde à utiliser.

Qualificatif 2: Biblio

*LIBL
La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.
*CURLIB
Bibliothèque de l'unité d'exécution en cours utilisée pour localiser le fichier sauvegarde. S'il n'existe aucune entrée de bibliothèque en cours dans la liste des bibliothèques, la bibliothèque QGPL est utilisée.
nom
Indiquez le nom de la bibliothèque dans laquelle le fichier sauvegarde est situé.

Fichier optique (OPTFILE)

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

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

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

Génération nom d'objet (NEWOBJ)

Indique si un nouveau nom attribué par la bibliothèque, et un nom d'objet système sont générés pour les documents ou dossiers qui sont restaurés.

*SAME
Le nom attribué par la bibliothèque et le nom d'objet système ne sont pas modifiés.
*NEW
Un nouveau nom attribué par la bibliothèque et un nom d'objet système sont générés pour chaque document ou dossier restauré.

Date de sauvegarde (SAVDATE)

Indique la date à laquelle les documents ou dossiers ont été sauvegardés. S'il existe plusieurs versions d'un même objet sur la disquette ou la bande, cette date permet de savoir quelle version de l'objet doit être restaurée. La date doit être exprimée au format de date du travail. Si des séparateurs sont utilisés, la valeur doit être placée entre apostrophes. En l'absence du paramètre SAVDATE, les documents et les dossiers seront restaurés sous la première version rencontrée sur le volume, ou encore sous la première version portant le label de fichier indiqué.

Heure de sauvegarde (SAVTIME)

Indique l'heure à laquelle les documents ou dossiers ont été sauvegardés. Si plusieurs versions d'un même objet existent sur la bande ou sur la disquette avec la même date de sauvegarde, ce paramètre permet d'identifier la version de l'objet à restaurer. L'heure doit être exprimée par une valeur de 6 chiffres, en heures, minutes et secondes (hhmmss). Si des signes deux-points servent de séparateurs, la valeur doit être placée entre apostrophes ('hh:mm:ss'). Lorsqu'un identificateur de volume est indiqué en l'absence du paramètre SAVTIME (Heure de sauvegarde), les documents et les dossiers seront restaurés sous la première version rencontrée sur le volume, ou encore sous la première version portant le label de fichier indiqué.

Ce paramètre est admis uniquement lorsque le paramètre SAVDATE (Date de sauvegarde) est précisé.

Admettre différences d'objet (ALWOBJDIF)

Indique si les différences suivantes rencontrées au cours de la restauration sont admises :

  • Propriété : le propriétaire de l'objet existant sur le système est différent du propriétaire de l'objet provenant de la sauvegarde.
  • Nom d'objet système : le nom d'objet système existant sur le système ne correspond pas au nom d'objet système figurant sur le support.
  • Liaison de liste d'autorisation : l'objet est restauré sur un système différent de celui sur lequel il a été sauvegardé.

Le paramètre ALWOBJDIF peut être utilisé pour permettre la restauration d'un objet dont le propriétaire ou le nom d'objet sur le système est différent de celui se trouvant sur la disquette ou la bande utilisée pour l'opération de restauration. Si vous indiquez la valeur spéciale *ALL, tout objet portant un nom différent est restauré sous le nom qu'il porte sur la bande ou la disquette, alors que tout objet dont le propriétaire est différent conserve le nom de propriétaire figurant sur le système et non celui se trouvant sur la disquette ou la bande.

Remarque :Pour utiliser ce paramètre, vous devez disposer du droit sur tous les objets (*ALLOBJ).

*NONE
Aucune des différences décrites ci-dessus n'est admise lors de la restauration. Dans le cas d'une différence de liste d'autorisation, l'objet est restauré mais il n'est pas lié à la liste d'autorisation, et le droit public prend la valeur *EXCLUDE. Dans tous les autres cas, un message de diagnostic est envoyé sur l'objet, et ce dernier n'est pas restauré.
*ALL
Toutes les différences décrites ci-dessus sont admises lors de la restauration. Un message d'information est envoyé et l'objet est restauré.

Remarques :

  • Si les propriétaires de l'objet ne concordent pas, l'objet est restauré, mais il conserve la propriété et les droits qui lui étaient associés sur le système avant la restauration.
  • Si *ALL est indiqué à ce paramètre, *NEW ne peut être précisé pour le paramètre NEWOBJ (Génération nom d'objet).
  • Lorsque des objets sont restaurés sur un système différent de celui sur lequel ils ont été sauvegardés et qu'ils sont protégés par une liste d'autorisation, la mention de la valeur *ALL relie automatiquement les objets à la liste d'autorisation. Si cette dernière n'existe pas sur le nouveau système, un message comprenant le nom de la liste manquante est émis.

Numéro d'ASP de sauvegarde (SAVASP)

Indique le numéro du pool de mémoire secondaire (ASP) des supports à partir desquels les documents et les dossiers sauvegardés doivent être restaurés.

*ANY
Les documents et les dossiers sauvegardés dans tout ASP sont restaurés.

Remarque : Lorsque la restauration d'objets de la bibliothèque de documents (objets DLO) est lancée à partir de plusieurs ASP, le paramètre du numéro de séquence (SEQNBR) doit être indiqué.

1-32
Indiquez le numéro de l'ASP à partir duquel des documents et des dossiers sont restaurés.

Numéro d'ASP de restauration (RSTASP)

Indique le numéro du pool de mémoire secondaire (ASP) des supports dans lesquels les documents et les dossiers restaurés doivent être placés.

*SAVASP
Les documents et les dossiers sont placés dans le même ASP que celui à partir duquel ils ont été sauvegardés.
1-32
Indiquez le numéro de l'ASP dans lequel les documents et les dossiers restaurés sont placé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é.

Fichier recevant la sortie (OUTFILE)

Précise le nom qualifié du fichier base de données vers lequel les informations sur l'objet sont dirigées lorsque la valeur *OUTFILE est attribuée au paramètre OUTPUT (Sortie). Si ce fichier n'existe pas, cette commande crée un fichier base de données dans la bibliothèque indiquée. Si un nouveau fichier est créé, le système utilise le fichier modèle QAOJRSTO de QSYS avec le nom de format QOJRST.

Qualificateur 1: Fichier recevant la sortie

nom
Indiquez le nom du fichier base de données devant recevoir la sortie de la commande. Si ce fichier n'existe pas, il est créé dans la bibliothèque indiquée.

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. Si aucune bibliothèque n'est indiquée comme bibliothèque en cours, la bibliothèque QGPL est utilisée.
nom
Indiquez le nom de la bibliothèque dans laquelle doit s'effectuer la recherche.

Options pour membre de sortie (OUTMBR)

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

Elément 1 : Membre recevant la sortie

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

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

Elément 2 : Remplacement ou ajout enregs

*REPLACE
Les enregistrements existant dans le membre du fichier base de données indiqué sont remplacés par les nouveaux enregistrements.
*ADD
Les nouveaux enregistrements sont ajoutés aux données existant déjà dans le membre de fichier base de données indiqué.

Exemples

Exemple 1 : Restauration de documents avec des noms d'objet système

RSTDLO   DLO(*SYSOBJNAM)  DEV(TAP01)  SYSOBJNAM(HZ83B55219)

Cette commande restaure le document nommé HZ83B55219 à partir de l'unité de bande AP01.

Exemple 2 : Restauration des documents à partir d'un dossier de sauvegarde

RSTDLO   DLO(A)  DEV(TAP01)  SAVFLR(X)

Cette commande restaure le document nommé A à partir du dossier X.

Exemple 3 : Restauration de tous les documents

RSTDLO   DLO(*ALL)  DEV(TAP01)

Cette commande restaure tous les documents et dossiers qui se trouvent sur le premier fichier de bande de l'unité TAP01.

Exemple 4 : Restauration d'un dossier sauvegardé à partir de l'ASP système vers un ASP utilisateur

RSTDLO   DLO(*ALL)  FLR(Y)  SAVASP(1)  RSTASP(2)

Cette commande restaure le dossier Y qui a été sauvegardé à partir de l'ASP 1, vers l'utilisateur ASP 2. Le dossier Y doit être supprimé de l'ASP 1 avant de le restaurer vers l'ASP 2.

Exemple 5 : Création d'un nouveau nom affecté par la bibliothèque

RSTDLO   DLO(*SYSOBJNAM)  DEV(TAP01)  SYSOBJNAM(HZ83B55219)
         NEWOBJ(*NEW)

Cette commande restaure le document HZ83B55219 de l'unité de bande TAP01 et lui attribue un nouveau nom affecté par la bibliothèque et un nouveau nom d'objet système.

Exemple 6 : Changement de nom des documents

RSTDLO   DLO(A B)  DEV(TAP01)  SAVFLR(C)
         RENAME(Y Z)  RSTFLR(X)

Cette commande restaure les documents A et B à partir du dossier C. Le document A est renommé en Y et le document B est renommé en Z. La commande les place ensuite dans le dossier X.

Exemple 7 : Spécification des numéros de séquence

RSTDLO   DLO(*ALL)  DEV(tape-device-name)  SAVFLR(A)
         SEQNBR(1 3)  LABEL(*GEN)

Cette commande restaure tout le dossier A à partir des fichiers de la bande avec les numéros de séquence 1, 2 et 3, et le label QDOC ou QDOCxxxx.

Exemple 8 : Spécification des différences autorisées

RSTDLO   DLO(A)  DEV(TAP01)  SAVFLR(X)  ALWOBJDIF(*ALL)

Cette commande restaure le document A à partir du dossier X. Si le document A du dossier X existe dans le système et que son propriétaire ne correspond pas à celui du document en cours de restauration, le document est restauré et son propriétaire sur le système reste inchangé.

Exemple 9 : Rapport d'informations concernant les objets restaurés et non restaurés

RSTDLO   DLO(*ALL)  DEV(TAP01)  OUTPUT(*OUTFILE)
         OUTFILE(INFO92)  OUTMBR(FOURQT *ADD)

Cette commande restaure tous les documents et dossier de l'unité de bande TAP01. Une liste d'informations concernant les objets restaurés et non restaurés est dirigée vers le fichier de sortie INFO92. La sortie est reçue dans le membre FOURQT en plus des informations qu'il contient déjà.

Messages d'erreur

Messages *ESCAPE

CPF370C
Non autorisé au paramètre ALWOBJDIF.
CPF3718
Commande de restauration incompatible avec fichier &1.
CPF3728
Unité &1 indiquée avec d'autres unités.
CPF3767
Unité &1 non trouvée.
CPF3780
Fichier indiqué pour bibliothèque &1 non trouvé.
CPF3782
Le fichier &1 de &2 n'est pas un fichier sauvegarde.
CPF381B
Aucun document ou dossier restauré dans l'ASP &1.
CPF3812
Fichier sauvegarde &1 de &2 en cours d'utilisation.
CPF384D
Opération de sauvegarde ou restauration non admise sur l'ASP &1.
CPF8AB5
L'ASP &5 n'est pas configuré.
CPF8A47
Objets internes du système en cours d'utilisation.
CPF90AF
Valeur RSTFLR non admise.
CPF90A4
Valeur RENAME non admise.
CPF90B4
&1 dossier(s) restauré(s) dans le système; &2 non restauré(s).
CPF90CD
Restauration de distributions non autorisée.
CPF90CF
La base de données d'index de recherche est endommagée.
CPF90E0
Droits insuffisants pour ALWOBJDIF(*ALL).
CPF90E7
Documents ou dossiers non restaurés.
CPF9003
&1 documents ou dossiers restaurés. &10 non restaurés.
CPF905C
Erreur lors de la recherche d'une table de conversion.
CPF9050
Dernier numéro de séquence incorrect.
CPF9069
Vous n'êtes pas autorisé à restaurer des objets dans le dossier &1.
CPF908A
Le demandeur &1 n'est pas inscrit.
CPF909B
&1 documents ou dossiers restaurés. &10 non restaurés.
CPF9412
Liste de noms de dossiers non admise avec paramètre DLO.
CPF9810
Bibliothèque &1 non trouvée.
CPF9812
Fichier &1 non trouvé dans la bibliothèque &2.
CPF9820
Non autorisé à utiliser la bibliothèque &1.
CPF9822
Non autorisé au fichier &1 de &2.
CPF9825
Accès non autorisé à l'unité &1.
CPF9830
Allocation de la bibliothèque &1 impossible.
CPF9831
Allocation de l'unité &1 impossible.
CPF9845
Erreur lors de l'ouverture du fichier &1.
CPF9846
Erreur lors du traitement du fichier &1 de &2.
CPF9850
Substitution non admise pour fichier imprimante &1.
CPF9851
Valeur de ligne fin de page trop faible pour fichier &1 dans &2.
CPF9860
Erreur lors du traitement du fichier de sortie.
CPF9899
Erreur lors du traitement de la commande.
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é.

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