SAVCFG

La commande SAVCFG (Sauvegarder la configuration) permet de sauvegarder tous les objets de configuration et objets SRM (Gestion des ressources système), sans que soit nécessaire un système à l'état restreint. Les informations sauvegardées sont les suivantes :

• Descriptions de lignes
• Descriptions de contrôleurs
• Descriptions d'unités
• Descriptions de modes
• Descriptions de classes de service
• Descriptions d'interfaces de réseau
• Descriptions de serveurs de réseau
• Descriptions NetBIOS
• Listes de connexions
• Listes de configuration
• Données de ressources matérielles
• Données d'adaptateur de réseau en anneau à jeton

La commande RSTCFG (Restaurer une configuration) permet de restaurer les informations sauvegardées.

Restrictions :

• Vous devez disposer du droit spécial *SAVSYS pour exécuter cette commande.
• Les objets SRM (Gestion des ressources système) ne sont pas sauvegardés si la commande WRKHDWPRD (Gérer le matériel) est aussi en cours d'exécution.

Paramètres

Unité (DEV)

Indique le nom de l'unité utilisée pour la sauvegarde. 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 sauvegarde est effectuée à l'aide du fichier sauvegarde indiqué à l'invite Fichier sauvegarde (paramètre SAVF).

Autres valeurs

nom-unité-optique

Indiquez le nom de l'unité optique à utiliser pour la sauvegarde.

nom-unité-bandothèque

Indiquez le nom de l'unité de bandothèque à utiliser pour la sauvegarde.

nom-unité-bande

Indiquez le nom d'une ou plusieurs unités de bande utilisées pour l'opération de sauvegarde. 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, ces dernières doivent posséder des formats de support compatibles et leurs noms doivent être précisés dans l'ordre dans lequel elles sont utilisées. Lorsque vous vous servez de plusieurs unités de bande, vous pouvez rembobiner et décharger un volume, pendant qu'une autre unité de bande traite le volume suivant.

Identificateur de volume (VOL)

Indique les identificateurs utilisés pour la sauvegarde des données : ID volume ou ID cartouche des bandes d'une unité de bandothèque. Les volumes doivent être placés sur l'unité selon le même ordre que celui indiqué pour ce paramètre.

Valeurs uniques

*MOUNTED

Les données sont sauvegardées sur les volumes montés sur l'unité. 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 sauvegarde des données.

Numéro de séquence (SEQNBR)

Indique le numéro de séquence servant de point de départ à la sauvegarde, lorsqu'une bande est utilisée.

*END

La sauvegarde commence après le dernier numéro de séquence sur la première bande. Si celle-ci est pleine, un message d'erreur est généré et la sauvegarde s'arrête.

1 à 16777215

Indiquez le numéro de séquence du fichier à utiliser pour la sauvegarde.

Date d'expiration du fichier (EXPDATE)

Indique la date de péremption du fichier créé par l'opération de sauvegarde. Si vous précisez une date de péremption, le fichier est protégé et ne peut pas être écrasé avant cette date.

Remarques :

1. Ce paramètre est admis pour les bandes et les fichiers optiques.
2. L'utilisation de ce paramètre ne protège pas le fichier contre une opération de sauvegarde ultérieure spécifiant CLEAR(*ALL).

*PERM

Le fichier est protégé de façon définitive.

date

Indiquez la date à partir de laquelle le fichier n'est plus protégé.

Option de fin de support (ENDOPT)

Indique l'opération automatiquement exécutée sur la bande ou sur le volume optique à la fin de l'opération de sauvegarde. 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.

Taille optimale de bloc (USEOPTBLK)

Indique si la taille optimale de bloc est utilisée pour l'opération de sauvegarde.

Remarque :Si USEOPTBLK(*YES) est spécifié, il est possible que la bande ne puisse être dupliquée que sur une unité qui accepte la même taille de bloc.

*YES

La taille optimale de bloc prise en charge par l'unité est utilisée pour les commandes de sauvegarde. Si la taille de bloc utilisée est supérieure à celle prise en charge par tous les types d'unités, les conséquences sont les suivantes :

• Les performances peuvent être améliorées.
• Le fichier bande créé est compatible uniquement avec une unité prenant en charge la taille de bloc utilisée. Les commandes telles que DUPTAP (Dupliquer une bande) ne dupliquent pas les fichiers, sauf vers une unité prenant en charge la même taille de bloc que celle utilisée.
• La valeur du paramètre DTACPR est ignorée.

*NO

La taille optimale de bloc prise en charge par l'unité n'est pas utilisée. Les commandes de sauvegarde utilisent la taille de bloc par défaut prise en charge par tous les types d'unités. Le volume de bande peut être dupliqué sur tout format de support à l'aide de la commande DUPTAP.

Fichier sauvegarde (SAVF)

Indique le fichier sauvegarde qui est utilisé pour contenir les données sauvegardées. Ce fichier doit être vide, sauf si *ALL a été précisé à l'invite Mise à blanc (paramètre CLEAR).

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 sauvegarde, à partir du 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 génère un nom de fichier optique dans le répertoire principal du volume optique.

