RSTLICPGM

La commande RSTLICPGM permet de charger un logiciel sous licence, d'en installer une nouvelle version ou bien de le restaurer pour une reprise.

Restrictions :

1. Cette commande est livrée avec les droits publics *EXCLUDE.
2. Pour utiliser cette commande, l'utilisateur doit disposer des droits *SECADM et *ALLOBJ.
3. Si vous utilisez cette commande pour restaurer un programme du logiciel sous licence, vous ne devez pas exécuter une copie du programme en cours sur le système lors de la restauration du programme. Si c'est le cas, il se produit une fin anormale du programme de traitement.
4. Si d'autres objets du logiciel sous licence sont en cours d'utilisation, ils ne sont pas restaurés.
5. Cette commande ignore toutes les substitutions de fichiers du travail en cours, à l'exception des substitutions indiquées pour le paramètre d'impression de l'opération de restauration (OUTPUT(*PRINT)).
6. Certains logiciels sous licence ne peuvent être restaurés que si l'utilisateur est inscrit dans le répertoire de distribution du système. Pour plus de détails sur cette restriction, reportez-vous à la documentation relative à chacun des logiciels sous licence.
7. Cette commande ne permet pas de restaurer les objets code ou langue du système d'exploitation de base.
8. Cette commande ne prend pas en charge les ASP (pools de mémoire secondaire) utilisateur. Tous les objets fournis par un logiciel sous licence doivent demeurer dans l'ASP système.
9. 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 à restaurer.

Ce paramètre est obligatoire.

Unité (DEV)

Indique le nom de l'unité utilisée pour la restauration du logiciel sous licence. Ce nom 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 nom du fichier sauvegarde indiqué au paramètre SAVF est utilisé pour l'opération de restauration.

nom-unité-optique

Indiquez le nom de l'unité optique utilisé pour l'opération de restauration.

nom-unité-bandothèque

Indiquez le nom de l'unité de bandothèque utilisée pour l'opération de restauration.

nom-unité-bande

Indiquez le nom d'une ou plusieurs unités de bande à utiliser pour restaurer le logiciel sous licence. 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 du logiciel à restaurer (OPTION)

Indique quelles options du logiciel sous licence entré en regard de l'invite Produit (paramètre LICPGM) seront restaurées.

*BASE

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

numéro-option-logiciel-sous-licence

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

Type d'objet à restaurer (RSTOBJ)

Indique le type d'objet du logiciel sous licence à restaurer.

*ALL

Tous les objets du logiciel sous licence sont restaurés. Il s'agit des objets programme et des objets langue désignés à l'invite Langue du logiciel ss/licence (paramètre LNG).

Si une unité de bande est indiquée au paramètre DEV, la valeur RSTOBJ(*ALL) est utilisée lorsque la sauvegarde d'un logiciel sous licence a été effectuée à l'aide de la commande SAVLICPGM, de sorte que les objets langue suivent immédiatement les objets programme sur la bande. Si les objets langue (*LNG) et les objets programme (*PGM) ne figurent pas en ordre consécutif sur la bande de distribution, *ALL ne peut, en général, pas être utilisé. Les objets programme et langue doivent alors être restaurés séparément. Pour déterminer l'ordre des objets sur la bande, utilisez la commande DSPTAP. Vous trouverez un exemple de restauration séparée d'objets langue et programme dans la section "Exemples" qui figure à la fin de cette commande.

Si *SAVF est indiqué au paramètre DEV, la valeur RSTOBJ(*ALL) peut être utilisée lorsque la sauvegarde du logiciel sous licence a été effectuée à l'aide de la commande SAVLICPGM avec le paramètre OBJTYPE(*ALL).

*PGM

Seuls les objets programme du logiciel sous licence sont restaurés. Il est conseillé d'utiliser *PGM pour la restauration des objets programme lorsque ces derniers ne se trouvent pas sur le même support de distribution ou ne se suivent pas.

*LNG

Seuls les objets langue du logiciel sous licence sont restaurés. L'invite Langue du logiciel ss/licence (paramètre LNG) permet d'indiquer si les objets sont associés à la bibliothèque du logiciel sous licence ou à une bibliothèque multilingue.

Langue du logiciel ss/licence (LNG)

