SAV

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

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

Restrictions :

• Pour obtenir une description détaillée des restrictions d'utilisation de cette commande pour sauvegarder des objets à l'aide de masques de nom d'objet du répertoire principal, sauvegarder des objets dans des bibliothèques ou sauvegarder des dossiers et documents, reportez-vous au manuel Reprise du système, SC41-5304.

Paramètres

Unité (DEV)

Indique le nom de l'unité sur laquelle les objets sont sauvegardés.

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

Ce paramètre est obligatoire.

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

'nom-chemin-fichier-sauvegarde'

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

'nom-chemin-unité-optique'

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

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

Indiquez le nom de chemin de l'unité de bandothèque utilisée pour sauvegarder les objets.

'nom-chemin-unité-bande'

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

'nom-chemin-définition-support'

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

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

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

Objets (OBJ)

Indique les objets à sauvegarder. Vous pouvez spécifier un masque de nom d'objet pour le nom de chemin à utiliser. Lorsqu'un nom de chemin pouvant correspondre à plusieurs objets est précisé, vous pouvez attribuer une valeur au paramètre PATTERN (Masque du nom) en vue de créer un sous-ensemble d'objets à sauvegarder.

Vous pouvez spécifier jusqu'à 300 noms de chemin.

Pour obtenir de plus amples informations relatives à la spécification des noms de chemin, reportez-vous à "Object naming rules" dans la rubrique Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

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

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

Elément 1 : Nom

'*'

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

nom-chemin

Indiquez le nom de chemin d'un objet spécifique ou un masque auquel peuvent correspondre plusieurs noms.

Elément 2 : Inclure ou omettre

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

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

*INCLUDE

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

*OMIT

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

Masque du nom (PATTERN)

Indique un ou plusieurs masques de nom d'objet à utiliser en vue de créer un sous-ensemble des objets à sauvegarder. Le paramètre OBJ (Objets) définit l'ensemble des objets candidat. Vous pouvez spécifier jusqu'à 300 valeurs pour ce paramètre.

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

Elément 1 : Masque

*

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

valeur-alphanumérique

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

Elément 2 : Inclure ou omettre

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

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

*INCLUDE

Seuls les objets inclus par le paramètre OBJ et qui correspondent au paramètre PATTERN sont inclus dans la sauvegarde, sauf si une spécification *OMIT s'y substitue.

*OMIT

Tous les objets inclus par le paramètre OBJ, à l'exception de ceux correspondant au paramètre PATTERN, sont inclus dans la sauvegarde. Cette valeur se substitue à une spécification *INCLUDE et permet d'omettre un sous-ensemble d'un masque sélectionné précédemment.

Branche du répertoire (SUBTREE)

Indique si toute l'arborescence du répertoire est incluse dans l'opération de sauvegarde.

*ALL

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

*DIR

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

*NONE

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

*OBJ

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

*STG

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

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, ce paramètre n'est pas pris en compte et 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.

*YES

Les objets peuvent être sauvegardés tout en étant utilisés. Ils peuvent être soumis à des points de contrôle à différents moments.

*SYNC

Les objets peuvent être sauvegardés tout en étant utilisés. Tous les points de contrôle ont lieu en même temps.

Options de sauvegarde en màj (SAVACTOPT)

Indique les options à utiliser avec le paramètre de sauvegarde en mise à jour.

*NONE

Aucune option spéciale de sauvegarde en mise à jour n'est utilisée.

*ALL

Toutes les options répertoriées ci-dessous sont utilisées au cours de l'opération de sauvegarde. Pour déterminer les options gérées, reportez-vous à la description des différentes valeurs.

*ALWCKPWRT

Permet d'activer la sauvegarde des objets pendant leur mise à jour si l'attribut système correspondant de cet objet est défini.

