SAVDLO

La commande SAVDLO vous permet de sauvegarder une copie des documents, dossiers ou objets de distribution (courrier) indiqués.

Remarques :

• Lorsque vous sauvegardez un dossier, vous sauvegardez non seulement les documents contenus dans ce dossier et dans les sous-dossiers correspondants mais aussi tous les dossiers et documents imbriqués. Pour sauvegarder un dossier précis, indiquez DLO(*FLRLVL).
• Les objets de distribution (courrier) ne peuvent pas être sauvegardés ni restaurés pour un utilisateur particulier. Le courrier ne peut être sauvegardé que pour tous les utilisateurs en même temps.
• SAVDLO ne requiert pas un système dédié. Toutefois, les objets utilisés lors du lancement de la sauvegarde ne peuvent pas être sauvegardés. Pour que tous les objets de la bibliothèque de documents soient sauvegardés, exécutez cette commande lorsqu'aucune opération sur un document ou un dossier n'est en cours sur le système.

Restrictions :

• Vous devez disposer des droits spéciaux sur tous les objets (*ALLOBJ) ou de sauvegarde système (*SAVSYS) pour utiliser les combinaisons de paramètres suivantes dans cette commande :
  • DLO(*ALL) FLR(*ANY)
  • DLO(*CHG)
  • DLO(*MAIL)
  • DLO(*SEARCH) OWNER(*ALL)
  • DLO(*SEARCH) OWNER(nom-profil-utilisateur)

  où le nom-profil-utilisateur indiqué est différent de celui de l'utilisateur lançant la commande SAVDLO.

• Si vous ne disposez pas du droit spécial *ALLOBJ ou *SAVSYS, vous devez :
  • disposer du droit *ALL pour chaque document ou dossier à sauvegarder
  • être inscrit en tant qu'utilisateurs de DIA (Architecture d'échange de documents)
• La procédure de détermination de la propriété des documents ou des dossiers ne comprend pas la vérification de tout profil de groupe éventuellement associé au profil utilisateur indiqué.
• 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.

Paramètres

Document ou dossier (DLO)

Indique les documents ou dossiers à sauvegarder. Pour sauvegarder un dossier, vous devez indiquer DLO(*ALL).

Ce paramètre est obligatoire.

Valeurs uniques

*ALL

L'ensemble des objets qualifiés par le paramètre FLR sont sauvegardés. Si DLO(*ALL) FLR(*ANY) est indiqué, tous les documents, dossiers et objets de distribution (courrier) sont sauvegardés.

*SEARCH

Tous les objets de la bibliothèque de documents qui correspondent aux valeurs de recherche précisées sont sauvegardés. Les valeurs de recherche sont désignées par les paramètres suivants :

• Dossier (paramètre FLR).
• Vérification marquage (paramètre CHKFORMRK).
• Date d'expiration (paramètre CHKEXP).
• Date de création (paramètre CRTDATE).
• Classe de document (paramètre DOCCLS).
• Profil du propriétaire (paramètre OWNER).
• Date de dernière modification (paramètre REFCHGDATE).
• Heure de dernière modification (paramètre REFCHGTIME).

Remarque :Les dossiers ne sont sauvegardés que si SRCHTYPE(*ALL) est spécifié.

*CHG

Tous les documents créés ou modifiés ainsi que tous les dossiers créés depuis la dernière sauvegarde et tout le courrier sont sauvegardés.

*SYSOBJNAM

Les documents dont le nom d'objet système est indiqué pour le paramètre Nom d'objet système (SYSOBJNAM) sont sauvegardés.

*DOCL

Les documents référencés dans une liste de documents spécifiée pour le paramètre Liste de documents (DOCL) sont sauvegardés.

*MAIL

Les objets de distribution et les documents mentionnés dans un historique du courrier sont sauvegardés.

*FLRLVL

Les dossiers indiqués pour le paramètre Dossier (FLR) et les documents qu'ils contiennent sont sauvegardés. Mais les sous-dossiers ne le sont pas.

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

nom-document