Indique la version en langue nationale (NLV) à utiliser pour la restauration du logiciel sous licence. Si le dispositif de langue du logiciel sous licence sur le support de sauvegarde correspond au dispositif de langue du système, les objets langue sont restaurés dans la bibliothèque du logiciel sous licence. Dans le cas contraire, ils sont restaurés dans la bibliothèque de langue multilingue utilisée pour ce dispositif de langue.

*PRIMARY

Le dispositif de langue du système d'exploitation est restauré pour le logiciel sous licence indiqué.

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

*SAVVOL

Le fichier de langue du volume chargé doit être restauré pour le logiciel sous licence. Cette option n'est pas admise lorsque DEV(*SAVF) est indiqué.

codes-dispositif

Entrez l'identificateur NLV (version en langue nationale) du fichier de langue à restaurer pour le logiciel sous licence. Pour de plus amples informations sur les identifications de dispositifs et pour consulter la liste des codes dispositifs fournis par IBM, reportez-vous au manuel Installation, mise à niveau ou suppression de l'IBM i et des logiciels associés, SC41-5120.

Sortie (OUTPUT)

Indique si une liste présentant des informations concernant l'état des objets est créée. Cette liste permet de consulter les valeurs de paramètre précisées ainsi que tous les objets (restaurés et non restaurés). Les informations relatives à la sécurité de chaque objet restauré sont listées.

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

Edition (RLS)

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

*FIRST

La première version, édition et niveau de modification du produit qui est trouvée sur le support de distribution est restaurée.

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.

Remplacer édition (REPLACERLS)

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

*ONLY

Seule la version, l'édition et le niveau de modification du logiciel sous licence qui est installé sont remplacés.

*NO

Le logiciel sous licence installé sur le système n'est pas remplacé. L'édition du logiciel sous licence restauré doit être différente de celle du logiciel sous licence installé. Si le logiciel sous licence en cours de restauration existe dans les mêmes bibliothèques que le logiciel installé, vous devez définir un paramètre de substitution afin d'indiquer dans quelles bibliothèques doit s'effectuer la restauration.

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.

Identificateur de volume (VOL)

Indique les identificateurs utilisés pour la restauration des objets : ID volume du support ou ID cartouche des bandes d'une unité de bandothèque. Vous devez placer les volumes en respectant l'ordre dans lequel ils se trouvaient lors de la sauvegarde des données. Vous devez placer dans l'unité le volume qui contient le début du fichier à restaurer.

*MOUNTED

Le logiciel sous licence est restauré à partir des volumes installés sur l'unité indiquée à l'invite Unité (paramètre DEV). 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, pour la restauration du logiciel sous licence, l'ordre de montage utilisé. Vous pouvez indiquer jusqu'à 75 identificateurs de volumes.

Numéro de séquence (SEQNBR)

Indique le numéro de séquence à utiliser pour la restauration. Cette option est valable uniquement pour les unités de bande.

*SEARCH