Remarque :Cette option doit uniquement être utilisée par des applications pour la sauvegarde d'objets associés à ces applications et disposant d'options supplémentaires de sauvegarde et de reprise. Pour en savoir plus, reportez-vous à la rubrique Ensemble de rubriques Sauvegarde et reprise de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

*NWSSTG

Permet de sauvegarder des espaces mémoire sur le serveur réseau dans le répertoire '/QFPNWSSTG' lorsqu'ils sont actifs.

Sortie (OUTPUT)

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

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

Pour obtenir de plus amples informations relatives à la spécification des noms de chemin, reportez-vous à "Object naming rules" dans la rubrique Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

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

*NONE

Aucune sortie n'est créée.

*PRINT

Le résultat est placé dans un fichier spoule de la file d'attente en sortie du travail.

'nom-chemin-fichier-STREAM'

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

'nom-chemin-espace-utilisateur'

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

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.

Vous pouvez indiquer 75 identificateurs de volumes au maximum. Une fois que tous les volumes indiqués ont été utilisés, l'opération de sauvegarde se poursuit sur tout volume monté sur l'unité.

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.

Label (LABEL)

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

*GEN

Le label du fichier est créé par le système.

• Pour les objets en bibliothèque, cette valeur est équivalente à la valeur LABEL(*LIB) des commandes SAVOBJ (Sauvegarder un objet) et SAVLIB (Sauvegarder une bibliothèque).
• Pour les documents ou les dossiers, cette valeur est équivalente à la valeur LABEL(*GEN) de la commande SAVDLO (Sauvegarder des documents ou dossiers).
• Pour les objets d'autres systèmes de fichiers, le label est SAVaaaammjj.

valeur-alphanumérique

Indiquez l'identificateur (17 caractères au maximum) du fichier bande utilisé pour l'opération de sauvegarde.

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.

Numéro de séquence (SEQNBR)

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

*END

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

1 à 16777215

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

Date d'expiration du fichier (EXPDATE)

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

Remarques :

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

*PERM

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

date

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

Option de fin de support (ENDOPT)

Indique l'opération automatiquement exécutée sur la bande ou sur le volume optique à la fin de l'opération de sauvegarde. Si vous vous servez de plusieurs volumes, ce paramètre ne s'applique qu'au dernier utilisé. Lorsque la fin de volume est atteinte, tous les autres volumes sont déchargés.

Remarque :Ce paramètre est admis uniquement si un nom d'unité de bande ou optique est indiqué pour le paramètre DEV. Pour les unités optiques, seule la valeur spéciale *UNLOAD est acceptée. Les valeurs *REWIND et *LEAVE ne seront pas prises en compte.

*REWIND

A la fin de l'opération, la bande est rebobinée automatiquement, mais elle n'est pas déchargée.

*LEAVE

La bande n'est pas rembobinée ou déchargée à la fin de l'opération. Elle conserve sa position.

*UNLOAD

La bande est automatiquement rembobinée et déchargée à la fin de l'opération. Certaines unités optiques éjecteront le volume une fois l'opération terminée.

Taille optimale de bloc (USEOPTBLK)

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

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

*YES

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

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

*NO

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

File attente messages si màj (SAVACTMSGQ)

Indique le nom de 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 obtenir de plus amples informations relatives à la spécification des noms de chemin, reportez-vous à "Object naming rules" dans la rubrique Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

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

*NONE

Aucun message de notification n'est envoyé.

*WRKSTN

Le message de notification est envoyé à la file d'attente de messages du poste de travail.

nom-chemin

Indiquez le chemin de la file d'attente de messages à utiliser.

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 une valeur *SYNC pour le paramètre Sauvegarde en mise à jour (SAVACT).

Type d'informations en sortie (INFTYPE)

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

*ALL

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

*ERR

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

*SUMMARY

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

Système (SYSTEM)

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

*LCL

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

*RMT

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

*ALL

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

Période dernière modification (CHGPERIOD)