Indiquez les noms attribués par l'utilisateur aux documents sauvegardés. Tous les documents indiqués doivent se trouver dans le même dossier, ce dernier devant être mentionné pour le paramètre Dossier (FLR).

Dossier (FLR)

Indique le nom du dossier à sauvegarder.

Valeurs uniques

*ANY

Les documents ou dossiers peuvent être sauvegardés à partir de n'importe quel dossier. Lors de l'utilisation du paramètre FLR, tenez compte des éléments suivants :

• FLR(*ANY) n'est pas admis si l'une des valeurs suivantes est indiquée :
  • DLO(*DOCL)
  • DLO(*FLRLVL)
  • DLO(nom-document)
• Vous devez préciser FLR(*ANY) lorsqu'une des valeurs suivantes est indiquée :
  • DLO(*CHG)
  • DLO(*SYSOBJNAM)
  • DLO(*MAIL)
  • DLO(*SEARCH) SRCHTYPE(*ALL)
• Si vous indiquez SAVDLO DLO(*ALL) FLR(*ANY), les éléments suivants sont sauvegardés :
  • tous les documents
  • tous les dossiers
  • tous les objets de distribution (courrier)

*NONE

Les documents sauvegardés ne se trouvent dans aucun dossier. FLR(*NONE) est correct uniquement si vous indiquez l'une des valeurs suivantes :

• DLO(*ALL)
• DLO(*SEARCH) SRCHTYPE(*DOC)

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

nom-dossier-générique

Indiquez un nom générique. Il s'agit d'une chaîne comportant un ou plusieurs caractères suivis d'un astérisque (*). Par exemple, ABC*. L'astérisque (*) remplace tout caractère admis. Un nom générique indique tous les objets dont le nom commence par le préfixe générique et pour lesquels l'utilisateur dispose de droits. Si le nom (préfixe) générique ne comporte pas d'astérisque, le système considère qu'il s'agit du nom complet de l'objet.

nom-dossier

Indiquez le nom attribué par l'utilisateur au dossier contenant les documents à sauvegarder. Ce nom doit comporter 63 caractères au maximum.

• Les objets de dossiers sont sauvegardés uniquement si vous indiquez DLO(*ALL) ou DLO(*FLRLVL).
• FLR(nom-dossier) n'est pas admis si vous indiquez l'une des valeurs suivantes :
  • DLO(*SYSOBJNAM)
  • DLO(*MAIL)
  • DLO(*SEARCH) SRCHTYPE(*ALL)
• Vous ne pouvez préciser qu'un seul nom de dossier si vous indiquez l'une des valeurs suivantes :
  • DLO(*DOCL)
  • DLO(*SEARCH) SRCHTYPE(*DOC)
  • DLO(nom-document)

Unité (DEV)

Indique le nom de l'unité utilisée pour la sauvegarde. Ce nom doit être connu du système en tant que description d'unité.

Ce paramètre est obligatoire.

Valeurs uniques

*SAVF

L'opération de sauvegarde est effectuée à l'aide du fichier sauvegarde indiqué à l'invite Fichier sauvegarde (paramètre SAVF).

Autres valeurs

nom-unité-optique

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

nom-unité-bandothèque

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

nom-unité-bande

Indiquez le nom d'une ou plusieurs unités de bande utilisées pour l'opération de sauvegarde. Si une unité de bande virtuelle est utilisée, aucune autre unité ne peut être spécifiée. Dans le cas d'unités de bande multiples, ces dernières doivent posséder des formats de support compatibles et leurs noms doivent être précisés dans l'ordre dans lequel elles sont utilisées. Lorsque vous vous servez de plusieurs unités de bande, vous pouvez rembobiner et décharger un volume, pendant qu'une autre unité de bande traite le volume suivant.

Type de recherche (SRCHTYPE)

Indique le type d'objet recherché. Ce paramètre n'est admis que si *SEARCH est indiqué pour le paramètre Document ou dossier (DLO).

*DOC

La recherche et la sauvegarde portent uniquement sur les documents.

*ALL

