SAVCHGOBJ

La commande SAVCHGOBJ (Sauvegarder les objets modifiés) permet de sauvegarder une version de chaque objet ou groupe d'objets modifié de la même bibliothèque. Si vous avez attribué la valeur *ALL au paramètre OBJ (Objets), les objets peuvent être sauvegardés à partir de toutes les bibliothèques utilisateur ou d'une liste de bibliothèques. En revanche, lorsque vous utilisez un fichier sauvegarde, vous ne pouvez indiquer qu'une seule bibliothèque. Pour les fichiers base de données, seuls les membres modifiés sont sauvegardés.

Les objets modifiés depuis la date et l'heure indiquées sont sauvegardés, dans les limites suivantes :

• Si OBJJRN(*NO) est indiqué, les objets en cours de journalisation ne sont pas sauvegardés, sauf si la journalisation a été démarrée après la date et l'heure indiquées. Ainsi, les modifications apportées à un objet avant le lancement de la journalisation ne sont pas perdues (car elles n'étaient pas journalisées dans un récepteur de journal).
• Les objets libérés (programmes, fichiers, récepteurs de journal, etc.) ne sont pas sauvegardés.
• Les messages définis par l'utilisateur, les définitions de file d'attente en sortie et de travaux et les définitions de fichier logique sont sauvegardées mais le contenu de ces objets ne l'est pas. Les chemins d'accès des fichiers logiques sont sauvegardés si ACCPTH(*YES) est indiqué. 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).

Les objets indiqués qui ont été modifiés et les bibliothèques dans lesquelles ils résident sont verrouillés pendant l'opération de sauvegarde.

Les objets sauvegardés peuvent être restaurés à l'aide de la commande RSTOBJ (Restaurer un objet).

Pour déterminer la date et l'heure de la modification d'un objet, exécutez la commande DSPOBJD (Afficher la description d'un objet) avec DETAIL(*FULL). Dans le cas de membres de fichier base de données modifiés, exécutez la commande DSPFD (Afficher une description de fichier).

Les types d'objet sauvegardés par cette commande sont ceux répertoriés pour le paramètre OBJTYPE dans le manuel Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/, "Commonly used parameters: Expanded descriptions". Le système sauvegarde les objets modifiés en écrivant une copie de chacun d'entre eux sur bande, sur volume optique ou dans un fichier sauvegarde. La description de chaque objet est modifiée afin d'indiquer la date, l'heure et l'emplacement de la dernière sauvegarde et est contrôlée par le paramètre UPDHST.

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 d'existence sur l'objet (*OBJEXIST) pour chaque objet à sauvegarder,
  • 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 modifiés 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.
• Si une bande est utilisée, une identification de volume à label standard doit être utilisée.
• Aucun objet modifié étant en cours de sauvegarde ne peut être modifié par un autre travail exécuté pendant sa sauvegarde, sauf si vous utilisez la fonction de sauvegarde en mise à jour.
• 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 OUTFILE avec un fichier base de données existant, vous devez disposer du droit *EXECUTE sur la bibliothèque contenant le fichier.
• 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, pour lesquels les modifications doivent être contrôlées en vue de la sauvegarde des objets modifiés. 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 modifiés contenus dans les bibliothèques indiquées 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

Indiquez un ou plusieurs noms génériques de groupes d'objets modifiés à sauvegarder dans la bibliothèque indiquée. 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 le nom des objets spécifiques à sauvegarder. Une commande peut comporter à la fois des noms génériques et spécifiques.

Bibliothèque (LIB)

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

Remarque :Les bibliothèques sont sauvegardées par ordre alphabétique de nom d'unité ASP pour chaque valeur spécifiée. Les bibliothèques présentes sur les unités ASP indépendantes sont sauvegardées avant celles situées sur le système et sur les ASP utilisateur de base. Lorsque la valeur *ALLUSR est indiquée, les bibliothèques QSYS2, QGPL, QUSRSYS et QSYS2xxxxx (xxxxx représentant un numéro d'unité ASP indépendante) sont sauvegardées en premier, à condition qu'elles soient présentes sur les unités ASP spécifiées par le paramètre ASPDEV.

Ce paramètre est obligatoire.

Valeurs uniques

*ALLUSR

Toutes les bibliothèques utilisateur sont sauvegardées. Toutes les bibliothèques dont le nom ne commence pas par la lettre Q sont sauvegardées sauf les suivantes :

#CGULIB     #DSULIB     #SEULIB
#COBLIB     #RPGLIB
#DFULIB     #SDALIB

