RST

La commande RST permet de restaurer une copie d'un ou de plusieurs objets pouvant être utilisés dans le système de fichiers intégré.

Pour plus d'informations sur les commandes du système de fichiers intégré, reportez-vous aux Rubriques Système de fichiers intégré de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Restrictions :

• Cette commande n'est pas fournie avec le droit public *EXCLUDE.
• Pour connaître les restrictions relatives à l'utilisation de cette commande pour la restauration d'objets à l'aide de masques de noms dans le répertoire principal, la restauration d'objets en bibliothèque ou la restauration de documents ou dossiers, reportez-vous au manuel Reprise du système, SC41-5304.

Paramètres

Unité (DEV)

Indique l'unité à partir de laquelle les objets sont restaurés.

Pour plus d'informations permettant de préciser les noms de chemin vers une unité, reportez-vous à la rubrique relative à la façon de spécifier les noms d'unité, dans le manuel Ensemble de rubriques Sauvegarde et reprise de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/

Ce paramètre est obligatoire.

Remarque :Ce paramètre est compatible Unicode. Pour plus d'informations, reportez-vous à la section sur la prise en charge Unicode dans CL, dans les Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

'nom-chemin-fichier-sauvegarde'

Indiquez le nom de chemin du fichier sauvegarde utilisé pour restaurer les objets.

'nom-chemin-unité-optique'

Indiquez le nom de chemin de l'unité optique utilisée pour restaurer les objets.

'nom-chemin-unité-bandothèque'

Indiquez le nom de chemin de la bandothèque utilisée pour restaurer les objets.

'nom-chemin-unité-bande'

Indiquez le nom de chemin de l'unité de bande utilisée pour restaurer les objets. Vous pouvez spécifier jusqu'à quatre unités de bande. Si une unité de bande virtuelle est utilisée, aucune autre unité ne doit être indiquée.

'nom-chemin-définition-support'

Indiquez le nom de chemin de l'objet de définition de support (*MEDDFN) qui identifie les unités et le support utilisés pour restaurer les données.

Pour toute information sur la création d'une définition de support, reportez-vous à l'API de création de définition de support dans la rubrique Ensemble de rubriques API de la catégorie Programmation de l'IBM i Information Center (http://www.ibm.com/systems/i/infocenter/).

Pour plus d'informations sur l'utilisation d'une définition de support, voir Reprise du système, SC41-5304 et la rubrique sur la sauvegarde su serveur dans Ensemble de rubriques Sauvegarde et reprise de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Objets (OBJ)

Indique le nom de chemin de l'objet à restaurer. Vous pouvez indiquer un masque pour ce nom de chemin. Vous pouvez spécifier jusqu'à 300 noms de chemin.

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/.

Pour en savoir plus sur les masques de noms d'objets, reportez-vous au manuel Rubriques Système de fichiers intégré de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Remarque :Ce paramètre est compatible Unicode. Pour plus d'informations, reportez-vous à la section sur la prise en charge Unicode dans CL, dans les Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Elément 1 : Nom

Indique les objets sauvegardés sur le support. Les abréviations de répertoire (par exemple, le répertoire en cours) sont développées avec leur valeur en cours et non pas avec celle qu'elles avaient lors de la sauvegarde.

'*'

Les objets du répertoire en cours sont restaurés.

nom-chemin

Indiquez le nom de chemin d'un objet spécifique ou un masque auquel peuvent correspondre plusieurs noms. Si la valeur *SAME est spécifiée pour le troisième élément de ce paramètre, chaque élément du nom de chemin doit exister, sauf le dernier. Le nom d'objet du dernier élément est restauré en tant que nouvel objet s'il n'existe pas.

Elément 2 : Inclure ou omettre

Indique si les noms correspondant au masque doivent être inclus ou non dans l'opération. Notez que lorsque l'on détermine si un nom correspond à un masque, les masques de noms relatifs sont toujours traités comme étant associés au répertoire de travail en cours.

Remarque :Le paramètre SUBTREE détermine si l'arborescence est incluse ou omise.

*INCLUDE

Les objets correspondant au masque de nom d'objet doivent être restaurés, sauf si une spécification *OMIT s'y substitue.