La recherche et la sauvegarde portent sur les documents et dossiers.

Vérification marquage (CHKFORMRK)

Indique si les documents marqués pour le stockage sont sauvegardés. Ce paramètre n'est admis que lorsque *SEARCH est indiqué pour le paramètre Document ou dossier (DLO) et lorsque *DOC est indiqué pour le paramètre Type de recherche (SRCHTYPE).

*NO

Les documents correspondant aux autres valeurs de recherche définies pour cette opération de sauvegarde sont sauvegardés, qu'ils soient marqués ou non pour le stockage.

*YES

Seuls sont sauvegardés les documents marqués pour le stockage qui répondent aux autres valeurs de recherche. Un document peut être marqué pour être :

• Conservé
• Libéré
• Supprimé

Date d'expiration (CHKEXP)

Indique que tous les documents dont la date de péremption est antérieure à la date indiquée doivent être sauvegardés. L'utilisateur définit cette date lors de la création d'un document pour indiquer le jour où ce dernier cessera d'être nécessaire. Ce paramètre n'est admis que lorsque *SEARCH est indiqué pour le paramètre Document ou dossier (DLO) et lorsque *DOC est indiqué pour le paramètre Type de recherche (SRCHTYPE).

*NO

La date de péremption n'est pas prise en compte.

*CURRENT

Tous les documents dont la date de péremption est antérieure à la date du jour sont sauvegardés.

date

Indiquez une date de péremption de document. Tous les documents dont la date de péremption est antérieure à cette date sont sauvegardés.

Date de création (CRTDATE)

Indique que les documents et les dossiers créés pendant la période donnée doivent être sauvegardés. La période comprend une heure et une date de début ainsi qu'une heure et une date de fin. Ce paramètre n'est admis que si *SEARCH est indiqué pour le paramètre Document ou dossier (DLO). La période est présentée comme suit :

((heure-début  date-début) (heure-fin  date-fin))

Elément 1: Heure et date de début

Elément 1: Heure de début

Utilisez l'une des valeurs suivantes pour indiquer l'heure de début. Seuls les documents créés après cette heure sont sélectionnés. Les documents créés antérieurement sont exclus.

*AVAIL

Tous les documents et dossiers, répertoriés à n'importe quel moment, peuvent être sauvegardés.

heure

Indiquez une heure de début pour la date de création. Lorsque l'heure de début est utilisée comme valeur de recherche, la date de début doit être différente de *BEGIN. Cette heure doit être identique à la valeur indiquée au paramètre Heure de dernière modification (REFCHGTIME) lorsque ce dernier est précisé. Vous pouvez indiquer l'heure avec ou sans séparateur :

• Si vous n'utilisez pas de séparateur d'heure, indiquez une chaîne au format hhmm ou hhmmss (4 ou 6 chiffres), où hh = heures, mm = minutes et ss = secondes.
• Si vous utilisez un séparateur d'heure, indiquez une chaîne de 5 à 8 chiffres dans laquelle le séparateur d'heure indiqué pour le travail est placé entre les heures, les minutes et les secondes. Si vous entrez cette commande depuis la ligne de commande, vous devez mettre la chaîne entre apostrophes. Cette commande n'aboutit pas si vous utilisez un séparateur autre que celui indiqué pour votre travail.

Elément 2: Date de début

Utilisez l'une des valeurs suivantes pour indiquer la date de début. Seuls les documents créés à cette date ou ultérieurement sont sauvegardés. Les documents créés antérieurement sont exclus.

*BEGIN

Tous les documents et dossiers sont sauvegardés quelle que soit leur date de création.

*CURRENT

Seuls les documents et dossiers répertoriés à la date du jour et après l'heure de début (si elle est précisée) sont sélectionnés.

date

Définissez une date de début pour la création du document. Vous devez entrer une valeur au format de date utilisé pour le travail. Cette heure doit être identique à la valeur indiquée au paramètre Date de dernière modification (REFCHGDATE) lorsque ce dernier est précisé.

Elément 2: Heure et date de fin

Elément 1: Heure de fin