'nom-chemin-répertoire-optique/*'

Le système génère un nom de fichier optique dans le répertoire indiqué du volume optique.

Mise à blanc (CLEAR)

Indique si les données actives sur le support sont automatiquement mises à blanc ou remplacées. Le terme "données actives" désigne tout fichier non périmé du support. Dans le cas d'une sauvegarde sur bande, la mise à blanc des données actives rend inaccessibles les fichiers du volume de bande situés au-delà du dernier fichier écrit lors de l'opération de sauvegarde. Dans le cas d'une sauvegarde sur support optique, les fichiers écrits lors de la sauvegarde peuvent être automatiquement remplacés alors que d'autres fichiers présents sur le volume demeurent actifs ou tous les fichiers actifs peuvent être automatiquement mis à blanc. Lors d'une mise à blanc, les données sont effacées et les fichiers sont rendus inaccessibles.

Remarques :

1. La bande n'est pas initialisée lors de sa mise à blanc. Avant d'exécuter la commande de sauvegarde, vous devez initialiser les bandes au format label standard à l'aide de la commande INZTAP (Initialiser une bande) et spécifier une valeur pour le paramètre NEWVOL.
2. La mise à blanc du volume optique l'initialise.
3. Si le système détecte un volume non initialisé lors de l'opération de sauvegarde, il envoie un message d'interrogation et l'opérateur peut initialiser le volume.

*NONE

Le support n'est pas mis à blanc automatiquement. Si l'opération de sauvegarde trouve des données actives sur un volume de bande ou dans un fichier sauvegarde, le système envoie un message d'interrogation à l'opérateur lui permettant d'arrêter la sauvegarde ou de mettre à blanc le support. Si l'opération de sauvegarde trouve le fichier optique spécifié, un message d'interrogation est envoyé à l'opérateur, lui permettant d'arrêter la sauvegarde ou de remplacer ce fichier.

*ALL

Tout le support est automatiquement mis à blanc.

Si des bandes sont utilisées et qu'un numéro de séquence est indiqué pour le paramètre SEQNBR, le contenu de la première bande, à partir de ce numéro de séquence, est effacé. Toutes les bandes qui suivent cette première bande sont entièrement effacées. Pour effacer la première bande entièrement, vous devez spécifier SEQNBR(1).

*AFTER

Après le premier volume, la totalité du support est mis à blanc automatiquement. Si l'opération de sauvegarde rencontre des données actives sur le premier volume de bande, le système envoie un message d'interrogation à l'opérateur, lui permettant de mettre fin à l'opération de sauvegarde ou de mettre à blanc le support. Si l'opération de sauvegarde détecte le fichier optique spécifié sur le premier volume, un message d'interrogation est envoyé, permettant à l'opérateur de mettre fin à l'opération de sauvegarde ou de remplacer le fichier.

Remarque :La valeur *AFTER n'est pas admise pour les fichiers sauvegarde.

*REPLACE

Les données actives du support sont automatiquement remplacées. Les volumes optiques ne sont pas initialisés. Les autres supports sont automatiquement mis à blanc de la même manière qu'avec la valeur *ALL.

Tester disponibilité objets (PRECHK)

Permet d'indiquer si l'opération de sauvegarde de la configuration prend fin lorsqu'un objet répond aux conditions suivantes :

• Les objets ont été endommagés.
• Les objets sont verrouillés par un autre travail.
• L'utilisateur ne dispose pas du droit nécessaire pour sauvegarder les objets.

*NO

L'opération de sauvegarde se poursuit, ne s'appliquant qu'aux objets de configuration et aux objets SRM (Gestion des ressources système) pouvant être sauvegardés.

*YES

L'opération de sauvegarde prend fin avant que les données ne soient écrites sur le support, si des objets de configuration ou des objets de gestionnaire de ressource système ne peuvent pas être sauvegardés.

Compression des données (DTACPR)

Indique si la compression des données est utilisée. Dans ce cas, la sauvegarde pourra avoir des conséquences néfastes sur les performances du système si d'autres travaux sont actifs dans le même temps.

Remarque :Si *DEV est indiqué à la fois pour ce paramètre et à l'invite Compactage des données (paramètre COMPACT), seul le compactage des données est effectué s'il est pris en charge par l'unité. Sinon, la compression des données est effectuée.

Si *YES est précisé pour ce paramètre et *DEV pour le paramètre COMPACT, les opérations de compactage et de compression des données sont toutes deux effectuées, si elles sont acceptées par l'unité.

*DEV

Si la sauvegarde se fait sur bande et que l'unité cible accepte la compression des données, la compression matérielle est effectuée. Sinon, les données ne seront pas comprimées.

*NO

La compression des données n'est pas utilisée.

*YES

Si la sauvegarde se fait sur bande et que l'unité cible accepte la compression des données, la compression matérielle est effectuée. Si la compression n'est pas prise en charge, ou si les données de sauvegarde sont écrites sur support optique, ou dans un fichier sauvegarde, la compression par logiciel est réalisée. La compression basse par logiciel est utilisée pour toutes les unités à l'exception des DVD optiques, qui utilisent une compression moyenne par logiciel.

