Aller au contenu

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

  • DFRID ID mise en différé obligatoire
  • OUTPUT Sortie
  • OUTFILE Fichier recevant la sortie
  • OUTMBR Options pour membre de sortie
  • INFTYPE Type 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.
*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 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

CPF222E
Le droit spécial &1 est requis.
CPF32C7
Fichier mis en différé non restauré.
CPF37C1
&2 objets terminés. &3 objets différés.

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