SAVOBJ

La commande SAVOBJ (Sauvegarder un objet) permet de sauvegarder un objet ou un groupe d'objets situés dans la même bibliothèque. Lorsque la valeur *ALL est spécifiée pour le paramètre OBJ (Objets), tous les objets peuvent être sauvegardés à partir d'une liste de bibliothèques. En revanche, lorsque vous utilisez un fichier sauvegarde, vous ne pouvez indiquer qu'une seule bibliothèque. Le système sauvegarde les objets indiqués en faisant une copie sur bande, sur disque optique ou bien dans un fichier sauvegarde. Cette opération n'a aucune incidence sur les objets se trouvant dans le système, à moins qu'une libération de mémoire secondaire ne soit demandée dans la commande. Par contre, chaque description est modifiée en fonction de la date, de l'heure et de l'emplacement de la dernière sauvegarde de l'objet correspondant, sauf si la valeur *NO est attribuée au paramètre UPDHST (Mise à jour historique).

Pour les files d'attente de travaux, les files d'attente utilisateur, les files d'attente de messages et les fichiers logiques, seules les descriptions d'objet sont sauvegardées ; leur contenu ne l'est pas. Cependant, les chemins d'accès des fichiers logiques peuvent être sauvegardés en attribuant la valeur *YES au paramètre ACCPTH (Sauvegarder chemins d'accès). Le contenu des fichiers spoule dans les files d'attente en sortie peut être sauvegardé en indiquant *ALL au paramètre SPLFDTA (Données de fichier spoule). Le contenu d'un fichier sauvegarde peut être sauvegardé en attribuant la valeur *YES au paramètre SAVFDTA (Données fichiers sauvegarde) ou en utilisant la commande SAVSAVFDTA (Sauvegarder les données d'un fichier sauvegarde). Le contenu d'une file d'attente de données peut être sauvegardé en indiquant *DTAQ au paramètre QDTA (Données de file d'attente).

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 (Sauvegarder le système) ou des droits sur les objets suivants :
  • droit *OBJEXIST sur chaque objet à sauvegarder (pour les données de fichier spoule, droit *OBJEXIST sur la file d'attente en sortie),
  • droit d'exécution (*EXECUTE) pour chaque bibliothèque à partir de laquelle les objets sont sauvegardés.
• Si vous ne disposez pas du droit spécial *SAVSYS, seuls les objets sur lesquels vous avez des droits sont sauvegardés.
• Pour pouvoir effectuer une sauvegarde sur bande ou unité optique, l'utilisateur doit disposer du droit d'utilisation de la description d'unité et du fichier unité. Lors d'une sauvegarde dans un fichier sauvegarde, l'utilisateur doit disposer des droits d'opération (*OBJOPR) et d'ajout (*ADD) sur le fichier sauvegarde, et du droit d'exécution sur la bibliothèque contenant le fichier sauvegarde.
• Lorsque vous utilisez une définition de support, vous devez disposer du droit *USE sur cette définition de support et du droit *EXECUTE sur la bibliothèque de cette définition de support.
• Cette commande ne sauvegarde pas le dictionnaire de données pour la bibliothèque ou les fichiers base de données qui lui sont associés. Pour les sauvegarder, il convient d'utiliser la commande SAVLIB.
• Lorsque vous utilisez le paramètre OUTFILE avec un fichier base de données existant, vous devez disposer du droit d'exécution sur la bibliothèque du fichier en sortie.
• Dans le cas d'une sauvegarde sur bande, un volume à label standard doit être placé dans l'unité.
• Aucun objet en cours de sauvegarde ne peut être modifié par un travail en cours d'exécution, sauf si la fonction de sauvegarde en mise à jour est utilisée.
• Lorsque le contenu d'un fichier sauvegarde est sauvegardé dans le même fichier sauvegarde à l'aide du paramètre SAVFDTA(*YES), seule la description de ce fichier est sauvegardée.
• Lorsque le contenu d'un fichier sauvegarde est sauvegardé avec SAVFDTA(*YES), ce fichier sauvegarde doit être restauré avant les objets qu'il contient.
• Lorsque vous utilisez le paramètre CMDUSRSPC (Espace utilisateur de commande), vous devez disposer du droit *USE sur l'espace utilisateur et du droit *EXECUTE sur la bibliothèque de l'espace utilisateur.

Paramètres

Objets (OBJ)

Indique le nom d'un ou de plusieurs objets, ou le nom générique de chaque groupe d'objets à sauvegarder. Tous les objets doivent figurer dans la bibliothèque indiquée au paramètre LIB (Bibliothèque). Si la valeur *ALL est indiquée ou utilisée par défaut pour le paramètre OBJTYPE (Types d'objets), tous les types d'objet répertoriés dans la description de ce paramètre sont sauvegardés, à condition qu'ils figurent dans la bibliothèque spécifiée et qu'ils portent les noms définis.

Ce paramètre est obligatoire.

Valeurs uniques

*ALL

Tous les objets de la bibliothèque indiquée sont sauvegardés en fonction des valeurs précisées pour le paramètre OBJTYPE.

Autres valeurs (jusqu'à 300 répétitions)

nom-générique

Entrez un ou plusieurs noms génériques d'objets de la bibliothèque à sauvegarder. 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 d'objet.

nom

Indiquez un ou plusieurs noms d'objets spécifiques à sauvegarder. Une commande peut comporter à la fois des noms génériques et spécifiques.

Bibliothèque (LIB)

Indique le nom des bibliothèques qui contiennent les objets à sauvegarder. Si la valeur *ALL est attribuée au paramètre OBJ (Objets), vous pouvez indiquer jusqu'à 300 bibliothèques.

Ce paramètre est obligatoire.

Valeurs uniques

*SELECT

Les bibliothèques identifiées au paramètre Sélection (SELECT) sont sauvegardées. Une seule bibliothèque peut être indiquée dans le critère de sélection lors d'une sauvegarde dans un fichier sauvegarde. La valeur spéciale *SPLF ne peut pas être spécifiée dans le critère de sélection.

*USRSPC

Les bibliothèques identifiées dans l'espace utilisateur indiqué au paramètre CMDUSRSPC (Espace utilisateur de commande) sont sauvegardées. Une seule bibliothèque peut être indiquée dans l'espace utilisateur lors d'une sauvegarde dans un fichier sauvegarde. La valeur spéciale *SPLF ne peut pas être spécifiée dans l'espace utilisateur.

Autres valeurs (jusqu'à 300 répétitions)

nom-générique

Indiquez le nom générique des bibliothèques qui contiennent les objets à sauvegarder. Un nom générique est une chaîne d'un ou de plusieurs caractères suivie d'un astérisque (*) ; ABC*, par exemple. L'astérisque (*) remplace tout caractère admis. Un nom générique indique toutes les bibliothèques dont le nom commence par ce préfixe générique et sur lesquelles l'utilisateur dispose de droits. 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 de bibliothèque complet.

Remarque :Un nom générique de bibliothèque ne peut pas être indiqué lors d'une sauvegarde dans un fichier sauvegarde.

nom

Indique le nom de la bibliothèque qui contient les objets à sauvegarder.

Remarque :Une seule bibliothèque peut être indiquée lors d'une sauvegarde dans un fichier sauvegarde.

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

*MEDDFN

L'opération de sauvegarde est effectuée sur les unités et supports indiqués dans la définition de support précisée à l'invite Définition de support (paramètre MEDDFN).

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. Pour pouvoir utiliser plusieurs unités de bande en parallèle, vous devez indiquer une définition de support.

Types d'objets (OBJTYPE)

Indique le type des objets système à sauvegarder.

Valeurs uniques

*ALL

Tous les types d'objets désignés se trouvant dans la bibliothèque indiquée sont sauvegardés. Si *ALL est également indiqué pour le paramètre OBJ (Objets), tous les objets de la bibliothèque qui correspondent aux types pouvant être sauvegardés font l'objet de la sauvegarde.

Autres valeurs (jusqu'à 300 répétitions)

type-objet

Entrez le type d'objet à restaurer, c'est-à-dire une valeur telle que *CMD (commande), *FILE (fichier) ou *PGM (programme).

Pour obtenir la liste complète des types d'objet, placez le curseur dans la zone de ce paramètre et appuyez sur F4 (Invite). Pour obtenir une description des types d'objet, reportez-vous à "Types d'objet" dans Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

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.

Label (LABEL)

Indique le nom qui identifie le fichier de données sur le volume de bande à utiliser pour l'opération de sauvegarde. Si ce paramètre est indiqué dans la commande de sauvegarde, le même label doit être entré dans la commande de restauration.

Remarque :Vous ne pouvez pas préciser *SAVLIB pour ce paramètre, car il s'agit d'une valeur spécifique de l'invite Label (paramètre LABEL) de la commande de restauration qui vous empêcherait de restaurer ce que vous avez sauvegardé.

*LIB

Le système génère un label de fichier à l'aide du nom de la bibliothèque indiqué à l'invite Bibliothèque (paramètre LIB).

valeur-alphanumérique

Indiquez l'identificateur du fichier de données utilisé pour la sauvegarde. Vous pouvez utiliser 17 caractères au maximum. Cette option est admise pour la sauvegarde d'une seule bibliothèque.

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.

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

Définition de support (MEDDFN)

Indique l'objet de définition du support (*MEDDFN) qui identifie les unités et supports utilisés pour contenir les données sauvegardées. Pour plus d'informations sur la création et l'utilisation d'une définition de support, reportez-vous au manuel Reprise du système, SC41-5304 et à l'API de création de définition de support dans le manuel Ensemble de rubriques API de la catégorie Programmation de l'IBM i Information Center (http://www.ibm.com/systems/i/infocenter/).

Si une définition de support est indiquée, aucune valeur ne peut être spécifiée aux paramètres VOL, SEQNBR, SAVF et OPTFILE, car Les identificateurs et numéros de séquence des volumes figurent déjà dans la définition de support.

Qualificatif 1 : Définition de support

nom

Indiquez le nom de la définition de support à 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

La recherche porte sur la bibliothèque en cours de l'unité d'exécution. Si aucune bibliothèque n'est définie comme bibliothèque en cours pour l'unité d'exécution, la recherche porte sur la bibliothèque QGPL.

nom

Indiquez le nom de la bibliothèque dans laquelle doit s'effectuer la recherche.

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.

'nom-de-chemin-du-fichier-optique'

Indiquez le nom de chemin du fichier optique.

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.

Edition cible (TGTRLS)

Indique l'édition du système d'exploitation sur laquelle l'objet sera restauré et utilisé.

Lorsque vous indiquez la valeur édition-cible, le format VxRxMx est utilisé pour préciser l'édition. Vx indique la version, Rx l'édition et Mx le niveau de modification. Par exemple, V5R3M0 correspond à la version 5, édition 3, modification 0.

Les valeurs admises dépendent de la version, de l'édition et du niveau de modification du système d'exploitation, et changent à chaque nouvelle édition. Appuyez sur F4 à l'invite de ce paramètre de commande pour afficher la liste des valeurs admises.

Pour indiquer qu'un objet doit être sauvegardé afin d'être distribué sur un système dont le niveau d'édition est différent de celui sur lequel la sauvegarde est effectuée, la procédure varie selon que les objets sont ou non des programmes et selon le niveau d'édition utilisé lors de la création du programme. Par exemple, si vous sauvegardez un objet afin de le distribuer sur un système cible dont l'édition est antérieure, les choix possibles sont les suivants :

Pour les objets programme :

• Si l'objet programme a été créé à un niveau d'édition plus récent que l'édition précédente ciblée, vous devez :
  1. créer de nouveau l'objet programme en précisant l'édition précédente ciblée,
  2. sauvegarder l'objet programme en précisant l'édition précédente ciblée,
  3. restaurer l'objet programme sur le système cible.
• Si l'objet programme a été créé au même niveau d'édition que le système cible, vous pouvez :
  1. sauvegarder l'objet programme en précisant l'édition précédente ciblée,
  2. restaurer l'objet programme sur le système cible.

Pour les autres objets :

Vous pouvez :

1. sauvegarder l'objet en précisant l'édition en indiquant l'édition précédente ciblée,
2. restaurer l'objet sur le système cible.

*CURRENT

L'objet sera restauré et utilisé sur l'édition en cours du système d'exploitation installée sur votre système. Cet objet pourra également être restauré sur toute édition suivante qui sera installée sur ce système.

*PRV

L'objet sera restauré sur l'édition précédente, niveau de modification 0, du système d'exploitation. Cet objet pourra également être restauré sur toute édition suivante qui sera installée sur ce système.

valeur-alphanumérique

Indiquez l'édition au format VxRxMx. L'objet pourra être restauré sur un système doté de celle-ci ou de toute édition suivante du système d'exploitation.

Mise à jour historique (UPDHST)

Indique si l'historique de sauvegarde relatif à chaque objet est modifié en fonction de la date, de l'heure et du lieu de cette sauvegarde. Cet historique s'affiche à l'aide de la commande DSPOBJD. L'historique de sauvegarde sert à déterminer quels postes de journal ont été traités lorsque RCVRNG(*LASTSAVE) et FROMENT(*LASTSAVE) ou FROMENTLRG(*LASTSAVE) sont utilisés dans la commande APYJRNCHG.

*YES

Les dernières informations relatives à la date, à l'heure et à l'emplacement de sauvegarde sont mises à jour dans chaque objet sauvegardé.

*NO

Dans les descriptions des objets sauvegardés, les informations sur la sauvegarde ne sont pas mises à jour.

Remarque :Lorsqu'une opération de sauvegarde n'est pas destinée à une reprise, UPDHST(*NO) doit être utilisé. Par exemple, si les données sauvegardées sont envoyées, enregistrement par enregistrement, à un autre système et que le fichier sauvegarde est immédiatement supprimé, les informations d'historique de sauvegarde ne devront probablement pas être mises à jour.

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)

Indique si la sauvegarde d'une bibliothèque s'arrête ou non dans l'une des situations suivantes :

1. les objets n'existent pas,
2. la bibliothèque ou les objets ont été endommagés,
3. la bibliothèque ou les objets sont verrouillés par un autre travail,
4. le demandeur de la sauvegarde ne dispose pas des droits sur la bibliothèque ou du droit de sauvegarde des objets.

*NO

La sauvegarde de la bibliothèque se poursuit, mais uniquement pour les objets pouvant être sauvegardés.

*YES

Si un ou plusieurs objets ne peuvent être sauvegardés après la vérification de tous les objets indiqués, la sauvegarde de la bibliothèque s'interrompt avant toute opération d'écriture de données. Si plusieurs bibliothèques sont indiquées, la sauvegarde de la bibliothèque suivante commence. Toutefois, si PRECHK(*YES) et SAVACT(*SYNCLIB) sont précisés et qu'un objet d'une bibliothèque à sauvegarder ne répond pas aux conditions préalables, la sauvegarde s'interrompt et aucun objet n'est sauvegardé.

Sauvegarde en mise à jour (SAVACT)

Indique si un objet peut être mis à jour au cours de sa sauvegarde.

Remarque :Si votre système est à l'état restreint et que le paramètre SAVACT est défini, la sauvegarde s'effectue comme si SAVACT(*NO) était spécifié.

*NO

Les objets en cours d'utilisation ne sont pas sauvegardés. Les objets ne peuvent pas être mis à jour lorsqu'ils sont en cours de sauvegarde.

*LIB

Les objets d'une bibliothèque peuvent être sauvegardés alors qu'ils sont utilisés par un autre travail. Tous les objets d'une bibliothèque atteignent un point de contrôle simultanément et sont sauvegardés dans un état cohérent les uns par rapport aux autres.

*SYNCLIB

Les objets d'une bibliothèque peuvent être sauvegardés alors qu'ils sont utilisés par un autre travail. Tous les objets et bibliothèques de l'opération de sauvegarde atteignent un point de contrôle simultanément et sont sauvegardés dans un état cohérent les uns par rapport aux autres.

Remarque :Si vous définissez cette valeur et que vous sauvegardez un grand nombre de bibliothèques, l'atteinte d'un point de contrôle peut prendre un laps de temps important pour tous les objets et bibliothèques de l'opération de sauvegarde.

*SYSDFN

Les objets d'une bibliothèque peuvent être sauvegardés alors qu'ils sont utilisés par un autre travail. Il est possible que les objets d'une bibliothèque atteignent un point de contrôle à différents moments et qu'ils ne se trouvent pas dans un état cohérent les uns par rapport aux autres.

Temps d'attente si mise à jour (SAVACTWAIT)

Définit le délai d'attente pour qu'un objet en cours d'utilisation ou pour que des transactions comportant des modifications en attente atteignent la limite de validation, avant de poursuivre l'opération de sauvegarde.

Elément 1 : Verrouillage des objets

Définit, pour chaque objet en cours d'utilisation, le délai d'attente de mise à disposition de l'objet. Si un objet reste utilisé pendant le délai défini, il n'est pas sauvegardé.

120

Le système attend pendant un délai de jusqu'à 120 secondes pour que le verrouillage de chaque objet s'effectue, avant de poursuivre l'opération de sauvegarde.

*NOMAX

Pas de délai d'attente maximum.

0-99999

Définit le délai d'attente en secondes pendant lequel le verrouillage de chaque objet s'effectue, avant de poursuivre l'opération de sauvegarde.

Elément 2 : Modif enreg en instance

Définit, pour chaque groupe d'objets contrôlés simultanément, le délai d'attente pour que les transactions comportant des modifications en attente atteignent une limite de validation. Le paramètre SAVACT (Sauvegarde en mise à jour) détermine les objets contrôlés simultanément. Si la valeur 0 est définie, tous les objets en cours de sauvegarde doivent se trouver à des limites de validation. Si toute autre valeur est définie, tous les objets consignés dans les mêmes fichiers journaux que les objets en cours d'enregistrement doivent atteindre des limites de validation. Si une limite de validation n'est pas atteinte dans le délai imparti, l'opération de sauvegarde prend fin, à moins que la valeur *NOCMTBDY ne soit définie.

*LOCKWAIT

Le système attend l'équivalent de la valeur définie pour Elément 1 jusqu'à ce que les transactions comportant des modifications en attente atteignent une limite de validation.

*NOCMTBDY

Le système sauvegarde les objets sans exiger que les transactions comportant des modifications en attente n'atteignent une limite de validation. Par conséquent, les objets peuvent être sauvegardés avec des transactions partielles.

Si vous restaurez un objet sauvegardé avec des transactions partielles, vous ne pouvez pas utiliser ce dernier avant d'avoir appliqué ou supprimé les modifications de journal (commande APYJRNCHG ou RMVJRNCHG) pour atteindre les limites de validation. Pour cela, tous les récepteurs de journal contenant des informations sur les transactions partielles doivent appliquer ou supprimer les modifications. Jusqu'à ce que vous appliquiez ou supprimiez les modifications, toute sauvegarde future de cet objet inclura les transactions partielles, même si vous ne définissez pas *NOCMTBDY.

*NOMAX

Pas de délai d'attente maximum.

0-99999

Définit le délai d'attente en secondes pour que les transactions comportant des modifications en attente n'atteignent une limite de validation.

Elément 3 : Autres modif en instance

Définit, pour chaque bibliothèque, le délai d'attente pour que les transactions comportant d'autres modifications en attente atteignent une limite de validation. Les autres modifications en attente sont les suivantes :

• Modifications de niveau d'objet langage de définition de données (LDD) pour cette bibliothèque.
• Toute ressource de validation API ajoutée sans l'option d'activation de traitement de sauvegarde normal. Pour plus d'informations, consultez la rubrique Add Commitment Resource (QTNADDCR) API dans Ensemble de rubriques API de la catégorie Programmation de l'IBM i Information Center (http://www.ibm.com/systems/i/infocenter/).

Si une bibliothèque n'atteint pas une limite de validation, cette bibliothèque n'est pas sauvegardée.

*LOCKWAIT

Le système attend l'équivalent de la valeur définie pour Elément 1 jusqu'à ce que les types de transactions mentionnés ci-dessus atteignent une limite de validation.

*NOMAX

Pas de délai d'attente maximum.

0-99999

Définissez le délai d'attente en secondes pour que les types de transactions mentionnés ci-dessus atteignent une limite de validation.

Si 0 est défini et qu'un seul nom est spécifié pour le paramètre OBJ (Objets), et que *FILE est la seule valeur définie pour le paramètre OBJTYPE (Types d'objets), le système sauvegarde l'objet sans exiger que les types de transactions mentionnés ci-dessus n'atteignent une limite de validation.

File attente messages si màj (SAVACTMSGQ)

Indique la file d'attente de messages utilisée par l'opération de sauvegarde pour signaler à l'utilisateur que le traitement du point de contrôle est terminé pour une bibliothèque. Un message distinct est envoyé pour chaque bibliothèque à enregistrer lorsque la valeur *SYSDFN ou *LIB est définie pour le paramètre SAVACT (Sauvegarde en mise à jour). Lorsque *SYNCLIB est défini pour le paramètre SAVACT, un message est envoyé pour toutes les bibliothèques de l'opération de sauvegarde.

Ce paramètre peut être utilisé pour sauvegarder les objets à une limite connue et cohérente, afin d'éviter d'avoir recours à des procédures de reprise supplémentaires après une opération de restauration. Les applications peuvent être arrêtées jusqu'à réception du message de traitement de point de contrôle.

Valeurs uniques

*NONE

Aucun message de notification n'est envoyé.

*WRKSTN

Le message de notification est envoyé à la file d'attente de messages du poste de travail. Cette valeur est incorrecte en mode de traitement par lots.

Qualificatif 1 : File attente messages si màj

nom

Indiquez le nom de la file d'attente de messages à 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

La recherche de la file d'attente de messages porte sur la bibliothèque en cours du travail. Si aucune bibliothèque n'est définie en tant que bibliothèque actuelle pour le travail, la bibliothèque QGPL est utilisée.

nom

Indiquez le nom de la bibliothèque dans laquelle figure la file d'attente de messages.

ID synchronisation (SYNCID)

Indique le nom du point de contrôle synchronisé dans lequel cette opération de sauvegarde en cours d'activité a lieu. Le point de contrôle synchronisé doit déjà être lancé par la commande Lancer synchro de sauvegarde (STRSAVSYNC).

*NONE

Le point de contrôle de cette opération de sauvegarde en cours d'activité n'est pas synchronisé avec les autres opérations de sauvegarde en cours d'activité éventuelles.

nom

Indiquez le nom du point de contrôle synchronisé. Si vous indiquez un nom, vous devez également indiquer la valeur de *SYNCLIB pour le paramètre Sauvegarde en mise à jour (SAVACT).

Remarque :Si vous indiquez un nom, la valeur du paramètre Temps d'attente si mise à jour (SAVACTWAIT)Elément 2 : Modif enreg en instance est la valeur la plus importante indiquée entre toutes les opérations de sauvegarde qui ont lieu. Cependant, si une opération de sauvegarde indique l'option *NOCMTBDY, toutes les opérations de sauvegarde qui ont lieu doivent indiquer *NOCMTBDY.

Membre du fichier (FILEMBR)

Indique les membres de fichier base de données à sauvegarder. Ce paramètre est composé de deux parties : le nom de fichier et le nom de membre.

Chaque fichier base de données indiqué ici doit également figurer dans le paramètre OBJ (Objets), où il peut être désigné par son nom entier, par un nom générique ou bien par la valeur *ALL. La valeur du paramètre OBJTYPE (Types d'objets) doit être *ALL ou inclure *FILE.

Remarque :Ce paramètre est incompatible avec STG(*FREE).

Elément 1 : Fichier

*ALL

La liste des noms de membres qui figure à la suite s'applique à tous les fichiers désignés dans le paramètre OBJ.

nom

Indiquez le nom du fichier base de données à partir duquel les membres de la liste sont sauvegardés. Vous pouvez préciser jusqu'à 50 fichiers, chacun disposant d'une liste de membres.

Remarque :Les noms génériques ne sont pas admis pour les noms de fichiers base de données mais ils le sont pour les noms de membre.

Remarque :Vous ne pouvez pas indiquer deux fois le même nom de fichier.

Elément 2 : Membre

Valeurs uniques

*ALL

Tous les membres sont sauvegardés à partir du fichier indiqué.

*NONE

Aucun membre n'est sauvegardé à partir du fichier indiqué. Seule la description de fichier est sauvegardée.

Autres valeurs (jusqu'à 50 répétitions)

nom-générique

Entrez les noms génériques des membres à sauvegarder à partir du fichier indiqué. 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 le nom entré est un nom spécifique de membre.

Remarque :Si des noms de membre génériques sont indiqués, le fichier doit contenir des noms correspondants pour être sauvegardé. Par exemple, si PAY* est indiqué comme nom de membre générique et que le système ne parvient pas à retrouver un membre dont le nom commence par PAY, le fichier n'est pas sauvegardé. Si des fichiers associés au paramètre FILEMBR ne sont pas sauvegardés car des membres correspondant au nom générique sont introuvables, un message de diagnostic est envoyé, l'opération de sauvegarde prend fin et un message d'arrêt programme indiquant le nombre de fichiers non sauvegardés est envoyé. Si au moins l'un des fichiers traités pour le paramètre FILEMBR contient un membre correspondant au nom générique indiqué, le message de diagnostic n'est pas envoyé et le nombre de fichiers non sauvegardés apparaît dans le message d'achèvement final.

nom

Précisez le nom des membres à sauvegarder à partir du fichier indiqué.

Remarque :Si des noms de membre spécifiques sont indiqués, les membres précisés doivent exister dans le fichier ou la partie de fichier à sauvegarder ou restaurer.

Sauvegarder chemins d'accès (ACCPTH)

Indique si les chemins d'accès de fichier logique basés sur les fichiers physiques en cours de sauvegarde sont également sauvegardés. Les chemins d'accès ne sont sauvegardés que dans les cas suivants :

• Tous les membres sur lesquels les chemins d'accès sont construits sont inclus dans la sauvegarde.
• Les chemins d'accès ne sont ni incorrects ni endommagés au moment de la sauvegarde.

Le système vérifie l'intégrité des chemins d'accès. Toute anomalie détectée par le système provoque la reconstruction du chemin d'accès correspondant.

Des messages d'information sont envoyés, indiquant le nombre de chemins d'accès de fichiers logiques sauvegardés avec chaque fichier physique. Tous les fichiers physiques sur lesquels un chemin d'accès est construit doivent se trouver dans la même bibliothèque. Ce paramètre ne sauvegarde pas les fichiers logiques. Il contrôle uniquement la sauvegarde des chemins d'accès. Pour plus d'informations sur la restauration des chemins d'accès sauvegardés, reportez-vous au manuel Reprise du système, SC41-5304.

ATTENTION : Si les fichiers physiques sous-jacents et les fichiers logiques se trouvent dans des bibliothèques différentes, les chemins d'accès sont sauvegardés. Cependant, si les fichiers logiques et les fichiers physiques sous-jacents sont stockés dans des bibliothèques différentes et que les uns ou les autres n'existent pas au moment de la restauration (en cas de reprise après un incident grave, par exemple ou suppression des fichiers), les chemins d'accès ne sont pas restaurés. Ils sont recréés. Pour que l'opération de restauration des fichiers logiques soit la plus rapide possible, ces fichiers ainsi que les fichiers physiques sous-jacents doivent être placés dans la même bibliothèque et sauvegardés en même temps.

*SYSVAL

La valeur système QSAVACCPTH détermine si les chemins d'accès des fichiers logiques, basés sur les fichiers physiques en cours de sauvegarde, doivent également être sauvegardés.

*NO

Seuls les objets indiqués dans la commande sont sauvegardés. Aucun chemin d'accès de fichier logique n'est sauvegardé.

*YES

Les fichiers physiques et tous les chemins d'accès de fichier logique correspondants sont sauvegardés.

Remarque :Cette valeur n'implique pas la sauvegarde des fichiers logiques.

Données fichiers sauvegarde (SAVFDTA)

Indique, pour les objets d'un fichier sauvegarde, si seule la description de celui-ci, ou également son contenu, sont sauvegardés.

*YES

Sauvegarde la description et le contenu d'un fichier sauvegarde.

*NO

Seule la description d'un fichier sauvegarde est sauvegardée.

Données de fichier spoule (SPLFDTA)

Permet d'indiquer si les données et les attributs de fichier spoule doivent être sauvegardés pour les files d'attente en sortie sauvegardées.

*NONE

Aucune donnée de fichier spoule n'est sauvegardée.

*ALL

Toutes les données de fichier spoule disponibles dans chaque file d'attente en sortie sauvegardée sont sauvegardées.

Données de file d'attente (QDTA)

Permet d'indiquer, pour des objets de file d'attente, si la description seulement ou à la fois la description et le contenu d'une file d'attente, doivent être sauvegardés.

*NONE

Seule la description d'une file d'attente est sauvegardée.

*DTAQ

La description et le contenu d'une file d'attente de données standard sont sauvegardés. Seule la description d'une file d'attente de données DDM est sauvegardée.

Droits privés (PVTAUT)

Indique si les droits privés doivent être sauvegardés avec les objets sauvegardés. La sauvegarde des droits privés augmente le temps de sauvegarde des objets, mais elle peut simplifier la récupération d'un objet ou d'un groupe d'objets. Elle ne simplifie pas la récupération d'un système complet.

*NO

Aucun droit privé n'est sauvegardé.

*YES

Les droits privés sont sauvegardés pour chaque objet sauvegardé.

Remarque :Vous devez disposer du droit spécial *SAVSYS (Sauvegarder le système) ou *ALLOBJ (Tous les objets) pour indiquer cette valeur.

Mémoire secondaire (STG)

Indique si la mémoire secondaire du système occupée par la partie données des membres indiqués (à l'exception des fichiers sauvegarde), des modules, des programmes, des programmes de service, des modules SQL (Structured Query Language) et des récepteurs de journal de la bibliothèque sauvegardés est libérée lors de la sauvegarde. Seule la partie données des objets est libérée, et non leur description.

*KEEP

L'espace mémoire occupé par la partie données des objets en cours de sauvegarde n'est pas libéré.

*FREE

La mémoire secondaire occupée par la partie données des objets indiqués est libérée lors de leur sauvegarde. La mémoire allouée à tous les objets d'une bibliothèque est libérée uniquement lorsque la sauvegarde de tous les objets a abouti.

Remarque :Pour éviter une éventuelle fin anormale d'un programme, le programme en cours de sauvegarde ne doit pas être exécuté sur le système si *FREE est indiqué.

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

Bibliothèques à omettre (OMITLIB)

Indique le nom d'une ou de plusieurs bibliothèques ou les noms génériques de chaque groupe de bibliothèques à exclure de l'opération de sauvegarde.

Valeurs uniques

*NONE

Aucune bibliothèque n'est exclue de l'opération de sauvegarde.

*USRSPC

Les bibliothèques identifiées dans l'espace utilisateur indiqué au paramètre CMDUSRSPC (Espace utilisateur de commande) sont exclues de l'opération de sauvegarde.

Autres valeurs (jusqu'à 300 répétitions)

nom-générique

Indiquez le nom générique des bibliothèques à exclure. Un nom générique est une chaîne d'un ou de plusieurs caractères suivie d'un astérisque (*) ; ABC*, par exemple. L'astérisque (*) remplace tout caractère admis. Un nom générique indique toutes les bibliothèques dont le nom commence par ce préfixe générique et sur lesquelles l'utilisateur dispose de droits. 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 de bibliothèque complet.

nom

Indiquez le nom de la bibliothèque à exclure de l'opération de sauvegarde.

Objets à omettre (OMITOBJ)

Indique les objets à exclure de l'opération. Vous pouvez indiquer jusqu'à 300 objets ou objets génériques.

Valeurs uniques

*USRSPC

Les objets identifiés dans l'espace utilisateur indiqué au paramètre CMDUSRSPC (Espace utilisateur de commande) sont exclus de l'opération de sauvegarde.

Autres valeurs (jusqu'à 300 répétitions)

Elément 1 : Objet

Qualificatif 1 : Objet

*NONE

Aucun objet n'est exclu de l'opération.

*ALL

Tous les objets du type défini sont exclus de l'opération.

nom-générique

Indiquez le nom générique des objets à exclure.

Remarque :Un nom générique est indiqué sous la forme d'une chaîne d'un ou plusieurs caractères suivis d'un astérisque (*). Si un nom générique est spécifié, tous les noms d'objets ayant le même préfixe que le nom générique seront sélectionnés.

nom

Indiquez le nom de l'objet à exclure de l'opération.

Qualificatif 2 : Biblio

*ALL

Les objets indiqués sont exclus de toutes les bibliothèques faisant partie de l'opération.

nom-générique

Indiquez le nom générique des bibliothèques qui contiennent les objets à exclure.

Remarque :Un nom générique est indiqué sous la forme d'une chaîne d'un ou plusieurs caractères suivis d'un astérisque (*). Si un nom générique est spécifié, tous les noms d'objets ayant le même préfixe que le nom générique seront sélectionnés.

nom

Indiquez le nom de la bibliothèque contenant l'objet à exclure de l'opération.

Elément 2 : Type d'objet

*ALL

Tous les types d'objet sont exclus de l'opération, en fonction de la valeur indiquée pour le nom d'objet.

valeur-alphanumérique

Indiquez le type des objets à exclure de l'opération.

Pour obtenir la liste complète des types d'objet, placez le curseur dans la zone de ce paramètre et appuyez sur F4 (Invite). Pour obtenir une description des types d'objet, reportez-vous à "Types d'objet" dans Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Sélection (SELECT)

Indique le critère de sélection des objets à sauvegarder. Vous pouvez effectuer une sélection parmi les objets spécifiés aux paramètres Objets (OBJ), Bibliothèque (LIB) et Types d'objets (OBJTYPE).

Valeurs uniques

*USRSPC

Le critère de sélection identifié dans l'espace utilisateur indiqué au paramètre Espace utilisateur de commande (CMDUSRSPC) est utilisé.

Autres valeurs (jusqu'à 300 répétitions)

Elément 1 : Inclure ou omettre

Indique si les objets sélectionnés doivent être inclus ou omis de l'opération de sauvegarde.

*INCLUDE

Les objets sélectionnés sont sauvegardés, sauf s'ils sont remplacés via une spécification *OMIT ou omis via le paramètre Bibliothèques à omettre (OMITLIB) ou Objets à omettre (OMITOBJ).

*OMIT

Les objets sélectionnés ne sont pas inclus dans l'opération de sauvegarde.

Elément 2 : Objet

Qualificatif 1 : Objet

*ALL

Tous les noms d'objet spécifiés au paramètre Objets (OBJ) sont sélectionnés.

nom-générique

Indiquez le nom générique des objets à sélectionner.

Remarque :Un nom générique est indiqué sous la forme d'une chaîne d'un ou plusieurs caractères suivis d'un astérisque (*). Si un nom générique est spécifié, tous les noms d'objets ayant le même préfixe que le nom générique seront sélectionnés.

nom

Indiquez le nom de l'objet à sélectionner.

Qualificatif 2 : Biblio

*ALL

Tous les noms de bibliothèque indiqués au paramètre Bibliothèque (LIB) sont sélectionnés.

nom-générique

Indiquez le nom générique des bibliothèques à sélectionner.

nom

Indiquez le nom de la bibliothèque à sélectionner.

Elément 3 : Type d'objet

*ALL

Tous les types d'objet indiqués au paramètre Types d'objets (OBJTYPE) sont sélectionnés.

valeur-alphanumérique

Indiquez le type d'objet à sélectionner.

Pour obtenir la liste complète des types d'objet, placez le curseur dans la zone de ce paramètre et appuyez sur F4 (Invite). Pour obtenir une description des types d'objet, reportez-vous à "Types d'objet" dans Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Elément 4 : Attribut d'objet

*ALL

Tous les attributs d'objet sont sélectionnés.

*BLANK

Seuls les objets sans valeur d'attribut sont sélectionnés.

valeur-attribut

Indiquez l'attribut des objets à sélectionner.

valeur-attribut-générique

Indiquez l'attribut générique des objets à sélectionner.

Elément 5 : Membre du fichier

Indique les membres de fichier base de données à sélectionner.

Si *ALL est spécifié, les objets sélectionnés par les éléments précédents sont inclus ou omis.

Si une valeur autre que *ALL est spécifiée, le paramètre Membre du fichier (FILEMBR) ne peut pas être indiqué. Les objets sélectionnés par les éléments précédents sont inclus, même s'il ne s'agit pas de fichiers base de données. Si les objets sélectionnés sont des fichiers base de données, les membres de fichier sélectionnés sont inclus ou omis.

*ALL

Tous les membres de fichier sont sélectionnés. Pour une spécification *OMIT, le fichier ou l'objet sélectionné est également omis.

*ALLMBR

Tous les membres de fichier sont sélectionnés. Pour une spécification *OMIT, le fichier ou l'objet sélectionné est inclus et tous les membres de fichier sont omis.

nom-générique

Indiquez le nom générique des membres de fichier à sélectionner. Le fichier ou l'objet sélectionné est inclus même s'il ne contient pas les membres spécifiés.

nom

Indiquez le nom du membre de fichier à sélectionner. Le fichier ou l'objet sélectionné est inclus même s'il ne contient pas le membre spécifié.

Unité ASP (ASPDEV)

Indique l'unité ASP à inclure dans l'opération de sauvegarde. Ce paramètre est utilisé pour créer une sous-liste des objets répondant aux critères du paramètre OBJ de la commande SAV.

*

L'opération inclut l'ASP système (ASP numéro 1), tous les ASP utilisateur de base (ASP numéros 2 à 32) et, si l'unité d'exécution a un groupe ASP, tous les ASP indépendants de ce groupe ASP.

*SYSBAS

L'ASP système et tous les ASP utilisateur de base sont inclus dans l'opération de sauvegarde.

*CURASPGRP

Si l'unité d'exécution en cours a un groupe ASP, tous les ASP indépendants du groupe ASP sont inclus dans l'opération de sauvegarde.

nom

Indiquez le nom de l'unité ASP à inclure dans l'opération de sauvegarde.

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

Type d'information (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 à sauvegarder.

*ERR

La liste contient des informations sur la commande, un poste pour chaque bibliothèque et un poste pour chaque objet dont la sauvegarde a échoué.

*LIB

La liste contient un poste pour chaque bibliothèque à sauvegarder.

*MBR

La liste contient un poste pour chaque objet, membre de fichier base de données et fichier spoule à sauvegarder.

Espace utilisateur de commande (CMDUSRSPC)

Indique un espace utilisateur contenant les valeurs pour les paramètres dont la valeur est *USRSPC pour cette commande. L'espace utilisateur admet jusqu'à 32767 valeurs de liste pour chaque paramètre alors que les paramètres de commande n'acceptent que 300 valeurs de liste au maximum. L'espace utilisateur doit définir les paramètre au format utilisé par l'API QSRSAVO.

Qualificatif 1 : Espace utilisateur

nom

Indiquez le nom de l'espace utilisateur contenant les valeurs pour les paramètres dont la valeur est *USRSPC pour cette commande.

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

La recherche de l'espace utilisateur s'effectue dans la bibliothèque en cours du travail. Si aucune bibliothèque n'est définie en tant que bibliothèque actuelle pour le travail, la bibliothèque QGPL est utilisée.

nom

Indiquez le nom de la bibliothèque dans laquelle se trouve l'espace utilisateur.

Exemples

Exemple 1 : Sauvegarde de programme et de fichier ayant le même nom

SAVOBJ   OBJ(PETE)  LIB(LIBX)  DEV(TAP01)

Cette commande sauvegarde les objets nommés PETE qui se trouvent dans la bibliothèque LIBX. Si, par exemple, LIBX contient un programme et un fichier nommés PETE, les deux objets sont sauvegardés. La mémoire occupée par l'objet n'est pas libérée, car la valeur par défaut du paramètre STG est *KEEP.

Exemple 2 : Libération de la mémoire système

SAVOBJ   OBJ(MSTRPAY PAY*)  LIB(QGPL)  DEV(TAP01)  STG(*FREE)

L'objet MSTRPAY, et tous les objets dont les noms commencent par les caractères PAY situés dans la bibliothèque générale (QGPL), sont sauvegardés. Dans le cadre de l'opération de sauvegarde, la mémoire système qui était occupée par la partie données des objets membre, module, programme, programme de service, module SQL et récepteur de journal sauvegardés est libérée.

Exemple 3 : Sauvegarde du fichier sur volume optique

SAVOBJ   OBJ(FILEA)  OBJTYPE(*FILE)  LIB(LIBY)  DEV(OPT01)
         VOL(TOM)  CLEAR(*REPLACE)

Le fichier FILEA de la bibliothèque LIBY est sauvegardé dans un fichier avec le nom de bibliothèque LIBY sur le volume optique identifié par l'identificateur de volume TOM. Si le fichier LIBY existe déjà sur le volume optique, il est remplacé automatiquement lorsque FILEA est sauvegardé.

Exemple 4 : Sauvegarde d'objets pris en charge sur des versions précédentes

SAVOBJ   OBJ(PAY*)  LIB(LIB1)  DEV(TAP01)  TGTRLS(*PRV)

Cette commande sauvegarde les objets commençant par les caractères PAY depuis la bibliothèque LIB1 dans un format compatible avec l'édition précédente du système d'exploitation. Seuls les objets pris en charge par la version précédente sont sauvegardés.

Exemple 5 : Sauvegarde de la description et des données d'un fichier

SAVOBJ   OBJ(SAVEFILE)  LIB(MYLIB)  OBJTYPE(*FILE)  DEV(TAP01)
         SAVFDTA(*YES)

Cette commande sauvegarde le fichier SAVEFILE qui se trouve dans la bibliothèque MYLIB. La description et les données sont sauvegardées pour ce fichier sauvegarde.

Exemple 6: Sauvegarde d'une liste d'objets

SAVOBJ   OBJ(APP1*)  LIB(*SELECT)  DEV(TAP01)
         SELECT((*INCLUDE PGMLIB/*ALL     *PGM        )
                (*OMIT    PGMLIB/APP1TEST             )
                (*INCLUDE DTALIB*/*ALL    *FILE    PF )
                (*INCLUDE DTALIB*/*ALL    *FILE    LF )
                (*OMIT    DTALIBTEST/*ALL             )
                (*INCLUDE JRNLIB*/*ALL    *JRN        )
                (*INCLUDE JRNLIB*/*ALL    *JRNRCV     ))

Cette commande permet de sauvegarder les objets dont le nom commence par APP1, y compris les programmes contenus dans la bibliothèque PGMLIB, à l'exception du programme APP1TEST, les fichiers physiques et logiques résidant dans les bibliothèques dont le nom commence par DTALIB, à l'exception de la bibliothèque DTALIBTEST, et les journaux et les récepteurs de journal contenus dans les bibliothèques dont le nom commence par JRNLIB.

Exemple 7: Sauvegarde de descriptions de fichier base de données

SAVOBJ   OBJ(*ALL)  LIB(DATALIB)  DEV(TAP01)
         SELECT((*INCLUDE *ALL *FILE PF )
                (*INCLUDE *ALL *FILE LF )
                (*OMIT    *ALL *ALL  *ALL *ALLMBR ))

Cette commande permet de sauvegarder tous les fichiers physiques et logiques résidant dans la bibliothèque DATALIB, mais elle ne permet pas de sauvegarder les membres de fichier. Seules les descriptions de fichier sont sauvegardées.

Messages d'erreur

Messages *ESCAPE

CPF3701

&1 objet(s) de &3 sauvegardé(s). &2 non sauvegardés.

CPF3702

&1 objet(s) de &3 sauvegardé(s). &2 non sauvegardés. &9 non inclus.

CPF3703

Objet &1 de type &2 de &3 non sauvegardé.

CPF3708

Le fichier sauvegarde &1 de &2 est trop petit.

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.

CPF3730

Non autorisé à sauvegarder ou restaurer &2 &1 dans &3.

CPF3731

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

CPF3733

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

CPF3735

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

CPF3738

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

CPF3747

Noms d'objet incompatibles avec plusieurs bibliothèques.

CPF3749

Objets de la bibliothèque &2 non sauvegardés.

CPF3767

Unité &1 non trouvée.

CPF3768

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

CPF377D

Sauvegarde interrompue par erreur de lecture sur ressource système interne.

CPF377E

Mémoire insuffisante pour demande de sauvegarde en mise à jour.

CPF377F

Sauvegarde interrompue. Impossible d'atteindre un point de contrôle.

CPF3770

Aucun objet de &1 n'a été sauvegardé ou restauré.

CPF3771

&1 objet(s) de &3 sauvegardé(s). &2 non sauvegardés.

CPF3774

&1 objet(s) de &3 sauvegardé(s). &2 non sauvegardés. &8 non inclus.

CPF3778

Les objets de toutes les bibliothèques n'ont pas été sauvegardés en totalité.

CPF378A

File d'attente de messages indisponible.

CPF378C

SAVACTMSGQ(*WRKSTN) incompatible avec travail par lots.

CPF378E

Bibliothèque &1 non sauvegardée.

CPF3781

Bibliothèque &1 non trouvée.

CPF3782

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

CPF3789

Une seule bibliothèque admise avec les paramètres indiqués.

CPF379E

Mémoire disponible insuffisante pour sauvegarder la bibliothèque &1.

CPF3793

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

CPF3794

La sauvegarde ou la restauration n'a pas abouti.

CPF3797

Objets de &3 non sauvegardés. Limite de sauvegarde dépassée.

CPF37AB

Valeur *NOCMTBDY non admise avec l'édition cible.

CPF37AC

Bibliothèque non admise avec *NOCMTBDY.

CPF37B1

SPLFDTA non admis avec l'édition cible.

CPF37B4

Espace utilisateur &1 dans &2 non admis.

CPF37B5

PVTAUT non admis avec l'édition cible.

CPF37B7

Non autorisé à sauvegarder les droits privés.

CPF37B9

ID synchronisation &1 utilisé.

CPF37BC

Fin de l'ID synchronisation &1. Délai d'attente dépassé.

CPF37BD

Fin de l'ID synchronisation &1. La sauvegarde s'est terminée avant le point de contrôle.

CPF37BE

ID synchronisation &1 non lancé.

CPF37C7

Fin de l'ID synchronisation &1. Erreur de SAVACTWAIT.

CPF380B

Sauvegarde impossible actuellement.

CPF3812

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

CPF3815

Fichier sauvegarde &1 de &2 trop petit.

CPF384E

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

CPF3867

Valeurs du paramètre FILEMBR incorrectes.

CPF3868

FILEMBR indiqué mais OBJTYPE doit être *ALL ou *FILE.

CPF3871

Aucun objet sauvegardé ou restauré ; &3 objet(s) exclu(s).

CPF388B

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

CPF3892

Objet &1 de type &2 de &3 non sauvegardé.

CPF3894

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

CPF38A2

Unité ASP &1 incorrecte.

CPF38A3

Fichier &1 de &2 incorrect avec ASPDEV.

CPF38A4

Unité ASP &1 incorrecte.

CPF38AA

Clé de liste de sélection d'objet incorrecte.

CPF38AB

FILEMBR incorrect avec SELECT.

CPF38AC

LIB(*SELECT) incorrect avec *ALL pour les bibliothèque.

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.

CPF9814

Unité &1 non trouvée.

CPF9820

Non autorisé à utiliser la bibliothèque &1.

CPF9822

Non autorisé au fichier &1 de &2.

CPF9825

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

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.

OPT1332

Volume optique non trouvé sur l'unité &1.

Messages *STATUS

CPF3770

Aucun objet de &1 n'a été sauvegardé ou restauré.

CPF3771

&1 objet(s) de &3 sauvegardé(s). &2 non sauvegardés.

CPF3871

Aucun objet sauvegardé ou restauré ; &3 objet(s) exclu(s).