*LOW

Si l'opération de sauvegarde s'effectue dans un fichier sauvegarde ou sur un volume optique, la compression de données par logiciel s'effectue avec l'algorithme SNA. Une faible compression est généralement plus rapide et les données comprimées sont généralement plus volumineuses qu'avec une compression moyenne ou élevée.

*MEDIUM

Si l'opération de sauvegarde s'effectue dans un fichier ou sur volume optique, la compression de données par logiciel s'effectue avec l'algorithme TERSE. La compression moyenne est généralement plus lente que la compression faible mais plus rapide que la compression élevée. Les données comprimées sont généralement moins volumineuses qu'avec une faible compression et plus volumineuses qu'avec une compression élevée.

*HIGH

Si l'opération de sauvegarde s'effectue dans un fichier sauvegarde ou sur un volume optique, la compression des données s'effectue avec l'algorithme LZ1. Une compression élevée est généralement plus lente et les données comprimées sont généralement moins volumineuses qu'avec une compression faible ou moyenne.

*ZLIB

Si l'opération de sauvegarde s'effectue dans un fichier sauvegarde ou sur un volume optique, la compression des données s'effectue avec l'algorithme ZLIB.

Compactage des données (COMPACT)

Indique si le compactage de données par l'unité est utilisé.

*DEV

Le compactage des données de l'unité s'effectue si les données sont sauvegardées sur bande et si toutes les unités de bande indiquées à l'invite Unité (paramètre DEV) acceptent la fonction de compactage.

Remarque :Si *DEV est indiqué à la fois à l'invite Compression des données (paramètre DTACPR) et pour ce paramètre, seul le compactage des données de l'unité est effectué s'il est pris en charge par l'unité. Sinon, la compression des données est effectuée si elle est acceptée par l'unité.

Si *YES est précisé pour le paramètre DTACPR et *DEV pour ce paramètre, les opérations de compactage et de compression des données de l'unité sont toutes deux effectuées si elles sont acceptées par l'unité.

*NO

Le compactage des données par l'unité n'est pas effectué.

Sortie (OUTPUT)

Indique si le système crée une liste comportant des informations sur les objets sauvegardés. 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 liste de 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, QASAVOBJ, avec le nom de format QSRSAV 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 : Sauvegarde des objets

SAVCFG   DEV(TAP01)  CLEAR(*ALL)

Cette commande sauvegarde les objets de gestion des ressources système (données de ressources matériel et données de l'adaptateur en anneau à jeton), ainsi que tous les objets de configuration (y compris toutes les descriptions de ligne, contrôleur, unité, mode, classe de service, et réseau, les listes de configuration et les listes de connexion). Ils sont sauvegardés sur l'unité de bande TAP01. CLEAR(*ALL) met à blanc automatiquement toutes bandes qui ne le sont pas lorsqu'elles sont détectées.

Exemple 2 : Sauvegarde d'objets sur une bande spécifique

SAVCFG   DEV(TAP01)  VOL(ABC)

Cette commande sauvegarde les objets de gestion des ressources du système (SRM) et de configuration sur l'unité de bande TAP01, en commençant par le volume de bande dont le label est ABC. Si l'opération de sauvegarde dépasse la capacité de stockage d'une bande, un message demandant de placer un autre volume sur l'unité de bande TAP01 est envoyé.

Messages d'erreur

Messages *ESCAPE

CPF2206

Droit d'usage obligatoire pour exécuter la fonction demandée sur l'objet.

CPF222E

Le droit spécial &1 est requis.

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.

CPF3731

Impossible d'utiliser &2 &1 de la bibliothèque &3.

CPF3733

&2 &1 de &3 endommagé précédemment.

CPF3737

Zone de données de sauvegarde et restauration &1 non trouvée.

CPF376D

Objets de config sauvegardés partiellement dans fichier sauvegarde &3.

CPF376E

Objets de configuration non sauvegardés en totalité.

CPF3767

Unité &1 non trouvée.

CPF3768

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

CPF3782

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

CPF3793

Limite mémoire atteinte sur la machine ou dans l'ASP.

CPF3794

La sauvegarde ou la restauration n'a pas abouti.

CPF3812

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

CPF384E

USEOPTBLK(*YES) non admis pour le prématriçage de CD-ROM.

CPF388B

Nom du chemin d'accès au fichier optique incorrect.

CPF3894

Réponse d'annulation reçue pour message &1.

CPF5729

Allocation de l'objet &1 impossible.

CPF9809

Accès à la bibliothèque &1 impossible.

CPF9812

Fichier &1 non trouvé dans la bibliothèque &2.

CPF9845

Erreur lors de l'ouverture du fichier &1.

CPF9846

Erreur lors du traitement du fichier &1 de &2.

CPF9847

Erreur lors de la fermeture du fichier &1 de bibliothèque &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.