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
-
DLODocument ou dossier obligatoire -
SAVFLRDossier des objets sauvegardés -
RENAMENouveau nom d'objet -
RSTFLRDossier de restauration -
DEVUnité obligatoire -
SYSOBJNAMNom d'objet système -
VOLIdentificateur de volume -
SEQNBRNuméro de séquence -
ENDOPTOption de fin de support -
LABELLabel -
SAVFFichier sauvegarde -
OPTFILEFichier optique -
NEWOBJGénération nom d'objet -
SAVDATEDate de sauvegarde -
SAVTIMEHeure de sauvegarde -
ALWOBJDIFAdmettre différences d'objet -
SAVASPNuméro d'ASP de sauvegarde -
RSTASPNuméro d'ASP de restauration -
OUTPUTSortie -
OUTFILEFichier recevant la sortie -
OUTMBROptions 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.
- 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.
- 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.