Utilisez l'une des valeurs suivantes pour indiquer l'heure de fin. Seuls les documents créés avant cette heure sont sauvegardés. Les documents créés ultérieurement sont exclus.

*AVAIL

Tous les documents et dossiers, répertoriés à n'importe quelle heure, sont sélectionnés pour la sauvegarde.

heure

Définissez une heure de fin pour la date de création. Lorsque l'heure de fin est utilisée comme valeur de recherche, la date de fin doit être différente de *END. Pour plus de détails sur la manière d'indiquer l'heure, reportez-vous à la description de la valeur heure-début

Elément 2: Date de fin

Utilisez l'une des valeurs suivantes pour indiquer la date de fin. Seuls les documents créés à cette date ou antérieurement sont sauvegardés. Les documents créés ultérieurement sont exclus.

*END

Tous les documents et dossiers, répertoriés à n'importe quelle date, sont sélectionnés. Lorsque *END est précisé, l'heure de fin n'est pas admise.

date

Indiquez la date de fin pour la date de création du document. Seuls les documents créés à cette date ou antérieurement sont sauvegardés. La date doit être indiquée au format de date utilisé pour le travail.

Classe de document (DOCCLS)

Indique la classe des documents à sauvegarder. Celle-ci est attribuée par l'utilisateur lors de la création du document. Ce paramètre n'est admis que lorsque *SEARCH est indiqué pour le paramètre Document ou dossier (DLO) et lorsque *DOC est indiqué pour le paramètre Type de recherche (SRCHTYPE).

Remarque :Considérations DBCS : non applicable.

*ANY

La classe de document n'est pas utilisée pour la sélection des documents à sauvegarder.

valeur-alphanumérique

Indiquez la classe du document de 1 à 16 caractères, afin de sélectionner les documents à sauvegarder.

Profil du propriétaire (OWNER)

Désigne le propriétaire des documents et des dossiers à sauvegarder. Ce paramètre n'est admis que si *SEARCH est indiqué pour le paramètre Document ou dossier (DLO).

*CURRENT

Les documents et dossiers appartenant au demandeur actuel sont sauvegardés.

*ALL

Ce paramètre n'est pas utilisé pour la sélection des documents et des dossiers à sauvegarder. Vous devez disposer des droits spéciaux sur tous les objets (*ALLOBJ) ou de sauvegarde système (*SAVSYS) si *ALL est indiqué.

nom

Indiquez le nom du profil de l'utilisateur propriétaire des documents et des dossiers à sauvegarder. Tous les documents et dossiers appartenant à cet utilisateur et correspondant aux autres valeurs de recherche indiquées sont sauvegardés. Si le profil utilisateur sélectionné et celui du demandeur sont différents, vous devez disposer des droits spéciaux *ALLOBJ ou *SAVSYS.

Date de dernière modification (REFCHGDATE)

Indique que les dossiers créés et les documents modifiés ou créés après la date précisée seront sauvegardés. La date de modification est mise à jour à chaque fois que la description ou le contenu du document est modifié. Ce paramètre n'est admis que si *SEARCH est indiqué pour le paramètre Document ou dossier (DLO).

*ANY

Aucune date de modification n'est indiquée comme référence. Les documents sont sauvegardés quelle que soit la date de leur création ou de leur dernière modification. Les dossiers sont sauvegardés quelle que soit leur date de création.

*SAVDLOALL

Les dossiers créés et les documents créés ou modifiés depuis la dernière sauvegarde totale sont sauvegardés.

date

Indiquez la date à partir de laquelle les dossiers créés et les documents modifiés ou créés sont sauvegardés.

Heure de dernière modification (REFCHGTIME)

Indique que les dossiers créés et les documents modifiés ou créés après l'heure précisée (à la date indiquée au paramètre REFCHGDATE) seront sauvegardés. L'heure de modification est mise à jour à chaque fois que la description ou le contenu d'un document est modifié. Ce paramètre n'est admis que si *SEARCH est indiqué pour le paramètre Document ou dossier (DLO).

*ANY