Bien que les bibliothèques Qxxx suivantes soient fournies par IBM, elles contiennent généralement des données utilisateur qui sont fréquemment modifiées. Elles sont donc considérées comme des "bibliothèques utilisateur" et sont également sauvegardées :

QDSNX       QRCLxxxxx   QUSRDIRDB   QUSRVI
QGPL        QSRVAGT     QUSRIJS     QUSRVxRxMx
QGPL38      QSYS2       QUSRINFSKR  QWQCENT
QMGTC       QSYS2xxxxx  QUSRNOTES   QWQREPOS
QMGTC2      QS36F       QUSROND
QMPGDATA    QUSER38     QUSRPOSGS
QMQMDATA    QUSRADSM    QUSRPOSSA
QMQMPROC    QUSRBRM     QUSRPYMSVR
QPFRDATA    QUSRDIRCF   QUSRRDARS
QRCL        QUSRDIRCL   QUSRSYS

Remarque :L'utilisateur peut créer une bibliothèque de nom différent, au format QUSRVxRxMx, pour chacune des éditions précédentes prises en charge par IBM, afin d'y stocker les commandes utilisateur à compiler dans un programme CL pour une édition précédente. En ce qui concerne la bibliothèque utilisateur QUSRVxRxMx, VxRxMx correspond à une version, édition et niveau de modification précédents encore admis par IBM.

*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 de la bibliothèque. 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. Un nom générique de bibliothèque ne peut pas être indiqué lors d'une sauvegarde dans un fichier sauvegarde.

nom

Si la valeur *ALL est attribuée au paramètre OBJ (Objets), vous pouvez indiquer jusqu'à 300 bibliothèques. 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 pour lesquels les modifications sont sauvegardées. Les types d'objet sauvegardés sont les types également sauvegardés et restaurés par les commandes SAVLIB (Sauvegarder une bibliothèque), RSTOBJ (Restaurer un objet) et RSTLIB (Restaurer une bibliothèque). Les dictionnaires de données et les fichiers associés ne sont sauvegardés que par la commande SAVLIB.

Valeurs uniques

*ALL

Les modifications apportées aux types d'objets désignés se trouvant dans la bibliothèque indiquée sont sauvegardées.

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

type-objet

Entrez le type d'objet à sauvegarder, 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/.

Inclure objets journalisés (OBJJRN)

Indique si les objets en cours de journalisation et ceux journalisés depuis la date et l'heure spécifiées dans les paramètres REFDATE (Date de référence) et REFTIME (Heure de référence) doivent être sauvegardés.

*NO