Indique un intervalle de temps (date/heure). Les objets dont les dernières modifications ont été effectuées durant cet intervalle de temps seront sauvegardés.

Elément 1 : Date de début

*ALL

Aucune date de début n'est indiquée. Tous les objets dont la dernière modification a été effectuée avant la date de fin seront sauvegardés.

*LASTSAVE

Les objets ayant été modifiés depuis leur dernière sauvegarde avec UPDHST(*YES) sont sauvegardés. Remarques :

1. Si vous indiquez cette valeur, vous devez spécifier *ALL pour tous les autres éléments de ce paramètre.
2. Pour les systèmes de fichiers locaux, l'attribut d'archivage système est utilisé. Pour les systèmes de fichiers éloignés, l'attribut d'archivage PC est utilisé.

date

Indiquez la date après laquelle les objets modifiés sont sauvegardés. Vous devez utiliser le format de date du travail.

Elément 2 : Heure de début

*ALL

Toutes les heures sont incluses dans la plage.

heure

Indiquez l'heure de la date de début à partir de laquelle les objets modifiés sont sauvegardés.

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

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

Remarque :Vous ne pouvez spécifier une heure que si vous avez indiqué explicitement la date de début.

Elément 3 : Date de fin

*ALL

Aucune date de fin n'est indiquée. Tous les objets modifiés depuis la date de début seront sauvegardés.

date

Indiquez la date avant laquelle les objets modifiés sont sauvegardés. Vous devez utiliser le format de date du travail.

Elément 4 : Heure de fin

*ALL

Toutes les heures sont incluses dans la plage.

heure

Indiquez l'heure de la date de fin avant laquelle les objets modifiés sont sauvegardés.

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

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

Remarque :Vous ne pouvez spécifier une heure que si vous avez indiqué explicitement une date de fin.

Tester disponibilité objets (PRECHK)

Indique si l'opération de sauvegarde s'arrête si l'un des objets sélectionnés ne peut pas être sauvegardé.

*NO

La sauvegarde ne s'arrête pas. Elle porte uniquement sur les objets qui peuvent être sauvegardés.

*YES

La sauvegarde s'arrête. Elle s'effectue uniquement si tous les objets sélectionnés peuvent être sauvegardés.

Edition cible (TGTRLS)

Indique le niveau d'édition du système d'exploitation sur lequel vous souhaitez utiliser l'objet à sauvegarder.

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.

*CURRENT

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

*PRV

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

valeur-alphanumérique

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

Mise à jour historique (UPDHST)

Indique si l'historique de sauvegarde associé aux objets sauvegardés doit être mis à jour. Les informations de cet historique sont utilisées lorsque le paramètre CHGPERIOD(*LASTSAVE) est indiqué dans la commande SAV pour une opération de sauvegarde ultérieure.

Valeurs uniques

*NO

Cette opération de sauvegarde ne sera pas mise à jour dans l'historique de sauvegarde associé aux objets sélectionnés.

*YES

L'historique de sauvegarde est mis à jour. Pour les systèmes de fichiers locaux, l'historique de sauvegarde du système est mis à jour. Pour les systèmes de fichiers éloignés, l'historique de sauvegarde PC est mis à jour.

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

*SYS

L'historique de sauvegarde du système est mis à jour.

*PC

L'historique de sauvegarde PC est mis à 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.

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

Unité ASP (ASPDEV)

Indique l'unité ASP à inclure dans l'opération de sauvegarde.

*DFT

L'opération utilise la valeur ASPDEV appropriée pour le système de fichiers d'où les objets sont sauvegardés. *ALLAVL est utilisé pour les objets du système de fichiers intégré. La commande de sauvegarde par défaut correspondante, ASPDEV, est utilisée pour les objets du système de fichiers QSYS.

*ALLAVL

L'opération inclut l'ASP système (ASP numéro 1), tous les ASP utilisateur de base (ASP numéros 2 à 32) et tous les ASP indépendants disponibles.