*OMIT

Les objets correspondant au masque de nom d'objet ne doivent pas être restaurés. Cette valeur se substitue à une spécification *INCLUDE et permet d'omettre un sous-ensemble d'un masque sélectionné précédemment.

Elément 3 : Nouveau nom d'objet

Indique le nouveau nom de chemin de l'objet.

*SAME

Les objets doivent être restaurés sous le nom qu'ils portaient lors de leur sauvegarde.

nom-chemin

Indiquez le chemin pour la restauration de l'objet. Si un masque est indiqué dans le premier élément, le nouveau nom de chemin doit être celui du répertoire dans lequel tout objet correspondant au masque sera restauré. Si un nom d'objet est spécifié dans l'élément 1, chaque élément du nouveau nom de chemin doit exister, sauf le dernier. Le nom d'objet du dernier élément est restauré en tant que nouvel objet s'il n'existe pas.

Masque du nom (PATTERN)

Définit un masque à utiliser pour inclure ou omettre certains objets. Vous pouvez spécifier jusqu'à 300 masques.

Remarque :Ce paramètre est compatible Unicode. Pour plus d'informations, reportez-vous à la section sur la prise en charge Unicode dans CL, dans les Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Elément 1 : Masque

'*'

Tous les objets remplissant les conditions requises pour l'opération sont inclus ou omis.

valeur-alphanumérique

Indiquez un objet ou un masque auxquels peuvent correspondre plusieurs noms.

Elément 2 : Inclure ou omettre

Indique si les noms correspondant au masque doivent être inclus ou non dans l'opération.

Remarque :Le paramètre SUBTREE détermine si l'arborescence est incluse ou omise.

*INCLUDE

Seuls les objets inclus par le paramètre OBJ et qui correspondent au paramètre PATTERN sont inclus dans la restauration, à moins qu'ils ne soient substitués par une spécification *OMIT.

*OMIT

Tous les objets regroupés par le paramètre OBJ sont inclus dans la restauration, sauf les objets qui correspondent au paramètre *PATTERN. Cette valeur se substitue à une spécification *INCLUDE et permet d'omettre un sous-ensemble d'un masque sélectionné précédemment.

Branche du répertoire (SUBTREE)

Indique si toute l'arborescence du répertoire doit être incluse dans l'opération de restauration.

*ALL

Toute l'arborescence de chaque répertoire correspondant au masque de nom d'objet est traitée. Elle comprend tous les sous-répertoires et les objets qu'ils contiennent.

*DIR

Les objets du premier niveau de chaque répertoire correspondant au masque de nom d'objet sont traités ; les sous-répertoires de chaque répertoire correspondant sont pris en compte, mais pas les objets contenus dans ces sous-répertoires.

*NONE

L'arborescence des répertoires n'est pas incluse dans l'opération de restauration. Si un répertoire correspond au masque de nom d'objet indiqué, les objets qui s'y trouvent sont inclus. Si ce répertoire comporte des sous-répertoires, ces derniers et les objets qu'ils renferment ne seront pas inclus.

*OBJ

Seuls les objets correspondant au masque de nom d'objet seront traités. Si ce dernier indique un répertoire, les objets qu'il contient ne sont pas inclus.

*STG

Les objets correspondant au masque de nom d'objet doivent être traités, avec la mémoire relative aux objets associés. A l'aide de cette valeur, les objets ne peuvent être restaurés que s'ils ont été sauvegardés avec SUBTREE(*STG).

Sortie (OUTPUT)

Indique si une liste d'informations relatives aux objets restaurés est créée. Ces informations peuvent être dirigées vers un fichier spoule, un fichier STREAM ou un espace utilisateur.

Un fichier STREAM ou un espace utilisateur est indiqué comme nom de chemin.

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/.

Remarque :Ce paramètre est compatible Unicode. Pour plus d'informations, reportez-vous à la section sur la prise en charge Unicode dans CL, dans les Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

*NONE

Aucune sortie n'est créée.

*PRINT

Des informations en sortie relatives à la restauration seront imprimées.

'nom-chemin-fichier-STREAM'