Aucune heure n'est indiquée. Les documents sont sauvegardés quelle que soit l'heure à laquelle ils ont été créés ou modifiés. Les dossiers sont sauvegardés quelle que soit l'heure de leur création.

heure

Indiquez l'heure à partir de laquelle les dossiers créés ou les documents modifiés, ou créés, sont sauvegardés.

Vous pouvez indiquer l'heure avec ou sans séparateur :

• Si vous n'utilisez pas de séparateur d'heure, indiquez une chaîne au format hhmm ou hhmmss (4 ou 6 chiffres), où hh = heures, mm = minutes et ss = secondes.
• Si vous utilisez un séparateur d'heure, indiquez une chaîne de 5 à 8 chiffres dans laquelle le séparateur d'heure indiqué pour le travail est placé entre les heures, les minutes et les secondes. Si vous entrez cette commande depuis la ligne de commande, vous devez mettre la chaîne entre apostrophes. Cette commande n'aboutit pas si vous utilisez un séparateur autre que celui indiqué pour votre travail.

Nom d'objet système (SYSOBJNAM)

Indique les noms d'objet système des documents sauvegardés, lorsque *SYSOBJNAM est précisé pour le paramètre Document ou dossier (DLO).

Valeurs uniques

*NONE

Aucun nom d'objet système n'est indiqué.

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

nom

Entrez le nom d'objet système du document à sauvegarder. Vous devez entrer 10 caractères.

Liste de documents (DOCL)

Désigne une liste de documents à sauvegarder. Cette liste doit se trouver dans un dossier. Le nom du dossier doit être indiqué à l'aide du paramètre Dossier (FLR). Vous devez disposer du droit *USE sur les dossiers contenant les documents de cette liste.

Remarque :Seule une recherche locale (et non éloignée) est admise pour une liste de documents.

*NONE

Aucune liste de documents n'est sauvegardée.

valeur-alphanumérique

Indiquez le nom de la liste de documents à sauvegarder.

Identificateur de volume (VOL)

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

Valeurs uniques

*MOUNTED

Les données sont sauvegardées sur les volumes montés sur l'unité. Dans le cas d'une unité de médiathèque, le volume à utiliser correspond à la cartouche suivante de la catégorie montée à l'aide de la commande SETTAPCGY (Définir une catégorie de bande).

Remarque :Vous ne pouvez pas indiquer cette valeur si vous utilisez une unité de bibliothèque optique.

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

valeur-alphanumérique

Indiquez les identificateurs d'un ou de plusieurs volumes selon l'ordre dans lequel ils sont montés sur l'unité et utilisés pour la sauvegarde des données.

Numéro de séquence (SEQNBR)

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

*END

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

1 à 16777215

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

Date d'expiration du fichier (EXPDATE)

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

Remarques :

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

*PERM

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

date

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

Option de fin de support (ENDOPT)

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

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

*REWIND

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

*LEAVE

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

*UNLOAD

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

Label (LABEL)

Indique le nom identifiant le fichier de données écrit sur la bande utilisée pour la sauvegarde. Le paramètre LABEL, s'il est utilisé, doit être indiqué dans la commande de restauration.

*GEN

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

valeur-alphanumérique

Indiquez l'identificateur de fichier de données utilisé comme label du fichier de données pour l'opération de sauvegarde. Vous pouvez indiquer jusqu'à 17 caractères.

Taille optimale de bloc (USEOPTBLK)

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

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

*YES

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

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

*NO

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

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

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

Dossiers à omettre (OMITFLR)

Indique le nom d'un ou de plusieurs dossiers, ou les noms génériques de chaque groupe de dossiers à exclure de l'opération de sauvegarde.

Valeurs uniques

*NONE

Aucun dossier n'est exclu de l'opération de sauvegarde.

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

nom-dossier-générique

Indiquez un nom générique. Il s'agit d'une chaîne comportant un ou plusieurs caractères suivis d'un astérisque (*). Par exemple, ABC*. L'astérisque (*) remplace tout caractère admis. Un nom générique indique tous les dossiers dont le nom commence par le préfixe générique et pour lesquels l'utilisateur dispose de droits. Si le nom (préfixe) générique ne comporte pas d'astérisque, le système considère qu'il s'agit du nom complet du dossier.