*

L'opération inclut l'ASP système, tous les ASP utilisateur de base et, si l'unité d'exécution en cours 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.

Recherche d'objets (SCAN)

Indique si la recherche des objets sera effectuée au cours de la sauvegarde lorsque des programmes d'exit sont enregistrés avec les points d'exit de recherche du système de fichiers intégré. Indique également si les objets pour lesquels une recherche a déjà échoué doivent être sauvegardés.

Les points d'exit liés au scannage du système de fichiers intégré sont les suivants :

• QIBM_QP0L_SCAN_OPEN - Programme d'exit d'analyse à l'ouverture du système de fichiers intégré QIBM_QP0L_SCAN_OPEN - Integrated File System Scan on Open Exit Program
• QIBM_QP0L_SCAN_CLOSE - Programme d'exit d'analyse à la fermeture du système de fichiers intégré QIBM_QP0L_SCAN_CLOSE - Integrated File System Scan on Close Exit Program

Pour plus d'informations sur ces points d'exit, reportez-vous au manuel Ensemble de rubriques API de la catégorie Programmation de l'IBM i Information Center (http://www.ibm.com/systems/i/infocenter/).

Elément 1 : Recherche pendant sauvegarde

*NO

La recherche des objets ne sera pas effectuée par les programmes d'exit appropriés.

*YES

La recherche des objets sera effectuée en fonction des règles décrites dans les programmes d'exit appropriés.

Elément 2 : Sauvegarde des objets en échec

*NOSAVFAILED

Les objets pour lesquels une recherche a déjà échoué ou pour lesquels une recherche a échoué en raison d'un programme d'exit QIBM_QP0L_SCAN_OPEN lors de cette sauvegarde ne seront pas sauvegardés.

*SAVFAILED

Les objets pour lesquels une recherche a déjà échoué ou pour lesquels une recherche a échoué lors de cette sauvegarde seront sauvegardés.

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.

Mise en mode asynchrone (ASYNCBRING)

Indique si les objets doivent être mis en mémoire de manière asynchrone lors du traitement de la sauvegarde. Selon l'arborescence de répertoires, la quantité de mémoire disponible et le nombre d'objets admissibles pour la sauvegarde, la mise en mémoire des objets de façon asynchrone peut permettre d'améliorer les performances de sauvegarde. Des performances optimales sont obtenues avec une arborescence de répertoires bien équilibrée dans laquelle tous les objets sont admissibles pour la sauvegarde. Lorsqu'un grand nombre d'objets réside dans un seul répertoire et que peu d'entre eux sont admissibles pour la sauvegarde ou lorsque la mémoire du système est limitée, les performances peuvent être altérées si le paramètre ASYNCBRING(*YES) est spécifié.

*NO

Les objets ne sont pas mis en mémoire de façon asynchrone.

*YES

Les objets sont mis en mémoire de façon asynchrone.

Exemples

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

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

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

Exemple 2 : Sauvegarde des modifications depuis la dernière sauvegarde des objets

SAV   DEV('/QSYS.LIB/TAP01.DEVD')
      OBJ(('/*') ('/QSYS.LIB' *OMIT) ('/QDLS' *OMIT))
      CHGPERIOD(*LASTSAVE)

Cette commande sauvegarde tous les objets qui ne se trouvent pas dans des bibliothèques et qui ne sont pas des objets de bibliothèque de documents, et qui ont été modifiés depuis leur dernière sauvegarde avec UPDHST(*YES) indiqué.

Exemple 3 : Sauvegarde des données qui n'ont pas été modifiées depuis 1999

SAV   DEV('/QSYS.LIB/TAP01.DEVD')
OBJ(('/*') ('/QSYS.LIB' *OMIT) ('/QDLS' *OMIT))
CHGPERIOD((*ALL *ALL '12/31/99'))