Indiquez le nom de chemin du fichier STREAM existant vers lequel la sortie générée par la commande est dirigée.

'nom-chemin-espace-utilisateur'

Indiquez le nom de chemin de l'espace utilisateur existant vers lequel la sortie générée par la commande est dirigée.

Création répertoires parents (CRTPRNDIR)

Permet d'indiquer si les répertoires parents des objets en cours de restauration doivent être créés s'ils n'existent pas. Par exemple, si l'objet '/a/b/c/file1' est en cours de restauration, les répertoires '/a', '/a/b' et '/a/b/c' doivent exister. Ce paramètre s'applique uniquement aux systèmes de fichiers "root", (/), QOpenSys et UDFS (définis par l'utilisateur). Il n'est pris en compte pour aucun des autres systèmes de fichiers.

*NO

Les répertoires parents ne seront pas créés s'ils n'existent pas. Le message de diagnostic CPD375B sera envoyé et l'objet ne sera pas restauré.

*YES

L'opération de restauration va créer les répertoires parents s'ils n'existent pas. Le droit public *EXCLUDE sera associé aux répertoires créés par l'opération de restauration. Ces derniers seront possédés par le profil utilisateur indiqué au paramètre PRNDIROWN (Propriétaire répertoire parent). Les autres attributs de répertoire parent seront définis à l'aide des valeurs par défaut des paramètres de la commande CRTDIR (Créer un répertoire).

Propriétaire répertoire parent (PRNDIROWN)

Indique le nom d'un profil utilisateur existant qui possédera les répertoires parents créés par l'opération de restauration. Ce paramètre s'applique uniquement aux systèmes de fichiers "root", (/), QOpenSys et UDFS (définis par l'utilisateur). Il n'est pris en compte pour aucun des autres systèmes de fichiers.

Remarque :Si une valeur est indiquée pour ce paramètre, la valeur *YES doit être précisée au paramètre CRTPRNDIR (Création répertoires parents).

*PARENT

Le propriétaire d'un répertoire parent en cours de création par l'opération de restauration sera identique à celui du répertoire dans lequel il est créé. Par exemple, si l'objet '/a/b/c/file1' est en cours de restauration et que le répertoire '/a' existe alors que les répertoires '/b' et '/b/c' n'existent pas, ces derniers sont créés avec le même propriétaire que celui du répertoire '/a'.

nom

Indiquez le nom d'un profil utilisateur qui sera le propriétaire des répertoires parents créés par l'opération de restauration.

Recréer système fichiers monté (RBDMFS)

Indique les systèmes de fichiers montés qui doivent être recréés lors de la restauration.

Remarque :Vous devez disposer du droit spécial *SAVSYS (Sauvegarder le système) ou *ALLOBJ (tous les objets) pour indiquer une valeur autre que *NONE pour ce paramètre.

*NONE

Les systèmes de fichiers montés ne sont pas recréés lors de la restauration. Les objets qui ont été sauvegardés à partir d'un système de fichiers monté sont restaurés dans le système de fichiers qui contient le répertoire dans lequel la restauration est effectuée.

*UDFS

Les systèmes de fichiers utilisateur montés sont recréés lors de la restauration. Un système de fichiers utilisateur est créé s'il n'existe pas, puis il est monté sur le répertoire sur lequel il était monté au cours de la sauvegarde.

Si un système de fichiers utilisateur est créé lors de la restauration, les attributs sont définis en fonction du système de fichiers utilisateur sauvegardé, y compris les attributs spécifiques au système de fichiers utilisateur comme la dépendance des minuscules/majuscules et le format de fichier par défaut. Si le système de fichiers utilisateur existe avant la restauration, aucun attribut n'est modifié.

S'il y a une erreur lors de la création ou du montage d'un système de fichiers utilisateur, aucun des objets sauvegardés à partir du système de fichiers utilisateur monté n'est restauré.

Remarque :S'il n'existe pas avant la restauration, le répertoire monté est créé avec les attributs et les droits copiés à partir du répertoire dans lequel la restauration est effectuée. Cela peut entraîner des erreurs lorsque le système de fichiers utilisateur est démonté puis remonté, si les droits ne suffisent pas pour permettre le montage.

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.

