RSTUSRPRF
Restaurer profils utilisateur
En bref
La commande RSTUSRPRF permet de restaurer les éléments de base d'un profil ou d'un groupe de profils utilisateur sauvegardés à l'aide de la commande SAVSYS (Sauvegarder le système) ou SAVSECDTA (Sauvegarder les données de sécurité).
RSTUSRPRF se lit RST
(Restaurer) + USRPRF.
Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.
Syntaxe minimale
RSTUSRPRF DEV(…)
Paramètres
-
DEVUnité obligatoire -
USRPRFProfil utilisateur -
VOLIdentificateur de volume -
SEQNBRNuméro de séquence -
ENDOPTOption de fin de support -
SAVFFichier sauvegarde -
MAILCourrier -
ALWOBJDIFAdmettre différences d'objet -
OMITUSRPRFProfils utilisateur à omettre -
SECDTADonnées de sécurité -
OMITSECDTAOmettre données de sécurité -
OUTPUTSortie -
OPTFILEFichier optique -
SAVASPDEVUnité ASP de sauvegarde -
OUTFILEFichier recevant la sortie -
OUTMBROptions pour membre de sortie
Astuce : dans une session 5250, tapez RSTUSRPRF 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 RSTUSRPRF permet de restaurer les éléments de base d'un profil ou d'un groupe de profils utilisateur sauvegardés à l'aide de la commande SAVSYS (Sauvegarder le système) ou SAVSECDTA (Sauvegarder les données de sécurité). Les droits spéciaux accordés à l'aide de la commande CRTUSRPRF (Créer un profil utilisateur) sont restaurés, tandis que les droits sur les objets qui appartiennent à d'autres utilisateurs ne le sont pas. Pour qu'ils le soient, restaurez d'abord les profils utilisateur, les bibliothèques et les objets, puis utilisez la commande RSTAUT (Restaurer les droits). La restauration de tous les profils utilisateur entraîne celle des listes d'autorisation et des dépositaires de droits qui existaient lors de l'exécution de la commande SAVSYS ou SAVSECDTA.
Si vous indiquez USRPRF(*ALL), toutes les autres opérations exécutées sur le système doivent être arrêtées. Vous devez arrêter tous les sous-systèmes à l'aide de la commande ENDSBS(*ALL) (Arrêter un sous-système), ou ENDSYS (Arrêter le système) ou en indiquant cette commande au démarrage du système d'exploitation. La commande RSTUSRPRF est normalement exécutée entre la restauration du système d'exploitation et celle des bibliothèques utilisateur. Les profils utilisateur doivent être restaurés avant toute bibliothèque ou objet leur appartenant. Après la restauration des bibliothèques et de leurs objets, les droits sur les objets sont restaurés pour les profils utilisateur à l'aide de la commande RSTAUT. Une fois celle-ci exécutée, le message CPF3775 ou CPC3705 est envoyé à QHST. Pour de plus amples informations sur la restauration du système, reportez-vous au manuel Reprise du système, SC41-5304.
Les situations suivantes peuvent s'appliquer aux profils utilisateur à restaurer par la commande RSTUSRPRF :
- Si un profil utilisateur existe sur le système mais pas sur le support, il est conservé.
- Si un profil utilisateur existe sur le support mais pas sur le système, un nouveau profil est créé.
- Si le profil utilisateur existe sur le support et sur le système, le profil utilisateur figurant sur le support est restauré.
- Si le profil utilisateur existant sur le support est restauré individuellement, le nouveau profil est créé sans son mot de passe ou sa relation de groupe.
- Si le profil utilisateur existe sur le support et sur le système et qu'il est restauré individuellement, le profil utilisateur du support est restauré. Cependant, le mot de passe et la relation de groupe associés sur le système demeurent inchangés.
- Si tous les profils utilisateurs sont restaurés, les mots de passe et les relations de groupe sont également restaurés à partir du support.
- Si des profils utilisateur existent sur le système, aucune modification n'est apportée aux droits sur les objets existants.
Remarque :Cette commande ignore toutes les substitutions de fichier en cours pour ce travail, à l'exception du fichier de sortie.
Restrictions :
- Vous devez disposer du droit spécial *SAVSYS pour exécuter cette commande.
- Cette commande n'est pas fournie avec le droit public *EXCLUDE.
- Si vous indiquez USRPRF(*ALL), toutes les autres opérations exécutées sur le système doivent être arrêtées. Les commandes ENDSYS (Arrêter un système) et ENDSBS (Arrêter un sous-système) permettent de terminer ces opérations. Vous devez disposer du droit spécial d'exploitation des travaux (*JOBCTL) pour utiliser les commandes ENDSYS et ENDSBS.
- Vous devez indiquer USRPRF(*ALL) ou USRPRF(*NEW) pour restaurer les listes d'autorisation et les dépositaires de droits.
Paramètres
| Mot-clé | Description | Valeurs possibles | Remarques |
|---|---|---|---|
| DEV | Unité | Valeurs uniques: *SAVF Autres valeurs (jusqu'à 4 répétitions): Nom |
Obligatoire, positionnel 1 |
| USRPRF | Profil utilisateur | Valeurs uniques: *ALL, *NEW, *NONE Autres valeurs (jusqu'à 300 répétitions): Nom générique, nom |
Facultatif, positionnel 2 |
| VOL | Identificateur de volume | Valeurs uniques: *MOUNTED Autres valeurs (jusqu'à 75 répétitions): Valeur caractère |
Facultatif, positionnel 3 |
| SEQNBR | Numéro de séquence | 1-16777215, *SEARCH | Facultatif |
| ENDOPT | Option de fin de support | *REWIND, *LEAVE, *UNLOAD | Facultatif |
| SAVF | Fichier sauvegarde | Nom d'objet qualifié | Facultatif |
| Qualificatif 1: Fichier sauvegarde | Nom | ||
| Qualificatif 2: Biblio | Nom, *LIBL, *CURLIB | ||
| Courrier | *NO, *YES | Facultatif | |
| ALWOBJDIF | Admettre différences d'objet | Valeurs uniques: *NONE, *ALL Autres valeurs (jusqu'à 3 répétitions): *AUTL, *OWNER, *PGP |
Facultatif |
| OMITUSRPRF | Profils utilisateur à omettre | Valeurs uniques: *NONE Autres valeurs (jusqu'à 300 répétitions): Nom générique, nom |
Facultatif |
| SECDTA | Données de sécurité | *USRPRF, *PVTAUT, *PWDGRP, *DCM | Facultatif |
| OMITSECDTA | Omettre données de sécurité | Valeurs uniques: *NONE Autres valeurs (jusqu'à 3 répétitions): *AUTL, *DCM, *FCNUSG |
Facultatif |
| OUTPUT | Sortie | *NONE, *OUTFILE | Facultatif |
| OPTFILE | Fichier optique | Chemin d'accès, * | Facultatif |
| SAVASPDEV | Unité ASP de sauvegarde | Nom, *ANY, *, *SYSBAS, *CURASPGRP | 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 |
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.
Profil utilisateur (USRPRF)
Indique les profils utilisateur à restaurer. Les profils utilisateur doivent exister sur le support utilisé pour la commande SAVSYS (Sauvegarder le système) ou SAVSECDTA (Sauvegarder les données de sécurité) afin d'être restaurés.
Valeurs uniques
- *ALL
- L'ensemble des profils utilisateur, des listes d'autorisations, des dépositaires de droits et des objets de droit internes sauvegardés par la commande SAVSYS (Sauvegarder le système) ou SAVSECDTA (Sauvegarder les données de sécurité) sont restaurés.
- *NEW
- L'ensemble des profils utilisateur, des listes d'autorisation et des dépositaires de droits sauvegardés à l'aide de la commande SAVSYS (Sauvegarder le système) ou de la commande SAVSECDTA (Sauvegarder les données de sécurité) sont restaurés.
- *NONE
- Aucun profil utilisateur n'est restauré. Cette valeur ne peut être indiquée que si *DCM est spécifié pour le paramètre Données de sécurité (SECDTA).
Autres valeurs (jusqu'à 300 répétitions)
- nom-générique
- Indiquez un ou plusieurs noms génériques de profils utilisateur à restaurer. 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 profil utilisateur.
- nom
- Indiquez un ou plusieurs noms spécifiques de profils utilisateur. Une commande peut comporter à la fois des noms génériques et spécifiques.
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 du fichier bande utilisé pour la restauration.
- *SEARCH
- Le fichier qui contient les profils utilisateur sauvegardés est recherché dans le volume placé sur l'unité. Les profils utilisateur sont restaurés lorsque ce fichier est trouvé. Si aucune concordance n'est trouvée, vous devez charger une autre bande et relancer la commande.
Si *LEAVE a été indiqué pour le paramètre ENDOPT (Option de fin de support), ce qui indique que la bande est restée positionnée à l'emplacement où la dernière opération s'est terminée, la recherche s'effectue à partir du premier fichier situé après cette position. En revanche, si *LEAVE n'a pas été indiqué pour le paramètre ENDOPT de la dernière opération, ou si la bande a été rembobinée manuellement après l'opération, la recherche commence sur le premier fichier de données du volume.
- 1-16777215
- Indiquez le numéro de séquence du fichier utilisé pour la restauration des profils utilisateur.
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é.
Courrier (MAIL)
Indique si les boîtes aux lettres d'OfficeVision sauvegardées à partir d'une édition antérieure à la V2R2M0 sont restaurées.
Remarque :Vous ne pouvez indiquer *YES que si vous mentionnez *ALL pour le paramètre USRPRF (Profil utilisateur).
- *NO
- Les boîtes aux lettres constituant votre courrier ne sont pas restaurées lors de la restauration du profil utilisateur.
- *YES
- Les boîtes aux lettres constituant votre courrier sont restaurées lors de la restauration du profil utilisateur si les données de sauvegarde ont été créées sous une édition antérieure à la V2R2M0. Sinon, aucune boîte aux lettres n'est restaurée. Pour les objets de distribution sauvegardés créés sous la V2R2M0 ou une version ultérieure, indiquez DLO(*MAIL) dans la commande RSTDLO pour restaurer votre courrier.
Admettre différences d'objet (ALWOBJDIF)
Indique si des différences sont admises entre les objets sauvegardés et les objets restaurés.
Remarques :
- Vous devez disposer du droit spécial *ALLOBJ pour pouvoir indiquer une valeur autre que *NONE pour ce paramètre.
- 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.
- 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.
- *ALL
- 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.
Autres valeurs (jusqu'à 3 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.
- *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é.
-
Remarque :La valeur *PGP ne s'applique pas aux profils utilisateur. Les profils utilisateur présentant des différences entre les groupes principaux sont toujours restaurés.
Profils utilisateur à omettre (OMITUSRPRF)
Indique les profils utilisateur à omettre lors de la sauvegarde.
Valeurs uniques
- *NONE
- Aucun profil utilisateur n'est ignoré lors de la sauvegarde.
Autres valeurs (jusqu'à 300 répétitions)
- nom-générique
- Indiquez un ou plusieurs noms génériques d'ensembles de profils utilisateur à ignorer lors de la sauvegarde. Un nom générique est composé d'un ou de plusieurs caractères suivis d'un astérisque (*). L'astérisque (*) remplace tout caractère admis. Un nom générique indique tous les profils utilisateur commençant par le préfixe. Si le nom générique (préfixe) ne comprend pas d'astérisque, le système considère qu'il s'agit du nom d'objet complet.
- nom
- Indiquez un ou plusieurs noms de profils utilisateur spécifiques. Une commande peut comporter à la fois des noms génériques et spécifiques.
Données de sécurité (SECDTA)
Indique les informations de droit restaurées pour les profils utilisateur indiqués pour le paramètre Profil utilisateur (USRPRF).
- *USRPRF
- Les profils utilisateur indiqués et leurs droits privés sont restaurés. Si *ALL est indiqué pour le paramètre USRPRF, les mots de passe et les liaisons de groupe sont également restaurés. Autrement, les mots de passe et les liaisons de groupe pour les profils utilisateur indiqués ne sont pas restaurés.
- *PVTAUT
- Seuls les droits privés des profils utilisateur spécifiés et les pools de mémoire secondaire sont restaurés. La commande RSTAUT (Restaurer les droits) utilise les informations pour restaurer les droits privés accordés aux objets référencés. Cette valeur ne peut pas être indiquée si *NEW est indiqué pour le paramètre USRPRF.
- *PWDGRP
- Les profils utilisateur indiqués, leurs droits privés, ainsi que leurs mots de passe et leurs liaisons de groupe sont restaurés.
- *DCM
- Seuls les objets internes, nécessaires au gestionnaire de certificats numériques (DCM) sont restaurés. Aucun profil utilisateur n'est restauré. Si cette valeur est indiquée, *NONE doit être indiquée pour le paramètre USRPRF.
Omettre données de sécurité (OMITSECDTA)
Indique les informations sur les droits à omettre à partir de l'opération de restauration lorsque *ALL est indiquée pour le paramètre Profil utilisateur (USRPRF).
Valeurs uniques
- *NONE
- Aucune information de sécurité n'est omise.
Autres valeurs (jusqu'à 3 répétitions)
- *AUTL
- Les objets *AUTL (Liste d'autorisations) et *AUTHLR (Dépositaire de droits) sont omis. En revanche, pour l'un de ces objets existe déjà sur le système, les droits utilisateur spécifiques sont restaurés. Vous devez exécuter la commande RSTAUT (Restaurer les droits) pour effectuer la restauration de ces droits.
- *DCM
- Les objets internes requis par DCM (Gestionnaire de certificats numériques) sont omis.
- *FCNUSG
- Aucune information d'utilisation de fonction n'est omise. En revanche, pour les identificateurs de fonction qui existent déjà sur le système, les paramètres utilisateur spécifiques sont restaurés. Vous devez exécuter la commande RSTAUT (Restaurer les droits) pour effectuer la restauration de ces paramètres.
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.
- *OUTFILE
- La sortie est envoyée dans le fichier base de données indiqué pour le paramètre OUTFILE (Fichier recevant la sortie).
Remarque :Lorsque la valeur *OUTFILE est attribuée à ce paramètre, vous devez obligatoirement préciser un nom de fichier base de données.
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.
Unité ASP de sauvegarde (SAVASPDEV)
Indique le nom de l'unité ASP (pool de mémoire secondaire) d'où les informations des droits privés ont été sauvegardées. Ces dernières sont restaurées, pour utilisation ultérieure, par la fonction RSTAUT (Restaurer les droits).
- *ANY
- Restauration des informations des droits sauvegardées à partir de tous les ASP inclus dans l'opération de sauvegarde.
- *
- Restauration des informations des droits privés sauvegardées à partir de l'ASP système (ASP numéro 1), de tous les ASP utilisateur de base (ASP numéros 2 à 32) et, si l'unité d'exécution a un groupe ASP, de tous les ASP indépendants de ce groupe ASP.
- *SYSBAS
- Restauration des informations des droits privés sauvegardées à partir de l'ASP système et de tous les ASP utilisateur de base.
- *CURASPGRP
- Restauration des informations des droits privés sauvegardées à partir de tous les ASP indépendants du groupe ASP, si l'unité d'exécution a un groupe ASP.
- nom
- Indique le nom de l'unité ASP à partir de laquelle les informations des droits privés ont été sauvegardées.
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é.
Exemples
Exemple 1 : Restauration de tous les profils
RSTUSRPRF DEV(TAP01) SEQNBR(*SEARCH) ENDOPT(*REWIND)
Cette commande restaure sur le système tous les profils utilisateur contenus sur la bande se trouvant actuellement dans l'unité de bande TAP01. Le fichier est recherché sur la bande et celle-ci est rembobinée lorsqu'elle est terminée ou à la fin de la restauration.
Exemple 2 : Restauration de certains profils utilisateur
RSTUSRPRF DEV(TAP01) USRPRF(USRA USRB USRC USER*)
Cette commande restaure les profils utilisateur USRA, USRB et USRC, ainsi que les profils utilisateur dont les noms commencent par USER. La version sauvegardée de tous les profils utilisateur doit exister sur la bande placée dans l'unité de bande TAP01.
Exemple 3 : Restauration de profils utilisateur à partir d'un fichier sauvegarde
RSTUSRPRF DEV(*SAVF) USRPRF(USRX USRY) SAVF(QGPL/SAVESEC)
Cette commande restaure les profils utilisateur USRX et USRY sur le système à partir du fichier sauvegarde SAVESEC de la bibliothèque QGPL.
Exemple 4 : Génération d'états concernant les profils utilisateur restaurés et non restaurés
RSTUSRPRF DEV(TAP01) USRPRF(*ALL) OUTPUT(*OUTFILE)
OUTFILE(PRFS92) OUTMBR(FOURQT *ADD)
Cette commande restaure tous les profils utilisateurs à partir de l'unité de bande TAP01. Une liste contenant des informations concernant les profils utilisateur restaurés et non restaurés est dirigée vers le fichier de sortie PRFS92. La sortie est ajoutée aux informations du membre FOURQT.
Messages d'erreur
Messages *ESCAPE
- CPD3774
- USRPRF(*ALL) est obligatoire si MAIL(*YES) est indiqué.
- CPF2206
- Droit d'usage obligatoire pour exécuter la fonction demandée sur l'objet.
- CPF222E
- Le droit spécial &1 est requis.
- CPF370C
- Non autorisé au paramètre ALWOBJDIF.
- 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.
- CPF3733
- &2 &1 de &3 endommagé précédemment.
- CPF3738
- L'unité &1 utilisée pour la sauvegarde/restauration est endommagée.
- CPF3743
- Restauration, affichage ou listage du fichier impossible.
- CPF3748
- Informations sur l'objet endommagées pour la bibliothèque &1.
- CPF376B
- Fichier &1 introuvable.
- CPF3767
- Unité &1 non trouvée.
- CPF3768
- Unité &1 incorrecte pour la commande indiquée.
- CPF3775
- Les profils utilisateur ou objets de droits n'ont pas tous été restaurés.
- CPF3780
- Fichier indiqué pour bibliothèque &1 non trouvé.
- CPF3782
- Le fichier &1 de &2 n'est pas un fichier sauvegarde.
- CPF3785
- Tous les sous-systèmes ne sont pas arrêtés.
- 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.
- CPF380C
- Bibliothèque &1 non restaurée.
- CPF3812
- Fichier sauvegarde &1 de &2 en cours d'utilisation.
- CPF908A
- Le demandeur &1 n'est pas inscrit.
- CPF9812
- Fichier &1 non trouvé dans la bibliothèque &2.
- CPF9814
- Unité &1 non trouvée.
- CPF9833
- *CURASPGRP ou *ASPGRPPRI indiqué et unité d'exécution en cours sans groupe d'ASP.
- CPFB8ED
- La description d'unité &1 est incorrecte pour l'opération.
© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.