Cette commande sauvegarde tous les objets qui ne se trouvent pas dans des bibliothèques, qui ne sont pas des objets de bibliothèque de documents et qui n'ont pas été modifiées depuis le 31 décembre 1999.

Exemple 4 : Sauvegarde de tous les objets du répertoire courant

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

Cette commande utilise la valeur par défaut '*' dans le paramètre OBJ pour sauvegarder tous les objets du répertoire en cours et de ses sous-répertoires. Cet exemple ne s'applique pas si le répertoire en cours est le répertoire racine ou s'il se trouve dans le système de fichiers QDLS.

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

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

Exemple 5 : Omission d'objets au cours d'une opération de sauvegarde

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

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

SAV   DEV('/QSYS.LIB/TAP01.DEVD')
      OBJ(('/A') ('/A/B/C' *OMIT))

Cette commande sauvegarde tous les objets du répertoire /A et de ses sous-répertoires, sauf ceux du répertoire /A/B/C.

Exemple 6 : Sauvegarde d'une bibliothèque

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

Cette commande sauvegarde la bibliothèque A sur l'unité de bande TAP01.

Exemple 7 : Sauvegarde de deux bibliothèques

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

Ces deux commandes sauvegardent deux bibliothèques. La première commande sauvegarde la bibliothèque A et la seconde, la bibliothèque B.

Exemple 8 : Sauvegarde de tous les fichiers d'une bibliothèque

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

Cette commande sauvegarde tous les fichiers de bibliothèque MYLIB sur l'unité de bande TAP01.

Exemple 9 : Sauvegarde de deux objets d'une bibliothèque

SAV   DEV('/QSYS.LIB/TAP01.DEVD')
      OBJ('/QSYS.LIB/MYLIB.LIB/MYPGM.PGM')
SAV   DEV('/QSYS.LIB/TAP01.DEVD')
      OBJ('/QSYS.LIB/MYLIB.LIB/MYFILE.FILE')

Ces deux commandes sauvegardent deux objets de la même bibliothèque. La première commande sauvegarde le programme MYPGM à partir de la bibliothèque MYLIB. La seconde commande sauvegarde le fichier MYFILE à partir de la bibliothèque MYLIB.

Exemple 10 : Sauvegarde d'un fichier STREAM, d'un fichier de base de données et d'un document

SAV   DEV('/QSYS.LIB/TAP01.DEVD')  OBJ('/MyDir/MyFile')
SAV   DEV('/QSYS.LIB/TAP01.DEVD')
      OBJ('/QSYS.LIB/MYLIB.LIB/MYFILE.FILE')
SAV   DEV('/QSYS.LIB/TAP01.DEVD')
      OBJ('/QDLS/MYFLR/MYDOC')  SUBTREE(*OBJ)  UPDHST(*YES)

Trois commandes sont utilisées dans cet exemple pour sauvegarder trois objets. La première commande sauvegarde le fichier STREAM MyFile du répertoire MyDir sur l'unité de bande TAP01. La seconde commande sauvegarde le fichier de base de données MYFILE du répertoire MYLIB sur l'unité de bande TAP01. La troisième commande sauvegarde le document MYDOC dans un dossier nommé MYFLR sur l'unité de bande TAP01.

Exemple 11 : Sauvegarde vers un fichier sauvegarde

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

Cette commande sauvegarde le répertoire MYDIR dans un fichier sauvegarde nommé MYSAVF.

Exemple 12 : Utilisation de liens symboliques pour l'opération de sauvegarde

SAV   DEV('DevLink')
      OBJ(('DirLink') ('FileLink') ('DirLink/*'))
      SAVACT(*YES)  SAVACTMSGQ('MsgqLink')

Cette commande suppose que le répertoire courant contienne les liens symboliques suivants:

• DevLink = /QSYS.LIB/TAP01.DEVD
• DirLink = /SomeDirectory
• FileLink = /SomeDirectory/SomeFile
• MsgqLink = /QSYS.LIB/LIB1.LIB/MSGQ1.MSGQ