Le fichier de données qui comporte un identificateur correspondant au label du logiciel sous licence (ou de l'option de logiciel) est recherché dans le volume placé sur l'unité. Les objets sont restaurés lorsque ce fichier est trouvé. Si *LEAVE a été entré en regard de l'invite Option de fin de support (paramètre ENDOPT), ce qui indique que la bande est positionnée à l'emplacement où la dernière opération s'est terminée, la recherche s'effectue à partir du premier fichier situé après cette position. En revanche, si *LEAVE n'a pas été indiqué en regard de l'invite Option de fin de support, ou si la bande a été manuellement rembobinée après l'opération, la recherche commence au début du volume.

numéro-séquence-fichier

Indiquez le numéro de séquence du fichier à utiliser pour la restauration. Les valeurs admises sont comprises entre 1 et 16777215.

Option de fin de support (ENDOPT)

Indique l'opération automatiquement exécutée sur le volume de bande ou optique une fois la restauration terminée. 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 contenant le produit.

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.

Biblio (LIB)

Indique les bibliothèques dans lesquelles le logiciel sous licence est restauré. Cette fonction n'est pas prise en charge par tous les logiciels sous licence.

*SAME

Le logiciel sous licence est restauré dans la bibliothèque indiquée.

nom-bibliothèque

Indiquez le nom de la bibliothèque dans laquelle le logiciel sous licence est restauré. Vous pouvez indiquer jusqu'à 11 noms de bibliothèques.

Bibliothèque de langue (LNGLIB)

Indique la bibliothèque de langue secondaire dans laquelle les objets de langue secondaire sont restaurés. Cette fonction n'est pas prise en charge par tous les logiciels sous licence.

*SAME

Le logiciel sous licence est restauré dans la bibliothèque de langue secondaire indiquée.

nom-bibliothèque

Indiquez le nom de la bibliothèque de langue secondaire dans laquelle le logiciel sous licence est restauré.

Dossier (FLR)

Indique le nom du dossier principal dans lequel le logiciel sous licence est restauré. Cette fonction n'est pas prise en charge par tous les logiciels sous licence.

*SAME

Utilisez le dossier principal indiqué.

nom-dossier

Indiquez le nom du dossier principal. Il s'agit du dossier système contenant tous les autres dossiers.

Répertoire initial du code (CODHOMEDIR)

Indique les répertoires dans lesquels la partie code du produit est restaurée. Cette fonction n'est pas prise en charge par tous les produits.

Remarque :Ce paramètre est incompatible avec le paramètre FLR.

*SAME

La partie code du produit est restaurée dans les répertoires prédéfinis à la livraison ou dans ceux dans lesquels il a déjà été installé. *SAME peut être indiqué en tant que paramètre unique ou au sein d'une liste de répertoires. S'il est utilisé dans une liste, *SAME indique qu'un répertoire particulier est inchangé, bien qu'il soit possible que d'autres répertoires aient changé par rapport au moment où le produit a été livré ou précédemment installé.

*PROMPT

Les répertoires de code à utiliser sont affichés. Si le produit n'est pas installé, les noms de répertoires peuvent être modifiés.

nom-chemin

Indiquez le nom de répertoire du chemin d'origine dans lequel la partie code du produit est restaurée. Vous pouvez indiquer jusqu'à 300 répertoires. Dans le cas des noms de répertoires inchangés, *SAME peut être indiqué pour le nom de chemin.

Répertoire initial langue (LNGHOMEDIR)

Indique les répertoires dans lesquels la partie langue du produit est restaurée. Cette fonction n'est pas prise en charge par tous les produits.

Remarque :Ce paramètre est incompatible avec le paramètre FLR.

*SAME

La partie langue du produit est restaurée dans les répertoires prédéfinis à la livraison ou dans ceux dans lesquels il a déjà été installé. *SAME peut être indiqué en tant que paramètre unique ou au sein d'une liste de répertoires. S'il est utilisé dans une liste, *SAME indique qu'un répertoire particulier est inchangé, bien qu'il soit possible que d'autres répertoires aient changé par rapport au moment où le produit a été livré ou précédemment installé.

*PROMPT

Les répertoires de langue à utiliser s'affichent. Si le produit n'est pas installé, les noms de répertoires peuvent être modifiés.

nom-chemin

Indiquez le nom de répertoire du chemin d'origine dans lequel la partie langue du produit est restaurée. Vous pouvez indiquer jusqu'à 300 répertoires. Dans le cas des noms de répertoires inchangés, *SAME peut être indiqué pour le nom de chemin.

Forcer conversion d'objet (FRCOBJCVN)

Indique si la conversion des objets utilisateur au format requis pour la version en cours du système d'exploitation doit être effectuée, ou s'ils sont compatibles avec l'ordinateur actuel, lors de la restauration de ces derniers.

Remarques :

1. Ce paramètre ne s'applique qu'aux objets utilisateur de type *MODULE, *PGM, *SRVPGM et *SQLPKG.
2. Un objet doit disposer de données de création (observables ou non) pour être converti.
3. Si la conversion d'un objet est requise (car il est formaté pour une version antérieure du système d'exploitation ou est incompatible avec l'ordinateur actuel) mais non effectuée lors de cette opération de restauration, l'objet est automatiquement converti lorsqu'il est utilisé pour la première fois.

Valeurs uniques

*SYSVAL

Les objets sont convertis en fonction de la valeur système QFRCCVNRST.

*NO

Les objets ne sont pas convertis pendant l'opération de restauration.

Remarque :Si FRCOBJCVN(*NO) est indiqué, la valeur système QFRCCVNRST doit avoir la valeur "0" ou "1".

Elément 1 : Conversion à la restauration

*YES

Les objets sont convertis pendant l'opération de restauration.

Remarques :

1. Si FRCOBJCVN(*YES *RQD) est indiqué, la valeur système QFRCCVNRST doit être "0", "1" ou "2". FRCOBJCVN(*YES *RQD) va remplacer une valeur QFRCCVNRST de "0" ou "1". Si FRCOBJCVN(*YES *ALL) est indiqué, QFRCCVNRST peut avoir une valeur correcte et FRCOBJCVN(*YES *ALL) remplace la valeur système QFRCCVNRST.
2. Le fait de spécifier cette valeur a pour conséquence d'augmenter la durée de l'opération de restauration, toutefois, il n'est plus nécessaire de convertir les objets lorsqu'ils sont utilisés pour la première fois.

Elément 2 : Objets à convertir

*RQD

Les objets ne sont convertis que si le système d'exploitation requiert cette opération pour pouvoir utiliser ces derniers ou pour être compatibles avec l'ordinateur actuel. Si les objets ne disposent pas de toutes les données de création (observables ou non), ils ne peuvent pas être convertis et ne vont pas être restaurés.

*ALL

Tous les objets sont convertis quel que soit leur format actuel et la compatibilité avec l'ordinateur, y compris ceux qui sont déjà au format en cours. Toutefois, si les objets ne disposent pas de toutes les données de création (observables ou non), ils ne peuvent pas être convertis et ne vont pas être restaurés.

Exemples

Exemple 1 : Restauration du logiciel avec les valeurs par défaut

RSTLICPGM   LICPGM(5770WDS)  DEV(TAP01)

Cette commande restaure le logiciel sous licence Rational Development Studio (5770WDS) sur le système. La bande sur laquelle se trouvent les objets du logiciel sous licence doit être placée dans l'unité de bande TAP01. Etant donné qu'aucun autre paramètre n'est spécifié, les valeurs par défaut de la commande sont utilisées.

Exemple 2 : Restauration d'une troisième version d'un produit

RSTLICPGM   LICPGM(1MYPROD)  OPTION(*BASE)
            DEV(TAP01)  RLS(V5R2M0)
            REPLACERLS(*NO)  LIB(A B C)

Cette commande restaure sur le système l'élément de base du produit V5R2M0 1MYPROD s'il n'est pas déjà installé sur le système.

Exemple 3 : Restauration d'une version d'un produit sur une autre version

RSTLICPGM   LICPGM(2MYPROD)  OPTION(*BASE)
            DEV(TAP01)  RLS(*FIRST)
            REPLACERLS(*ONLY)

Cette commande restaure le premier niveau de version/édition/modification de la partie de base du produit 2MYPROD rencontré sur la bande placée dans l'unité TAP01. Il est sans importance que le niveau de version/édition/modification de l'élément de base du produit se trouvant sur la bande corresponde au niveau de version/édition/modification du produit installé sur le système.

Exemple 4 : Restauration du produit à partir du fichier sauvegarde

RSTLICPGM   LICPGM(5770WDS)  DEV(*SAVF)  SAVF(MYLIB/MYSAVF)

Cette commande restaure le logiciel sous licence Rational Development Studio (5770WDS) sur le système à partir du fichier sauvegarde MYSAVF de la bibliothèque MYLIB. Etant donné qu'aucun autre paramètre n'est spécifié, les valeurs par défaut de la commande sont utilisées.

Exemple 5 : Restauration d'une troisième version d'un produit à partir d'un fichier sauvegarde

RSTLICPGM   LICPGM(1MYPROD)  OPTION(*BASE)
            DEV(*SAVF)  RLS(V5R2M0)
            REPLACERLS(*NO)  LIB(A B C)  SAVF(MYLIB/MYSAVF)

Cette commande restaure sur le système la partie de base du produit V5R2M0 1MYPROD à partir du fichier sauvegarde MYSAVF de la bibliothèque MYLIB s'il n'est pas déjà installé sur le système.

Messages d'erreur

*ESCAPE Messages

CPF3D96

Objets du produit &1 option &2 édition &6 non restaurés.