Remarque :La première version de l'objet trouvée à l'emplacement indiqué est restaurée, sauf si une version spécifique est indiquée au moyen des valeurs des paramètres SAVDATE et SAVTIME.

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.

Label (LABEL)

Indique l'identificateur de fichier du support à utiliser pour l'opération de restauration.

*SEARCH

Le label de fichier à rechercher est déterminé par le système.

valeur-alphanumérique

Indiquez l'identificateur (jusqu'à 17 caractères) du fichier bande utilisé pour l'opération de restauration.

Numéro de séquence (SEQNBR)

Indique le numéro de séquence de fichier bande à utiliser.

*SEARCH

Le fichier suivant contenant l'un des objets indiqués est recherché sur le volume de bande.

1-16777215

Indiquez le numéro de séquence du fichier.

Position de début (POSITION)

Indique à quel emplacement du fichier bande doit débuter la recherche des données à restaurer. L'indication d'une valeur ici peut accélérer l'opération de restauration si vous souhaitez uniquement restaurer des données qui ne sont pas enregistrées vers le début du fichier bande.

*FIRST

La recherche des données à restaurer commence au début du fichier bande.

valeur-hexadécimale

Indiquez la position de début dans le fichier bande pour le premier à objet à restaurer. La position de début de chaque objet a été renvoyée dans la sortie de l'opération de sauvegarde. Si vous souhaitez restaurer plusieurs objets, indiquez la plus petite des valeurs qui ont été renvoyées pour l'ensemble des objets à restaurer. Si vous indiquez une valeur hexadécimale, vous devez par ailleurs indiquer une valeur autre que *SEARCH pour le paramètre Numéro de séquence (SEQNBR).

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 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.

Type d'informations en sortie (INFTYPE)

Indique le type des informations dirigées vers le fichier spoule, le fichier STREAM ou l'espace utilisateur.

*ALL

Le fichier contiendra des informations relatives à la commande, un poste pour chaque répertoire, pour chaque objet restauré et pour chaque objet dont la restauration n'a pas abouti.

*ERR

Le fichier contiendra des informations relatives à la commande, un poste pour chaque répertoire et un poste pour chaque objet dont la restauration n'a pas abouti.

*SUMMARY

Le fichier contiendra des informations relatives à la commande et un poste pour chaque répertoire.

Système (SYSTEM)

Indique si les objets existant sur le système local ou sur des systèmes éloignés doivent être traités.

*LCL

Seuls les objets présents sur le système local sont traités.

*RMT

Seuls les objets présents sur des systèmes éloignés sont traités.

*ALL

Les objets présents sur le système local et les systèmes éloignés sont traités.

Date de sauvegarde (SAVDATE)

Indique la date à laquelle les objets ont été sauvegardés. Si vous ne voulez pas restaurer la version de sauvegarde la plus récente ou si plusieurs versions de sauvegarde se trouvent sur le support, indiquez la date permettant d'identifier la version des objets à restaurer.

Vous devez utiliser le format de date du travail. Si les séparateurs spécifiés par la valeur système QDATSEP sont utilisés, vous devez mettre cette valeur entre apostrophes.

Remarque :Ce paramètre est admis uniquement si un identificateur de volume ou si la valeur *MOUNTED sont indiqués au paramètre VOL, ou encore si *SAVF est indiqué au paramètre DEV. Si ce paramètre est correct et n'est pas spécifié, la première version trouvée est restaurée.

date

Indiquez la date de sauvegarde des objets à restaurer.

Heure de sauvegarde (SAVTIME)

Indique l'heure à laquelle les objets ont été sauvegardés.

L'heure est indiquée au format 24 heures avec ou sans séparateur d'heure :

• Si vous utilisez des séparateurs, entrez une chaîne de 5 ou 8 chiffres, où le séparateur indiqué pour votre travail délimite les heures, les minutes et les secondes. Si vous exécutez cette commande à partir de la ligne de commande, la chaîne doit être placée entre apostrophes. Si vous utilisez un autre séparateur que celui indiqué pour votre travail, la commande échoue.
• Si vous n'utilisez pas de séparateur, entrez une chaîne de 4 ou 6 chiffres (hhmm ou hhmmss), hh représentant les heures, mm les minutes et ss les secondes. Les valeurs admises pour hh sont comprises entre 00 et 23. Pour mm et ss, les valeurs admises sont comprises entre 00 et 59.