Les objets journalisés ne sont pas sauvegardés. Si la journalisation a démarré après la date et l'heure indiquées, les objets modifiés ou les membres de fichier base de données modifiés sont sauvegardés. Les date et heure de début de la dernière opération de journalisation peuvent être affichées à l'aide de la commande DSPOBJD (Afficher la description de l'objet).

*YES

Les objets dont les modifications sont journalisées sont sauvegardés.

Date de référence (REFDATE)

Indique la date de référence. Les objets qui ont été modifiés depuis cette date sont sauvegardés.

*SAVLIB

Sont sauvegardés les objets qui ont été modifiés depuis la date du dernier lancement de la commande SAVLIB (Sauvegarder une bibliothèque). Si la bibliothèque précisée n'a jamais été sauvegardée, un message est émis. La bibliothèque n'est pas sauvegardée, mais l'opération se poursuit.

date

Indiquez l'heure de référence. Les objets modifiés depuis cette date sont sauvegardés. Si la date indiquée est postérieure à la date d'exécution de cette commande, un message est émis et l'opération s'arrête. Vous devez utiliser le format de date du travail.

Heure de référence (REFTIME)

Indique l'heure de référence. Les objets modifiés depuis l'heure définie à la date indiquée sont sauvegardés.

*NONE

L'heure n'est pas indiquée. Tous les objets modifiés depuis la date précisée pour le paramètre REFDATE (Date de référence) sont sauvegardés.

heure

Indiquez l'heure de référence. Les objets modifiés depuis l'heure définie à la date indiquée sont sauvegardés. Si *SAVLIB a été indiqué pour le paramètre REFDATE, vous ne pouvez pas préciser d'heure de référence. Si vous précisez une heure postérieure à celle du lancement de cette commande, un message est émis et l'opération s'arrête.

L'heure peut être indiquée avec ou sans séparateur horaire :

• Si vous n'utilisez pas de séparateur, indiquez une chaîne de 6 chiffres (hhmmss) où hh = heures, mm = minutes, et ss = secondes.
• Si vous utilisez des séparateurs, entrez une chaîne de 8 chiffres, où le séparateur indiqué dans votre description de travail permet de distinguer les heures, les minutes et les secondes. Si vous entrez cette commande sur la ligne de commande, vous devez la placer entre apostrophes. Si vous utilisez un autre séparateur d'heure que celui défini pour votre travail, cette commande n'aboutira pas.

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.

Bibliothèque de début (STRLIB)

Définit le nom de la bibliothèque marquant le point de départ de la sauvegarde.

Si une erreur de support irrémédiable se produit au cours de la sauvegarde, vous pouvez utiliser ce paramètre pour redémarrer l'opération.

Les étapes principales de redémarrage de la procédure de sauvegarde sont les suivantes :

1. Consultez l'historique du travail pour déterminer la bibliothèque sur laquelle a échoué l'opération de sauvegarde. Identifiez la dernière bibliothèque sauvegardée, à l'aide du message d'achèvement qui lui est associé.
2. Chargez la bande suivante après vous être assuré qu'elle a été initialisée.
3. Ajoutez ce qui suit à votre commande de sauvegarde d'origine :

     STRLIB(nom-bibliothèque) OMITLIB(nom-bibliothèque)
   

   où le nom-bibliothèque indiqué pour les paramètres STRLIB et OMITLIB est celui de la dernière bibliothèque dont la sauvegarde s'est correctement déroulée. Cette commande permet de démarrer la sauvegarde de la bibliothèque suivant la dernière bibliothèque sauvegardée.

   Pour restaurer les bibliothèques, vous devrez lancer une opération de restauration distincte pour chaque sauvegarde effectuée.

*FIRST

La sauvegarde commence par la première valeur de bibliothèque définie pour le paramètre LIB (Bibliothèque). Si la première valeur est un nom générique ou une valeur spécifique, la sauvegarde commence par la première bibliothèque correspondant à cette valeur.

nom

Nom de la bibliothèque par laquelle commencer la sauvegarde.

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.

Remarques :

1. Si LIB(*ALLUSR) est indiqué, seule l'édition en cours peut être l'édition cible.
2. Tous les objets ne peuvent pas être transférés vers une autre édition. Pour plus d'informations, reportez-vous au manuel Reprise du système, SC41-5304.

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.

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.

*NEW

Pour chaque file d'attente en sortie sauvegardée, les données de fichier spoule créées depuis les dates indiquées aux paramètres Date de référence (REFDATE) et Heure de référence (REFTIME) sont sauvegardées. Les files d'attente en sortie qui comportent des fichiers spoule créés après la date et l'heure de référence sont considérées comme modifiées et elles sont sauvegardées. Les fichiers spoule dont les dates et les heures de création sont antérieures à la date et à l'heure de référence et qui ont été déplacés dans une file d'attente en sortie ne sont pas sauvegardés et la file d'attente en sortie n'est pas considérée comme modifiée.

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.

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, 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 fichiers modifiés

SAVCHGOBJ   OBJ(ORD*)  LIB(DSTPRODLB)  DEV(TAP01)
            OBJTYPE(*FILE)  REFDATE(122290)

Cette commande sauvegarde tous les fichiers dont les noms commencent par les caractères ORD de la bibliothèque DSTPRODLB qui ont été modifiés depuis le 22 décembre 1990.

Exemple 2 : Sauvegarde de la description et des données pour les fichiers sauvegarde

SAVCHGOBJ   OBJ(FILE*)  LIB(MYLIB)  DEV(TAP01)  OBJTYPE(*FILE)
            REFDATE(122290)  SAVFDTA(*YES)

Cette commande sauvegarde tous les fichiers dont les noms commencent par les caractères FILE de la bibliothèque MYLIB et qui ont été modifiés depuis le 22 décembre 1990. Elle sauvegarde également la description et les données pour tous les fichiers sauvegarde correspondant aux critères de recherche.

Messages d'erreur

Messages *ESCAPE

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.

CPF3745

Aucune opération SAVLIB enregistrée pour &1.

CPF3746

Date et heure système antérieures à date et heure de référence indiquées.

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

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.

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.

CPF3818

Bibliothèque de début &1 non trouvée.

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.

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.

Messages *STATUS

CPF3770

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

CPF3774

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

CPF3871

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