RSTDFROBJ
Restaurer objets différés
En bref
La commande RSTDROBJ effectue la restauration et les demandes de démarrage de journalisation des objets mis en différé, si les objets dont ils dépendent sont maintenant disponibles.
RSTDFROBJ se lit RST
(Restaurer) + DFROBJ.
Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.
Syntaxe minimale
RSTDFROBJ DFRID(…)
Paramètres
-
DFRIDID mise en différé obligatoire -
OUTPUTSortie -
OUTFILEFichier recevant la sortie -
OUTMBROptions pour membre de sortie -
INFTYPEType d'informations en sortie
Astuce : dans une session 5250, tapez RSTDFROBJ 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 RSTDROBJ effectue la restauration et les demandes de démarrage de journalisation des objets mis en différé, si les objets dont ils dépendent sont maintenant disponibles.
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.
Restrictions :
- Vous devez disposer du droit spécial *SAVSYS pour exécuter cette commande.
Paramètres
| Mot-clé | Description | Valeurs possibles | Remarques |
|---|---|---|---|
| DFRID | ID mise en différé | Nom | Obligatoire, positionnel 1 |
| 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 | ||
| INFTYPE | Type d'informations en sortie | *OBJ, *MBR | Facultatif |
ID mise en différé (DFRID)
Indique le nom utilisé pour le paramètre ID mise en différé (DFRID) lors des opérations de restauration.
Ce paramètre est obligatoire.
- nom
- Indiquez le nom utilisé pour le paramètre ID mise en différé (DFRID) lors des opérations de restauration.
Sortie (OUTPUT)
Indique si une liste d'informations relatives aux objets restaurées est créée. Les informations peuvent être imprimées avec la sortie spoule de travail ou dirigées vers un fichier de base de données.
- *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 indiquer un nom de fichier de base de données pour le paramètre Fichier recevant la sortie (OUTFILE) lorsque OUTPUT(*OUTFILE) est indiqué.
Fichier recevant la sortie (OUTFILE)
Indique le fichier de base de données vers lequel la sortie générée par la commande est dirigée. Si ce fichier n'existe pas, la commande en crée un dans la bibliothèque précisée. S'il existe déjà, les droits publics sur le fichier sont les mêmes que le droit de création de la pour la bibliothèque contenant le fichier. Pour afficher ce droit, utilisez la commande DSPLIBD (Afficher une description de bibliothèque).
Qualificatif 1 : Fichier recevant la sortie
- nom
- Indiquez le nom du fichier de base de données vers lequel la sortie générée de la commande est dirigée.
Qualificateur 2: Biblio
- *LIBL
- Le fichier est recherché dans la liste des bibliothèques. Si le système ne le trouve pas, il en crée un dans la bibliothèque en cours. S'il n'existe pas de bibliothèque en cours, le fichier est créé dans la bibliothèque QGPL.
- *CURLIB
- Bibliothèque de l'unité d'exécution en cours utilisée pour localiser le fichier. Si cette bibliothèque n'est pas indiquée, QGPL est utilisée par défaut.
- nom
- Indiquez le nom de la bibliothèque dans laquelle doit s'effectuer la recherche.
Remarque :Si un fichier est créé, le système utilise le fichier fourni par IBM, QASRRSTO, avec le nom de format QSRRST comme modèle.
Options pour membre de sortie (OUTMBR)
Indique le nom du membre de fichier de base données vers lequel est dirigé la sortie lorsque *OUTFILE est précisé à l'invite Sortie (paramètre OUTPUT).
Elément 1 : Membre recevant la sortie
- *FIRST
- Le premier membre du fichier reçoit la sortie. Si OUTMBR(*FIRST) est indiqué et que le membre n'existe pas, le système en crée un du nom indiqué à l'invite Fichier recevant la sortie (paramètre OUTFILE).
- nom
- Indiquez le nom du membre de fichier destiné à recevoir la sortie. Si ce membre n'existe pas, il est créé par le système.
Si le membre existe, vous pouvez ajouter des enregistrements à la fin du membre existant ou le mettre à blanc, puis ajouter les enregistrements.
Elément 2 : Remplacement ou ajout enregs
- *REPLACE
- Les enregistrements existant dans le membre du fichier base de données indiqué sont remplacés par les nouveaux enregistrements.
- *ADD
- Les nouveaux enregistrements sont ajoutés aux données existant déjà dans le membre de fichier base de données indiqué.
Type d'informations en sortie (INFTYPE)
Indique le type d'informations imprimées ou acheminées vers le fichier base de données.
- *OBJ
- La liste contient un poste pour chaque objet à restaurer.
- *MBR
- La liste contient un poste pour chaque objet, membre de fichier base de données et fichier spoule à restaurer.
Exemples
RSTLIB SAVLIB(DTALIB) DEV(TAP01) ENDOPT(*LEAVE) DFRID(ABC) RSTLIB SAVLIB(JRNLIB) DEV(TAP01) ENDOPT(*LEAVE) DFRID(ABC) RSTLIB SAVLIB(LFLIB) DEV(TAP01) ENDOPT(*LEAVE) DFRID(ABC) RSTLIB SAVLIB(PFLIB) DEV(TAP01) ENDOPT(*LEAVE) DFRID(ABC) RSTDFROBJ DFRID(ABC)
Cet exemple illustre les bibliothèques qui sont restaurées par ordre alphabétique. La bibliothèque DTALIB contient les objets qui utilisaient des journaux de JRNLIB lors de leur sauvegarde. La bibliothèque LFLIB contient les fichiers logiques qui possèdent des fichiers sous-jacents dans la bibliothèque PFLIB. Etant donné qu'un paramètre DFRID est spécifié, les demandes de démarrage de journalisation des objets contenus dans DTALIB et des fichiers logiques contenus dans LFLIB sont mises en différé. La commande RSTDFROBJ permet de démarrer la journalisation des objets contenus dans DTALIB et de terminer la restauration des fichiers logiques contenus dans LFLIB. Si un paramètre DFRID n'était pas spécifié, vous devriez démarrer la journalisation de chaque objet contenu dans DTALIB et vous devriez relancer la restauration des fichiers logiques contenus dans LFLIB.
Messages d'erreur
Messages *ESCAPE
© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.