nom-dossier

Indiquez le nom du dossier à exclure de 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 nom et la bibliothèque du fichier base de données auquel sont envoyées les informations concernant les documents ou dossiers lorsque *OUTFILE est précisé pour le paramètre OUTPUT (Sortie). Si ce fichier n'existe pas, cette commande crée un fichier base de données dans la bibliothèque indiquée. Dans ce cas, le système utilise le fichier modèle QAOJSAVO de QSYS, avec le nom de format QJSDLO.

Qualificateur 1: Fichier recevant la sortie

nom

Indiquez le nom du fichier base de données devant recevoir la sortie de la commande. Si ce fichier n'existe pas, il est créé dans la bibliothèque indiquée.

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. Si aucune bibliothèque n'est indiquée comme bibliothèque en cours, la bibliothèque QGPL est utilisée.

nom

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

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

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.

Mémoire secondaire (STG)

Indique si la mémoire secondaire du système occupée par le document à sauvegarder est conservée, supprimée ou libérée après la sauvegarde.

Remarque : STG(*DELETE) et STG(*FREE) ne sont pas admis si au moins l'un des paramètres suivants est indiqué :

• DLO(*ALL) FLR(*ANY)
• DLO(*SEARCH) CHKFORMRK(*YES)
• DLO(*CHG)
• DLO(*MAIL)
• SAVACT(*YES)

*KEEP

La mémoire secondaire occupée par le document est conservée après la sauvegarde.

*DELETE

Le document et tous les termes de recherche sont supprimés du système après la sauvegarde.

*FREE

La description du document et les termes de recherche sont conservés sur le système, mais la mémoire secondaire occupée par le document à sauvegarder est supprimée après la sauvegarde. Il est impossible d'utiliser ce document tant qu'il n'a pas été restauré sur le système.

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

ID caractères pour commande (CMDCHRID)

Désigne l'identificateur de caractères (jeu de caractères graphiques et page de codes) des données entrées pour le paramètre DOCCLS (Classe de document). L'identificateur de caractères est lié à l'unité écran utilisée pour entrer la classe de document.

Valeurs uniques

*SYSVAL

Le système détermine les valeurs de jeu de caractères graphiques et de page de codes pour les paramètres de commande à partir de la valeur système QCHRID.

*DEVD

Le système détermine le jeu de caractères graphiques et la page de codes applicables à partir de la description d'unité écran sur laquelle la commande a été entrée. Cette option ne peut être utilisée que pour un travail interactif. Si elle est indiquée pour un travail par lots, une erreur se produit.

Elément 1 : Jeu de caractères graphiques

1 à 32767

Indiquez le jeu de caractères graphiques à utiliser.

Elément 2 : Page de codes

1 à 32767

Indiquez la page de codes à utiliser.

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.

Sauvegarde en mise à jour (SAVACT)

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

*NO

Les documents ou dossiers en cours d'utilisation ne sont pas sauvegardés et ne peuvent pas être mis à jour.

*YES

Les documents ou dossiers peuvent être modifiés pendant la demande de sauvegarde.

Remarque :Certaines applications mettent à jour directement les documents ou dossiers. Dans ce cas, les données sont fournies à l'application, contrairement au processus habituel, où les mises à jour sont stockées dans un fichier temporaire puis appliquées aux documents ou dossiers. Les documents ou dossiers mis à jour directement, en général ceux qui sont mis à jour par des applications PC, ne sont pas sauvegardés. Pour plus d'informations sur l'utilisation de ce paramètre, reportez-vous au manuel Ensemble de rubriques Sauvegarde et reprise de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Temps d'attente si mise à jour (SAVACTWAIT)

Indique la durée d'utilisation d'un objet, avant de poursuivre l'opération de sauvegarde. Si l'objet reste utilisé pendant le temps indiqué, il n'est pas sauvegardé.

120