Si un identificateur de volume ou la valeur *MOUNTED sont indiqués au paramètre VOL et que le paramètre SAVTIME n'est pas défini, la première version trouvée sur le volume sera restaurée.

Remarques :

1. Ce paramètre est admis uniquement si le paramètre SAVDATE est indiqué.
2. Ce paramètre n'est pas pris en compte lorsque le paramètre SEQNBR est indiqué.

heure

Indiquez l'heure de sauvegarde des objets à restaurer.

Option (OPTION)

Indique si les objets existant ou non sur le système doivent être restaurés.

*ALL

Tous les objets indiqués sont restaurés, qu'ils existent ou non sur le système.

*NEW

Les objets sont restaurés uniquement s'ils n'existent pas déjà sur le système.

*OLD

Les objets sont restaurés uniquement s'ils existent déjà sur le système.

Admettre différences d'objet (ALWOBJDIF)

Indique si des différences sont admises entre les objets sauvegardés et les objets restaurés.

Remarques :

1. Vous devez disposer du droit spécial *ALLOBJ pour pouvoir indiquer une valeur autre que *NONE pour ce paramètre.
2. 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é.

Forcer conversion d'objet (FRCOBJCVN)

Indique si la conversion des objets utilisateur au format requis pour la version en cours du système d'exploitation doit être effectuée, ou s'ils sont compatibles avec l'ordinateur actuel, lors de la restauration de ces derniers.

Remarques :

1. Ce paramètre ne s'applique qu'aux objets utilisateur de type *MODULE, *PGM, *SRVPGM et *SQLPKG.
2. Un objet doit disposer de données de création (observables ou non) pour être converti.
3. Si la conversion d'un objet est requise (car il est formaté pour une version antérieure du système d'exploitation ou est incompatible avec l'ordinateur actuel) mais non effectuée lors de cette opération de restauration, l'objet est automatiquement converti lorsqu'il est utilisé pour la première fois.

Valeurs uniques

*SYSVAL

Les objets sont convertis en fonction de la valeur système QFRCCVNRST.

*NO

Les objets ne sont pas convertis pendant l'opération de restauration.

Remarque :Si FRCOBJCVN(*NO) est indiqué, la valeur système QFRCCVNRST doit avoir la valeur "0" ou "1".

Elément 1 : Conversion à la restauration

*YES

Les objets sont convertis pendant l'opération de restauration.

Remarques :

1. Si FRCOBJCVN(*YES *RQD) est indiqué, la valeur système QFRCCVNRST doit être "0", "1" ou "2". FRCOBJCVN(*YES *RQD) va remplacer une valeur QFRCCVNRST de "0" ou "1". Si FRCOBJCVN(*YES *ALL) est indiqué, QFRCCVNRST peut avoir une valeur correcte et FRCOBJCVN(*YES *ALL) remplace la valeur système QFRCCVNRST.
2. Le fait de spécifier cette valeur a pour conséquence d'augmenter la durée de l'opération de restauration, toutefois, il n'est plus nécessaire de convertir les objets lorsqu'ils sont utilisés pour la première fois.

Elément 2 : Objets à convertir

*RQD

Les objets ne sont convertis que si le système d'exploitation requiert cette opération pour pouvoir utiliser ces derniers ou pour être compatibles avec l'ordinateur actuel. Si les objets ne disposent pas de toutes les données de création (observables ou non), ils ne peuvent pas être convertis et ne vont pas être restaurés.

*ALL

Tous les objets sont convertis quel que soit leur format actuel et la compatibilité avec l'ordinateur, y compris ceux qui sont déjà au format en cours. Toutefois, si les objets ne disposent pas de toutes les données de création (observables ou non), ils ne peuvent pas être convertis et ne vont pas être restaurés.

ID objet (OBJID)

Ce paramètre a été désactivé et n'est plus admis.

Droits privés (PVTAUT)

