SAVLICPGM

La commande SAVLICPGM (Sauvegarder un logiciel sous licence) permet de sauvegarder tous les objets composant un logiciel sous licence. Le logiciel ainsi sauvegardé peut être restauré à l'aide de la commande RSTLICPGM (Restaurer un logiciel sous licence).

Restrictions :

1. Pour utiliser cette commande, vous devez disposer du droit *ALLOBJ ou obtenir un droit spécifique auprès du responsable de la sécurité.
2. Un volume de bande portant des labels standard doit être placé sur l'unité.
3. Certains logiciels sous licence ne peuvent être sauvegardés que si l'utilisateur est inscrit dans la liste de distribution du système. Pour plus de détails sur cette restriction, reportez-vous à la documentation correspondant à chaque logiciel.
4. Cette commande ne sauvegarde pas les objets code ou langue du système d'exploitation de base.
5. Vous pouvez spécifier au plus une unité optique, un fichier sauvegarde, une unité de bande virtuelle ou une bandothèque.

Paramètres

Produit (LICPGM)

Indique l'identificateur à sept caractères du logiciel sous licence à sauvegarder.

Ce paramètre est obligatoire.

Unité (DEV)

Indique le nom des unités de bande ou des unités optiques utilisées pour la sauvegarde des logiciels sous licence. Chaque nom d'unité doit être connu du système en tant que description d'unité. Pour afficher le nom des unités disponibles sur le système, utilisez la commande WRKDEVD (Gérer les descriptions d'unités).

Ce paramètre est obligatoire.

*SAVF

Le produit est sauvegardé dans le fichier sauvegarde indiqué au paramètre SAVF.

nom-unité-optique

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

nom-unité-bandothèque

Indiquez le nom de l'unité de bandothèque utilisée pour la sauvegarde.

nom-unité-bande

Indiquez le nom d'une ou de plusieurs unités de bande à utiliser pour la sauvegarde. Si une unité de bande virtuelle est utilisée, aucune autre unité ne peut être indiquée. Si plusieurs unités sont utilisées, leurs formats de support doivent être compatibles, et leurs noms indiqués dans l'ordre d'utilisation. Si vous utilisez plusieurs unités de bande, vous pouvez rembobiner/démonter une bande sur l'une d'elles tandis qu'une autre traite le volume suivant.

Option à sauvegarder (OPTION)

Indique les options du logiciel sous licence entré en regard de l'invite Produit (paramètre LICPGM) à sauvegarder.

*BASE

Seuls les éléments de base du logiciel sous licence seront sauvegardés.

numéro-option-logiciel-sous-licence

Indiquez le numéro correspondant à l'option du logiciel sous licence à sauvegarder.

Edition (RLS)

Indique la version, l'édition et le niveau de modification du logiciel sous licence à sauvegarder.

*ONLY

L'option du logiciel sous licence n'est installée que dans une seule version, édition et niveau de modification.

niveau-édition

Le niveau d'édition peut être transmis dans l'un des deux formats suivants :

Indiquez le niveau d'édition au format VxRyMz, où Vx est le numéro de version, Ry, le numéro d'édition et Mz, le niveau de modification. Les valeurs admises pour x et y sont comprises entre 0 et 9, et pour z entre 0 et 9 et entre A et Z.

Indiquez le niveau d'édition en utilisant le format vvrrmm. vv correspond à des caractères numériques compris entre 00 et 35 et représentant la version du produit, rr correspond à des caractères numériques compris entre 00 et 35 et représentant l'édition du produit, et mm correspond à une valeur comprise entre 00 et 09 ou entre 0A et 0Z et représentant le niveau de modification du produit. Ce format doit être utilisé si la version ou l'édition du produit est supérieure à 9.

Langue du logiciel ss/licence (LNG)

Indique la version en langue nationale (NLV) utilisée pour l'opération de sauvegarde.

Remarque :Ce paramètre n'est pas pris en compte lorsque OBJTYPE(*PGM) est indiqué.

*PRIMARY

La langue principale est sauvegardée. La langue principale est la langue du système d'exploitation.

Remarque :Pour afficher la langue principale du système d'exploitation, utilisez GO LICPGM et l'option 20.

*ALL

Toutes les langues sont sauvegardées.

code-dispositif

Indiquez l'identificateur NLV (version en langue nationale) de la langue qui est sauvegardée pour le logiciel sous licence.

Type d'objet (OBJTYPE)

Indique le type des objets du logiciel sous licence à sauvegarder.

*ALL

Les objets programme et les objets langue indiqués au paramètre LNG sont sauvegardés.

*PGM

Seuls les objets programme du logiciel sous licence sont sauvegardés.

*LNG

Les objets associés à la version en langue nationale (NLV) identifiée au paramètre LNG sont sauvegardés.

Vérifier signature (CHKSIG)

Indique si les signatures numériques des objets sauvegardés avec le logiciel sous licence doivent être vérifiées.

*SIGNED

Les objets ayant des signatures numériques sont vérifiés. Les signatures d'objets qui ne sont pas numériques ne sont pas vérifiées. Les objets dont la signature n'est pas correcte sont identifiés dans un message consigné dans l'historique du travail et l'opération de sauvegarde est interrompue.

*ALL

Tous les objets pouvant comporter une signature numérique sont vérifiés. Les objets qui ne sont pas signés, mais qui peuvent l'être, sont identifiés dans un message consigné dans l'historique du travail. La sauvegarde est interrompue pour les objets non signés. Les objets signés dont la signature numérique est incorrecte sont identifiés dans un message consigné dans l'historique du travail et la sauvegarde est interrompue.

*NONE

La signature numérique des objets n'est pas vérifiée.

Identificateur de volume (VOL)

Indique les identificateurs des volumes de bandes sur lesquels le logiciel sous licence est sauvegardé. Ces volumes devront être placés dans le même ordre que les identificateurs associés au présent paramètre. Vous pouvez indiquer jusqu'à 75 entrées.

*MOUNTED

Le volume présent sur l'unité est utilisé.

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.

Identificateur-de-volume

Indiquez l'identificateur d'un ou de plusieurs volumes en respectant l'ordre de montage utilisé lors de la sauvegarde du logiciel sous licence.

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 de la bande créée par la sauvegarde. Si vous précisez une date de péremption, le fichier est protégé et ne peut pas être écrasé avant cette date.

*PERM

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

date

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

Option de fin de support (ENDOPT)

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

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

*REWIND

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

*LEAVE

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

*UNLOAD

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

Fichier sauvegarde (SAVF)

Indique le fichier sauvegarde dans lequel le produit est sauvegardé. Ce fichier doit être vide, excepté si *ALL a été indiqué pour le paramètre Mise à blanc (CLEAR).

Qualificatif 1 : Fichier sauvegarde

nom

Indiquez le nom du fichier sauvegarde.

Qualificatif 2 : Bibliothèque.

*LIBL

La recherche porte sur toutes les bibliothèques de la liste des bibliothèques du travail jusqu'à ce que la première occurrence soit trouvée.

*CURLIB

Le fichier sauvegarde est recherché dans la bibliothèque en cours du travail. Si aucune entrée de bibliothèque en cours ne figure dans la liste des bibliothèques, la bibliothèque QGPL est utilisée par défaut.

nom

Indiquez le nom de la bibliothèque qui contient le fichier sauvegarde.

Edition cible (TGTRLS)

Indique le niveau d'édition du système d'exploitation avec lequel vous voulez restaurer et utiliser le produit. Dans les exemples fournis pour les valeurs *CURRENT et *PRV, si vous indiquez la valeur édition-cible, le format utilisé est VxRxMx, où Vx désigne la version, Rx l'édition et Mx le niveau de modification. Par exemple, V4R1M0 signifie version 4, édition 1, niveau de modification 0.

Remarque :La limite de cette valeur est le numéro d'édition du système d'exploitation qui était en vigueur lorsque le produit a été créé.

*CURRENT

Le produit doit être restauré et utilisé sur un système doté de la même version du système d'exploitation que le vôtre ou de toute version suivante du système d'exploitation.

*PRV

Le produit doit être restauré dans l'édition précédente (niveau de modification 0) du système d'exploitation, ou dans toute édition suivante du sous-système d'exploitation.

édition-cible

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

Les valeurs admises dépendent de la version, de l'édition et du niveau de modification en cours. Elles changent avec chaque nouvelle édition. Appuyez sur F4 pour afficher la liste des valeurs admises en cours.

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 les données sont comprimées. 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.

*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

Les données ne sont pas comprimées.

*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 un support optique, celle-ci est exécutée par logiciel. La compression de logiciel basse est utilisée pour toutes les unités à l'exception des DVD optiques, qui utilisent la compression de logiciel intermédiaire.

*LOW

Si l'opération de sauvegarde est effectuée dans un fichier de sauvegarde ou sur un support optique, la compression des données du logiciel est effectuée 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 est effectuée dans un fichier de sauvegarde ou sur un support optique, la compression des données du logiciel est effectuée 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 est effectuée dans un fichier de sauvegarde ou sur un support optique, la compression des données du logiciel est effectuée 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.

Imposer acceptation du contrat (LICACPRQD)

Indique si l'utilisateur est invité à accepter un contrat de licence lorsque le logiciel sous licence est restauré. Si le logiciel sous licence sauvegardé ne possède pas de contrats de licence logiciels en ligne, aucune invite n'apparaîtra au moment de la restauration. Ce paramètre ne modifie pas l'état de l'acceptation du contrat de la licence du logiciel actuellement installé.

*NO

L'acceptation du contrat de licence n'est pas requise lorsque le logiciel sous licence sauvegardé est restauré.

*YES

L'acceptation du contrat de licence est requise lorsque le logiciel sous licence sauvegardé est restauré, si ce dernier possède des contrats de licence logiciels en ligne.

Exemples

Exemple 1 : Bandes mises à blanc automatiquement

SAVLICPGM   LICPGM(5770WDS)  DEV(TAP01)  CLEAR(*ALL)

Cette commande sauvegarde l'option *BASE du logiciel sous licence Rational Development Studio (5770WDS). La sauvegarde se fait sur la bande placée dans l'unité TAP01. Chaque bande non remise à zéro est effacée automatiquement lorsqu'elle se présente et l'opération de sauvegarde se poursuit sans intervention de l'opérateur.

Exemple 2 : Sauvegarde sur volume de bande avec label

SAVLICPGM   LICPGM(5770WDS)  DEV(TAP01)  VOL(ABCDE)

L'option *BASE du logiciel sous licence Rational Development Studio (5770WDS) est sauvegardée sur l'unité de bande TAP01, en commençant par le volume de bande portant le label ABCDE. Si l'opération de sauvegarde dépasse la capacité de stockage d'une bande, un message s'affiche pour demander à l'opérateur de mettre un autre volume dans l'unité TAP01.

Exemple 3 : Sauvegarde sur plusieurs volumes

SAVLICPGM   LICPGM(5770SS1)  OPTION(2)  DEV(TAP01 TAP02)

L'option d'aide en ligne du logiciel sous licence IBM i (5770SS1) est sauvegardée alternativement sur les unités de bande TAP01 et TAP02. Si l'opération de sauvegarde dépasse la capacité de stockage de deux bandes, un message s'affiche pour demander à l'opérateur de mettre un autre volume dans l'unité TAP01. A l'issue de l'opération de sauvegarde, les bandes sont rembobinées.

Exemple 4 : Sauvegarde dans des fichiers sauvegarde remis à zéro automatiquement

SAVLICPGM   LICPGM(5770WDS)  DEV(*SAVF)
            CLEAR(*ALL)  SAVF(MYLIB/MYSAVF)

Cette commande sauvegarde l'option de base du logiciel sous licence Rational Development Studio (5770WDS). Elle est sauvegardée dans le fichier sauvegarde MYSAVF de la bibliothèque MYLIB. Le fichier sauvegarde MYSAVF est automatiquement remis à zéro et l'opération de sauvegarde se poursuit sans intervention de l'opérateur.

Exemple 5 : Sauvegarde des objets programme dans un fichier sauvegarde

SAVLICPGM   LICPGM(1MYPROD)  OPTION(*BASE)
            DEV(*SAVF)  RLS(*ONLY)
            OBJTYPE(*PGM)  SAVF(MYLIB/MYSAVF)

Le produit 1MYPROD est constitué de deux bibliothèques et ne comporte aucun dossier. Seuls les objets programme du produit 1MYPROD sont sauvegardés dans le fichier sauvegarde MYSAVF de la bibliothèque MYLIB.

Exemple 6 : Sauvegarde de tous les objets d'une bibliothèque dans un fichier sauvegarde

SAVLICPGM   LICPGM(1MYPROD)  OPTION(*BASE)
            DEV(*SAVF)  RLS(*ONLY)
            LNG(2924)  OBJTYPE(*ALL)  SAVF(MYLIB/MYSAVF)

Le produit 1MYPROD est constitué d'une bibliothèque et ne comporte aucun dossier. Les objets programme et les objets langue NLV 2924 du produit 1MYPROD sont sauvegardés dans le fichier sauvegarde MYSAVF de la bibliothèque MYLIB.

Exemple 7 : Sauvegarde de tous les objets de deux bibliothèques dans un fichier sauvegarde

SAVLICPGM   LICPGM(1MYPROD)  OPTION(*BASE)
            DEV(*SAVF)  RLS(*ONLY)
            LNG(2924)  OBJTYPE(*ALL)  SAVF(MYLIB/MYSAVF)

Le produit 1MYPROD est constitué de deux bibliothèques et comporte un dossier racine contenant les objets *PGM et un sous-dossier de ce dossier pour les objets *LNG. Les objets programme et les objets langue NLV 2924 du produit 1MYPROD sont sauvegardés dans le fichier sauvegarde MYSAVF de la bibliothèque MYLIB.

Exemple 8 : Sauvegarde d'une édition précédente

SAVLICPGM   LICPGM(1MYPROD)  DEV(TAP01)  TGTRLS(*PRV)

Le produit 1MYPROD est enregistré sur l'unité TAP01 et peut être restauré sur un système sur lequel l'édition précédente du système d'exploitation est installée.

Messages d'erreur

*ESCAPE Messages

CPF3D93

Objets du produit &1 option &2 édition &5 non sauvegardés.