Le système attend jusqu'à 120 secondes pour que chaque objet individuel soit disponible avant de poursuivre l'opération de sauvegarde.

*NOMAX

Le délai d'attente est illimité.

0-99999

Indiquez le nombre de secondes d'attente pour chaque objet individuel avant de poursuivre l'opération de sauvegarde.

Numéro d'ASP (ASP)

Indique le numéro du pool de mémoire secondaire (ASP) de l'objet de la bibliothèque de documents (DLO) à sauvegarder.

*ANY

Les objets à sauvegarder résident dans n'importe quel ASP. Lorsque DLO(*ALL) et FLR(*ANY) sont indiqués, tous les objets de la bibliothèque de documents du système sont sauvegardés.

Remarque : Lorsque plusieurs objets DLO sont sauvegardés à partir de plusieurs ASP, plusieurs fichiers bande sont créés. Les numéros de séquence de début et de fin de chacun de ces fichiers seront requis à la commande RSTDLO pour restaurer tous les ASP.

1-32

Indiquez le nombre d'un ASP existant contenant les documents ou dossiers à sauvegarder. L'ASP 1 correspond à l'ASP système.

Remarque :Le courrier non classé et les documents qui ne se trouvent pas dans un dossier sont dans l'ASP système.

Exemples

Exemple 1 : Exécution d'une opération de sauvegarde complète

SAVDLO   DLO(*ALL)  FLR(*ANY)  DEV(TAP01)

Cette commande sauvegarde tous les dossiers, documents et courriers sur l'unité de bande TAP01.

Exemple 2 : Sauvegarde de toutes les modifications

SAVDLO   DLO(*CHG)  DEV(TAP01)

Cette commande sauvegarde tous les documents créés ou modifiés depuis la dernière opération de sauvegarde complète, les dossiers créés depuis la dernière opération de sauvegarde complète, et tout le courrier.

Exemple 3 : Sauvegarde d'un ASP complet

SAVDLO   DLO(*ALL)  DEV(TAP01)  FLR(*ANY)  ASP(2)

Cette commande sauvegarde tous les dossiers et documents dans l'ASP utilisateur 2.

Exemple 4 : Sauvegarde des objets modifiés après une date donnée

SAVDLO   DLO(*SEARCH)  DEV(TAP01)  OWNER(*ALL)
         REFCHGDATE('01/01/2002')

Cette commande sauvegarde tous les documents créés ou modifiés après le 1er janvier 2002. Elle permet de sauvegarder des modifications entre des sauvegardes des documents. Celle est similaire à la commande de sauvegarde des objets modifiés (SAVCHGOBJ) utilisée pour d'autres types d'objets.

Exemple 5 : Sauvegarde des documents et des dossiers modifiés après une date donnée

SAVDLO   DLO(*SEARCH)  DEV(TAP01)  SRCHTYPE(*ALL)  OWNER(*ALL)
         REFCHGDATE('01/01/2002')

Cette commande sauvegarde tous les dossiers créés depuis le 01/01/2002 et tous les documents créés ou modifiés depuis le 01/01/2002.

Exemple 6 : Sauvegarde des documents créés après une date donnée

SAVDLO   DLO(*SEARCH)  DEV(TAP01)
         CRTDATE((*AVAIL '01/01/2002'))  OWNER(*ALL)

Cette commande sauvegarde tous les documents créés ou modifiés depuis le 01/01/2002.

Exemple 7 : Sauvegarde des documents et des dossiers créés après une date donnée

SAVDLO   DLO(*SEARCH)  DEV(TAP01)  SRCHTYPE(*ALL)
         CRTDATE((*AVAIL '01/01/2002'))  OWNER(*ALL)

Cette commande sauvegarde tous les documents et dossiers créés depuis le 01/01/2002.

Exemple 8 : Libération du stockage système pendant l'opération de sauvegarde

SAVDLO   DLO(DOCX)  FLR(FOLDERA)  DEV(TAP01)  STG(*FREE)