Indique si les droits privés doivent être restaurés avec les objets restaurés.

*NO

Aucun droit privé n'est restauré.

*YES

Les droits privés sont restaurés avec les objets. Les objets ne sont restaurés qu'à partir des opérations de sauvegarde indiquant que les droits privés doivent être sauvegardés avec les objets.

Remarque :Vous devez disposer du droit spécial *ALLOBJ (Tous les objets) pour indiquer cette valeur.

Démarrer journalisation (STRJRN)

Indique si la journalisation des nouveaux objets restaurés doit être démarrée.

Remarques :

1. Les informations de journal ayant été sauvegardées seront restaurées pour les nouveaux objets, que la journalisation soit démarrée ou non.
2. La journalisation ne change pas pour les objets existants.

*YES

La journalisation est démarrée pour les nouveaux objets qui étaient journalisés lors de leur sauvegarde.

*NO

La journalisation n'est pas démarrée pour les objets qui sont restaurés.

Exemples

Exemple 1 : Restauration de toutes les données qui ne figurent pas dans des bibliothèques ou ne sont pas des objets de bibliothèque de documents

RST   DEV('/QSYS.LIB/TAP01.DEVD')
      OBJ(('/*') ('/QSYS.LIB' *OMIT) ('/QDLS' *OMIT))

Cette commande restaure tous les objets qui ne se trouvent pas dans des bibliothèques et qui ne sont pas des objets de bibliothèque de documents.

Exemple 2 : Restauration d'une bibliothèque

RST   DEV('/QSYS.LIB/TAP01.DEVD')  OBJ('/QSYS.LIB/A.LIB')

Cette commande restaure la bibliothèque A à partir de l'unité de bande TAP01.

Exemple 3 : Restauration de tous les fichiers de MYLIB

RST   DEV('/QSYS.LIB/TAP01.DEVD')
      OBJ('/QSYS.LIB/MYLIB.LIB/*.FILE')

Cette commande restaure tous les fichiers de bibliothèque MYLIB à partir de l'unité de bande TAP01.

Exemple 4 : Restauration de tous les objets du répertoire en cours

RST   DEV('/QSYS.LIB/TAP01.DEVD')

Cette commande utilise la valeur par défaut du paramètre OBJ pour restaurer tous les objets du répertoire en cours et de ses sous-répertoires.

RST   DEV('/QSYS.LIB/TAP01.DEVD')  OBJ('*')  SUBTREE(*NONE)

Cette commande restaure tous les objets du répertoire en cours mais pas de ses sous-répertoires.

RST   DEV('/QSYS.LIB/TAP01.DEVD')  OBJ('.')  SUBTREE(*DIR)

Cette commande restaure le répertoire en cours et tous les objets qu'il contient. Elle ne restaure pas les objets des sous-répertoires du répertoire en cours.

Exemple 5 : Omission d'objets

RST   DEV('/QSYS.LIB/TAP01.DEVD')
      OBJ(('*') ('**.BACKUP' *OMIT) ('**.TEMP' *OMIT))

Cette commande restaure tous les objets du répertoire en cours, exception faite de ceux dont l'extension est .BACKUP et .TEMP (les branches complètes des répertoires ayant ces extensions sont omises).

Exemple 6 : Changement de nom ou déplacement d'objets

RST   DEV('/QSYS.LIB/TAP01.DEVD')
      OBJ(('MYDIR/X.PGM' *INCLUDE 'YOURDIR/Y.PGM'))

Cette commande restaure le programme X à partir du répertoire MYDIR en tant que programme Y dans le répertoire YOURDIR.

RST   DEV('/QSYS.LIB/TAP01.DEVD')
      OBJ(('MYDIR/*.PGM' *INCLUDE 'YOURDIR'))  SUBTREE(*OBJ)

Cette commande restaure tous les programmes du répertoire MYDIR dans le répertoire YOURDIR.

Exemple 7 : Restauration à partir d'un fichier sauvegarde

RST   DEV('/QSYS.LIB/MYLIB.LIB/MYSAVF.FILE')  OBJ(MYDIR)

Cette commande restaure le répertoire MYDIR à partir d'un fichier sauvegarde nommé MYSAVF dans une bibliothèque nommée MYLIB.

