SAVLIB

La commande SAVLIB (Sauvegarder une bibliothèque) vous permet de sauvegarder une ou plusieurs bibliothèques.

En revanche, lorsque vous utilisez un fichier sauvegarde, vous ne pouvez indiquer qu'une seule bibliothèque.

Cette commande sauvegarde la bibliothèque entière, à savoir la description de bibliothèque, les descriptions d'objet et le contenu des objets de la bibliothèque. Par contre, seules les définitions d'objet des files d'attente de travaux, des files d'attente de messages et des fichiers logiques sont sauvegardées, et non leur contenu. 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). Les bibliothèques et leurs objets ne sont pas affectés sur le système, sauf si la commande indique que la mémoire secondaire doit être libérée. Néanmoins, si le paramètre UPDHST(*NO) (Mise à jour historique) n'est pas indiqué, la description de chaque bibliothèque et objet est mise à jour afin d'indiquer la date, l'heure et l'emplacement de la dernière sauvegarde. Si vous sauvegardez un groupe de bibliothèques en indiquant *NONSYS, *ALLUSR ou *IBM au paramètre LIB, la date, l'heure et l'emplacement de la dernière sauvegarde sont mis à jour dans les informations d'historique d'une zone de données de QSYS (zone de données QSAVLIBALL, QSAVALLUSR ou QSAVIBM).

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", ainsi que *DTADCT. Certains objets du système d'exploitation qui ne figurent pas dans des bibliothèques utilisateur (profils utilisateur, par exemple) ne sont pas sauvegardés par cette commande. Pour les sauvegarder, utilisez la commande SAVSYS (Sauvegarder le système) ou SAVSECDTA (Sauvegarder les données de sécurité).

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 *READ sur chacune des bibliothèques indiquées (si vous n'en êtes pas le propriétaire),
  • droit *OBJEXIST sur chaque objet de la bibliothèque (pour les données de fichier spoule, droit *OBJEXIST sur la file d'attente en sortie),
• Si vous ne disposez pas du droit spécial *SAVSYS, seuls les objets et bibliothèques 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 sur la description d'unité associée.
• Lorsque la sauvegarde est effectuée dans un fichier sauvegarde, l'utilisateur doit disposer du droit d'ajout et d'utilisation sur le fichier sauvegarde.
• L'utilisateur d'une définition de support doit disposer du droit *USE sur cette définition de support et du droit *EXECUTE sur la bibliothèque de celle-ci.
• 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.
• Aucune bibliothèque en cours de sauvegarde, ou aucun des objets qu'elle contient ne peut être mis à jour par un travail qui s'exécute en même temps que la sauvegarde si la sauvegarde en mise à jour n'est pas activé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 vous sauvegardez le contenu d'un fichier sauvegarde en attribuant la valeur *YES au paramètre SAVFDTA (Données fichiers sauvegarde), le fichier sauvegarde doit être restauré avant que les objets qu'il contient le soient.
• 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

Bibliothèque (LIB)

Indique les bibliothèques sauvegardées.

Remarques :

1. Cette commande ne permet pas de sauvegarder les bibliothèques système QDOC, QDOCxxxx, QPTFOBJ1, QPTFOBJ2, QRCYxxxxx, QRECOVERY, QRPLOBJ, QRPLxxxxx, QSPL, QSPLxxxx, QSRV, QSYS, QSYSxxxxx et QTEMP. xxxx représente un numéro d'unité ASP utilisateur de base et xxxxx un numéro d'unité ASP indépendante.
2. Si vous indiquez *ALLUSR ou *IBM pour ce paramètre, cette commande ne devra pas être lancée lorsque les bibliothèques indiquées sont en cours d'utilisation. En effet, si des objets contenus dans une bibliothèque sont utilisés au moment où celle-ci est sauvegardée, ces objets ne seront pas pris en compte dans la sauvegarde, à moins que vous n'utilisiez SAVACT. Pour que toutes les bibliothèques soient sauvegardées, exécutez cette commande lorsque le système est à l'état restreint. Par exemple, si la commande SAVLIB LIB(*ALLUSR) est exécutée lorsque le sous-système QSNADS est actif, les fichiers QAO* ne sont pas sauvegardés dans la bibliothèque QUSRSYS. Pour les sauvegarder, arrêtez le sous-système QSNADS avant d'exécuter cette commande.
3. En lançant SAVLIB LIB(*IBM), puis SAVLIB LIB(*ALLUSR), vous pouvez sauvegarder les mêmes bibliothèques qu'à l'aide de SAVLIB LIB(*NONSYS), mais il vous faut lancer deux commandes de restauration.
4. Les bibliothèques sont sauvegardées dans l'ordre indiqué au paramètre Mode de tri (SORT).

Ce paramètre est obligatoire.

Valeurs uniques

*NONSYS

Toutes les bibliothèques, à l'exception des bibliothèques du système ci-dessous, sont sauvegardées. xxxx et xxxxx représentent les numéros d'ASP.

QDOC        QRCYxxxxx   QSPL        QSYSxxxxx
QDOCxxxx    QRECOVERY   QSPLxxxx    QTEMP
QPTFOBJ1    QRPLOBJ     QSRV
QPTFOBJ2    QRPLxxxxx   QSYS

Remarque :Avec ce paramètre, tous les sous-systèmes doivent être arrêtés à l'aide de la commande ENDSBS ou ENDSYS.

*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. Par conséquent, ces bibliothèques sont considérées comme "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

*IBM

Permet de sauvegarder toutes les bibliothèques IBM sauf les suivantes :

QDOC        QRCL        QSYS2xxxxx  QUSRPOSGS
QDOCxxxx    QRCLxxxxx   QS36F       QUSRPOSSA
QDSNX       QRCYxxxxx   QTEMP       QUSRPYMSVR
QGPL        QRECOVERY   QUSER38     QUSRRDARS
QGPL38      QRPLOBJ     QUSRADSM    QUSRSYS
QMGTC       QRPLxxxxx   QUSRBRM     QUSRVI
QMGTC2      QSPL        QUSRDIRCF   QUSRVxRxMx
QMPGDATA    QSPLxxxx    QUSRDIRCL   QWQCENT
QMQMDATA    QSRV        QUSRDIRDB   QWQREPOS
QMQMPROC    QSRVAGT     QUSRIJS
QPFRDATA    QSYS        QUSRINFSKR
QPTFOBJ1    QSYSxxxxx   QUSRNOTES
QPTFOBJ2    QSYS2       QUSROND

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.

Les bibliothèques suivantes, dont le nom ne commence pas par la lettre Q, sont également sauvegardées :

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

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

nom

Indiquez le nom de la bibliothèque à sauvegarder. (Une seule bibliothèque peut être sauvegardée dans un fichier sauvegarde). Il est impossible de préciser un nom de bibliothèque système.

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.

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.

Si *NONSYS, *ALLUSR ou *IBM est indiqué au paramètre LIB, la sauvegarde du jeu de bibliothèques commence au numéro de séquence indiqué. Dans ce jeu, le premier fichier sauvegardé est le fichier QFILE. Le fichier QFILE contient la liste des bibliothèques sauvegardées.

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(*NONSYS), LIB(*ALLUSR) ou LIB(*IBM) 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.

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.

*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 des bibliothèques spécifiées au paramètre Bibliothèque (LIB).

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

Mode de tri (SORT)

Indique l'ordre dans lequel les bibliothèques indiquées au paramètre Bibliothèque (LIB) sont sauvegardées. Si *NONSYS ou *ALLUSR est indiqué au paramètre LIB, les bibliothèques QSYS2, QGPL, QUSRSYS et QSYS2xxxxx (xxxxx étant un numéro d'ASP indépendant) sont sauvegardées en premier, si elles se trouvent dans les ASP spécifiés au paramètre ASPDEV.

*NAME

Les bibliothèques sont sauvegardées dans le même ordre que celui des noms indiqués au paramètre LIB. Pour chaque valeur spéciale ou générique, les bibliothèques résidant dans les ASP indépendants sont sauvegardées avant les bibliothèques présentes dans les ASP système et les ASP utilisateur de base. Les bibliothèques résidant sur le même ASP sont sauvegardées par ordre alphabétique.

*SIZE

Les bibliothèques sont sauvegardées en fonction de la taille totale de bibliothèque, dans l'ordre décroissant. Cela peut permettre d'améliorer les performances de l'opération de sauvegarde.

Exemples

Exemple 1 : Sauvegarde d'une bibliothèque sur une unité de bande

SAVLIB   LIB(JOE)  DEV(TAP01)

Cette commande sauvegarde la bibliothèque JOE sur la bande qui se trouve dans l'unité de bande TAP01. La mémoire occupée par JOE dans le système n'est pas libérée, car la valeur par défaut du paramètre STG est *KEEP.

Exemple 2 : Sauvegarde sur plusieurs volumes

SAVLIB   LIB(QGPL)  DEV(OPT01)  VOL(ABC DEF GHI)

La bibliothèque générale (QGPL) est sauvegardée sur les volumes optiques de l'unité OPT01. Les volumes optiques doivent être nommés ABC, DEF et GHI. Si l'opération de sauvegarde n'est pas terminée lorsque le volume ABC est plein, un message invite l'opérateur à placer le volume DEF dans l'unité.

Exemple 3 : Libération de la mémoire lors de la sauvegarde des données

SAVLIB   LIB(CUSTDATA)  DEV(TAP01)
         VOL(CUSTNM CUSTAD)  STG(*FREE)

La bibliothèque nommée CUSTDATA est sauvegardée sur les volumes CUSTNM et CUSTAD, placés dans l'unité de bande TAP01. A l'issue de la sauvegarde, la mémoire occupée par les membres, modules, programmes, programmes de service, modules SQL, et récepteurs de journal indiqués de la bibliothèque CUSTDATA est libérée.

Exemple 4 : Sauvegarde en série sur plusieurs unités

SAVLIB   LIB(USRLIB)  DEV(TAP01 TAP02 TAP03)
         VOL(USRA USRB USRC USRD)  ENDOPT(*UNLOAD)

La bibliothèque USRLIB est sauvegardée sur quatre volumes de bande sur trois unités de bande. Le volume USRA est placé sur l'unité TAP01, le volume USRB sur l'unité TAP02, le volume USRC sur l'unité TAP03, et le volume USRD sur l'unité TAP01. Le volume USRA est rembobiné et doit être déchargé par l'opérateur lorsque le traitement est terminé afin que l'unité nommée TAP01 puisse être utilisée pour le volume USRD.

Exemple 5 : Sauvegarde en parallèle sur plusieurs unités

SAVLIB   LIB(USRLIB)  DEV(*MEDDFN)  MEDDFN(LIBA/MEDDFNA)

La bibliothèque USRLIB est sauvegardée sur les unités indiquées dans la définition de support MEDDFNA de la bibliothèque LIBA. Pour plus d'informations concernant la création et l'utilisation d'une définition de support, consultez la rubrique sur la sauvegarde, la restauration et la disponibilité de l'Information Center.

Exemple 6 : Sauvegarde d'une bibliothèque avec un label de fichier de support

SAVLIB   LIB(LIB1)  DEV(TAP01)  LABEL(MONDAYBACKUP)

Cette commande utilise l'unité de bande TAP01 pour sauvegarder la bibliothèque LIB1 sur bande. La bibliothèque est sauvegardée avec le label de fichier de support MONDAYBACKUP. Ce label doit être indiqué lors de la restauration de la bibliothèque ou de l'un de ses objets.

Exemple 7 : Indication du point départ d'une opération de sauvegarde

SAVLIB   LIB(*NONSYS)  DEV(TAP01 TAP02)
         STRLIB(MIKESLIB)  ASPDEV(*SYSBAS)

Cette commande sauvegarde toutes les bibliothèques situées dans les ASP système et utilisateur de base, en commençant par la bibliothèque MIKESLIB, sur les unités de bande TAP01 et TAP02. Les bibliothèques système et les bibliothèques qui sont normalement sauvegardées les premières (QSYS2, QGPL et QUSRSYS) ne sont pas sauvegardées.

Exemple 8 : Sauvegarde des bibliothèques utilisateur d'un groupe d'ASP indépendants

SAVLIB   LIB(*ALLUSR)  DEV(TAP01)  ASPDEV(*CURASPGRP)

Cette commande sauvegarde toutes les bibliothèques utilisateur des ASP indépendants qui se trouvent dans le groupe d'ASP de l'unité d'exécution en cours. Elle ne sauvegarde pas les bibliothèques de l'ASP système (ASP numéro 1) ou des ASP utilisateur de base (ASP numéros 2 à 32).

Exemple 9 : Sauvegarde de fichiers spoule

SAVLIB   LIB(MYLIB)  DEV(TAP01)  SPLFDTA(*ALL)

Cette commande sauvegarde la bibliothèque appelée MYLIB, y compris les données de fichier spoule des files d'attente en sortie de la bibliothèque.

Messages d'erreur

Messages *ESCAPE

CPF3701

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

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.

CPF3749

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

CPF3751

Plusieurs bibliothèques non sauvegardées.

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.

CPF3777

&1 bibliothèque(s) sauvegardée(s), &6 partiellement sauvegardé(es), &2 non sauvegardé(es).

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.

CPF3785

Tous les sous-systèmes ne sont pas arrêtés.

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.

CPF3818

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

CPF384E

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

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.

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