Cette commande sauvegarde le document nommé DOCX du dossier FOLDERA sur l'unité de bandeTAP01. Dans le cadre de l'opération de sauvegarde, le stockage système qui était occupé par la portion de données du document est libéré.

Exemple 9 : Sauvegarde des dossiers

SAVDLO   DLO(*ALL)  DEV(*SAVF)  FLR(BILL TOM MARY)  SAVF(SAVF1)

Cette commande sauvegarde les dossiers BILL, TOM et MARY, ainsi que tous les documents qu'ils contiennent.

Exemple 10 : Sauvegarde du niveau dossier seulement d'un dossier

SAVDLO   DLO(*FLRLVL)  FLR(DEC01)  DEV(*SAVF)  SAVF(MYLIB/SAVF1)

Cette commande sauvegarde le dossier DEC01 dans le STATUS et tous les documents de ce dossier dans le fichier de sauvegarde SAVF1 dans la bibliothèque MYLIB. Les sous-dossiers de ce dossier ne sont pas sauvegardés.

Exemple 11 : Sauvegarde du courrier seulement

SAVDLO   DLO(*MAIL)  DEV(*SAVF)

Cette commande sauvegarde tous les objets de distribution et tous les documents auxquels ils font référence par un historique du courrier.

Messages d'erreur

Messages *ESCAPE

CPF3728

Unité &1 indiquée avec d'autres unités.

CPF3733

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

CPF3767

Unité &1 non trouvée.

CPF3768

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

CPF3793

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

CPF3812

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

CPF384D

Opération de sauvegarde ou restauration non admise sur l'ASP &1.

CPF384E

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

CPF8AC3

L'ASP &5 est incorrect.

CPF8A47

Objets internes du système en cours d'utilisation.

CPF90B2

Liste de noms de dossiers incompatible avec paramètre DLO.

CPF90C1

Liste de documents &1 vide.

CPF90C2

Liste de documents &1 non utilisée.

CPF90D7

Documents non sauvegardés.

CPF90E1

Dossier &1 incompatible avec TGTRLS(*PRV).

CPF90E5

Non autorisé à liste de documents &1.

1PF9006

Utilisateur non inscrit dans le répertoire de distribution du système.

CPF902E

&1 documents ou dossiers sauvegardés. &10 non sauvegardés.

CPF903B

Trop d'objets pour le fichier sauvegarde.

CPF903C

Aucun document ou dossier sauvegardé.

CPF9030

Profil propriétaire (&1) introuvable.

CPF9046

Aucun document ne répond aux critères de recherche dans le dossier &1.

CPF9053

Vous n'êtes pas autorisé à utiliser cette fonction.

CPF9056

Vous n'êtes pas autorisé à utiliser cette fonction.

CPF906B

Aucun document ou dossier sauvegardé.

CPF908A

Le demandeur &1 n'est pas inscrit.

CPF9096

Impossible utiliser CMDCHRID(*DEVD) ou DOCCHRID(*DEVD) en traitement par lots.

CPF941B

La zone de données de sauvegarde &1 est en cours d'utilisation.

CPF9410

&1 documents ou dossiers sauvegardés. &10 non sauvegardés.

CPF9411

Modifications non sauvegardées pour l'ASP &1.

CPF9417

Valeur CRTDATE incompatible avec REFCHGDATE ou REFCHGTIME.

CPF9418

Paramètre SAVF incorrect.

CPF9419

LABEL(*GEN) requis.

CPF9810

Bibliothèque &1 non trouvée.

CPF9812

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

CPF9820

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

CPF9822

Non autorisé au fichier &1 de &2.

CPF9825

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

CPF9830

Allocation de la bibliothèque &1 impossible.

CPF9831

Allocation de l'unité &1 impossible.

CPF9845

Erreur lors de l'ouverture du fichier &1.

CPF9846

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

CPF9850

Substitution non admise pour fichier imprimante &1.

CPF9851

Valeur de ligne fin de page trop faible pour fichier &1 dans &2.

CPF9860

Erreur lors du traitement du fichier de sortie.

CPF9899

Erreur lors du traitement de la commande.