Exemple 8 : Utilisation de liens symboliques

Supposons que le répertoire en cours contienne les liens symboliques suivants.

• DevLink = /QSYS.LIB/TAP01.DEVD
• DirLink = /SomeDirectory
• FileLink = /SomeDirectory/SomeFile

Les liens symboliques permettent d'indiquer l'unité et le fichier de sortie. Lorsque des liens symboliques sont restaurés, seuls les noms des objets associés sont restaurés et non leur contenu. Un lien symbolique vers un répertoire permet de restaurer les objets qu'il contient. Vous trouverez des informations supplémentaires concernant les liens symboliques dans la rubrique sur les systèmes de fichiers intégrés de la catégorie Systèmes de fichiers et gestion du Centre de documentation. Pour restaurer les noms associés à DirLink et FileLink à partir de l'unité TAP01 :

RST   DEV('DevLink')  OBJ(('DirLink') ('FileLink'))

Pour restaurer les objets de SomeDirectory à partir de l'unité TAP01 :

RST   DEV('DevLink')  OBJ(('DirLink/*'))

Messages d'erreur

Messages *ESCAPE

CPFA0DB

L'objet n'est pas un objet de QSYS.LIB. L'objet est &1.

CPFA0DC

L'objet n'est pas un objet de QDLS. L'objet est &1.

CPF370C

Non autorisé au paramètre ALWOBJDIF.

CPF3707

Le fichier sauvegarde &1 de &2 ne contient aucune donnée.

CPF3727

Unité &1 indiquée plusieurs fois dans la liste des noms d'unités.

CPF3738

L'unité &1 utilisée pour la sauvegarde/restauration est endommagée.

CPF3743

Restauration, affichage ou listage du fichier impossible.

CPF3768

Unité &1 incorrecte pour la commande indiquée.

CPF3782

Le fichier &1 de &2 n'est pas un fichier sauvegarde.

CPF3794

La sauvegarde ou la restauration n'a pas abouti.

CPF380D

La sauvegarde ou la restauration intégrale du système n'a pas abouti.

CPF3805

Objets du fichier sauvegarde &1 de &2 non restaurés.

CPF381E

Non autorisé au paramètre ALWOBJDIF.

CPF3812

Fichier sauvegarde &1 de &2 en cours d'utilisation.

CPF382A

Paramètre incorrect pour le système de fichiers QDLS.

CPF382B

Paramètres incorrects avec des systèmes de fichiers multiples. Code raison &1.

CPF382C

Valeur de paramètre OBJ incorrecte pour le système de fichiers QSYS.

CPF382D

Paramètre incorrect pour le système de fichiers QSYS.

CPF382F

Valeur du paramètre OBJ incorrecte pour le système de fichiers QDLS.

CPF3823

Aucun objet sauvegardé ou restauré.

CPF3826

Objet *INCLUDE requis au paramètre OBJ.

CPF3828

Erreur lors de l'utilisation de &1.

CPF383A

Echec de la sauvegarde ou de la restauration.

CPF383B

Fin du fichier &1.

CPF383C

Limite mémoire dépassée pour profil utilisateur &1.

CPF383D

Impossible d'utiliser &1.

CPF383E

&1 objets restaurés. &2 objets non restaurés.

CPF3833

Valeur indiquée au paramètre DEV incorrecte.

CPF3834

Trop de valeurs au paramètre DEV.

CPF3835

Les unités de bande n'acceptent pas la même densité.

CPF3839

&1 objets restaurés. &2 non restaurés.

CPF384A

Identificateur de volume &1 incorrect.

CPF384B

Le fichier optique indiqué est incorrect.

CPF384C

Erreur lors de la conversion du CCSID.

CPF384F

Objet &1 de type &2 non restauré dans la bibliothèque &3.

CPF3840

Le fichier indiqué pour l'opération de restauration est introuvable.

CPF38A5

Erreur du paramètre PATTERN.

CPF5729

Allocation de l'objet &1 impossible.

CPF9802

Non autorisé à l'objet &2 de &3.

CPF9825

Accès non autorisé à l'unité &1.

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é.