Cette commande sauvegarde les noms associés à DirLink et FileLink, ainsi que les objets de SomeDirectory, sur l'unité TAP01. Un message est envoyé lorsque le point de contrôle de sauvegarde en mise à jour est terminé.

Des liens symboliques permettent d'indiquer une unité, une file d'attente de message de sauvegarde en mise à jour et un fichier de sortie. Lorsque des liens symboliques sont indiqués pour être sauvegardés, seuls les noms des objets associés sont sauvegardés et non leur contenu. Un lien symbolique vers un répertoire permet de sauvegarder les objets que celui-ci contient. Vous trouverez des informations supplémentaires concernant les liens symboliques dans la rubrique sur les systèmes de fichiers intégrés de la catégorie Systèmes de fichiers et gestion du Centre de documentation.

Exemple 13 : Sauvegarde d'un espace de stockage en cours d'activité

SAV   DEV('/QSYS.LIB/MYLIB.LIB/MYSAVF.FILE')
      OBJ(('/QFPNWSSTG/MYDISK'))
      SAVACT(*YES)  SAVACTOPT(*NWSSTG)

Cette commande sauvegarde les objets associés à l'espace de stockage '/QFPNWSSTG/MYDISK' même si l'option *NWSD associée est modifiée.

Exemple 14 : Sauvegarde des partages à partir d'un serveur Windows, Linux ou AIX

SAV   DEV('/QSYS.LIB/MYLIB.LIB/MYSAVF.FILE')
      OBJ(('/QNTC/MYSERVER/MYSHARE'))

Cette commande sauvegarde MYSHARE et tous les objets contenus dans le partage à partir d'un serveur appelé '/QNTC/MYSERVER'. L'exemple considère que le serveur MYSERVER a été configuré correctement avant d'exécuter la commande SAV. Pour plus d'informations sur la sauvegarde au niveau du fichier pour les serveurs Windows, Linux et AIX, voir Ensemble de rubriques Sauvegarde et reprise de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Messages d'erreur

Messages *ESCAPE

CPFA0DB

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

CPFA0DC

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

CPF3708

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

CPF3727

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

CPF3735

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

CPF3738

L'unité &1 utilisée pour la sauvegarde/restauration est endommagé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.

CPF378A

File d'attente de messages indisponible.

CPF378C

SAVACTMSGQ(*WRKSTN) incompatible avec travail par lots.

CPF3782

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

CPF3794

La sauvegarde ou la restauration n'a pas abouti.

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

CPF380D

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

CPF3808

Fichier sauvegarde &2 de &3 incomplet.

CPF381D

Valeurs du paramètre CHGPERIOD incorrectes.

CPF3812

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

CPF382B

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

CPF382C

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

CPF382E

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

CPF382F

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

CPF3823

Aucun objet sauvegardé ou restauré.

CPF3826

Objet *INCLUDE requis au paramètre OBJ.

CPF3828

Erreur lors de l'utilisation de &1.

CPF3829

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

CPF383A

Echec de la sauvegarde ou de la restauration.

CPF383B

Fin du fichier &1.

CPF383D

Impossible d'utiliser &1.

CPF3833

Valeur indiquée au paramètre DEV incorrecte.

CPF3834

Trop de valeurs au paramètre DEV.

CPF3835

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

CPF3837

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

CPF3838

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

CPF384A

Identificateur de volume &1 incorrect.

CPF384B

Le fichier optique indiqué est incorrect.

CPF384C

Erreur lors de la conversion du CCSID.

CPF384E

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

CPF386B

Impossible de sauvegarder &1.

CPF386C

Impossible de sauvegarder &1.

CPF3894

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

CPF38A5

Erreur du paramètre PATTERN.

CPF5729

Allocation de l'objet &1 impossible.

CPF9802

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

CPF9825

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