LODRUN

La commande LODRUN restaure un objet programme écrit par l'utilisateur depuis une unité de bande, une unité optique ou un fichier sauvegarde vers la bibliothèque QTEMP. Le système transfère alors le contrôle au programme restauré.

Lorsque la commande LODRUN est exécutée :

1. Le programme écrit par l'utilisateur, qui doit avoir pour nom QINSTAPP, est recherché sur le support. Si le support utilisé est une bande ou un support optique, QINSTAPP doit avoir été sauvegardé à partir de la bibliothèque. Si le support utilisé est un fichier sauvegarde, QINSTAPP doit être sauvegardé à partir de la même bibliothèque que le reste des objets contenus dans ce fichier de sauvegarde.

   Remarque :Le programme QINSTAPP doit appartenir à un profil utilisateur résidant sur le système cible. Si QINSTAPP est restauré sur un système où ne figure pas le profil utilisateur du propriétaire, aucun transfert de contrôle n'est effectué et le programme n'est pas exécuté.

2. Si un programme QINSTAPP existe déjà dans la bibliothèque QTEMP sur le système de l'utilisateur, il est supprimé.
3. Le programme QINSTAPP est restauré dans la bibliothèque QTEMP à l'aide de la commande RSTOBJ.
4. L'unité utilisée pour l'opération de restauration est déterminée par la commande LODRUN. Si *TAP *OPT est indiqué pour le paramètre Unité (DEV), la commande LODRUN lit la valeur système QDEVNAMING afin de déterminer si le système utilise les conventions de dénomination IBM i ou IBM 36 pour les unités :
   • Si QDEVNAMING prend la valeur *NORMAL (convention IBM i)
     • l'unité TAP01 est utilisée pour le paramètre DEV(*TAP) ;
     • l'unité OPT01 est utilisée pour le paramètre DEV(*OPT).
   • Si QDEVNAMING prend la valeur *S36 (convention IBM 36)
     • l'unité TC est utilisée pour le paramètre DEV(*TAP) si une cartouche est détectée. Dans le cas contraire, c'est l'unité T1 qui est utilisée ;
     • l'unité OPT01 est utilisée pour le paramètre DEV(*OPT). Les conventions de dénomination IBM 36 ne s'appliquent pas aux unités optiques.

   Si *SAVF est indiqué pour le paramètre DEV, le fichier sauvegarde indiqué pour le paramètre Fichier sauvegarde (SAVF) est utilisé.

   Toute autre valeur associée au paramètre DEV est prise en compte telle quelle.

5. Le contrôle du système est transmis au programme QINSTAPP. Ce dernier peut être utilisé, par exemple, pour restaurer d'autres applications sur le système de l'utilisateur et les exécuter.
6. Lorsque l'utilisateur ferme sa session, le programme QINSTAPP est enlevé du système.
7. Les paramètres des trois valeurs système fonctionnent ensemble pour déterminer si le programme QINSTAPP peut être restauré ou s'il est converti pendant la restauration. Les trois valeurs système sont les suivantes :
   • QVFYOBJRST Vérifier la restauration de l'objet
   • QFRCCVNRST Forcer la conversion lors de la restauration
   • QALWOBJRST Autoriser l'option de restauration de l'objet

   La commande LODRUN ne transfère pas le contrôle au programme QINSTAPP si ces valeurs ne permettent pas la restauration et la conversion du programme QINSTAPP.

L'utilisateur qui fournit le programme QINSTAPP est responsable de son écriture et de sa prise en charge. Ce programme n'est pas fourni par IBM. Il peut être conçu pour exécuter de nombreuses tâches différentes, par exemple :

• restaurer et exécuter d'autres programmes ou applications ;
• restaurer une bibliothèque ;
• supprimer un programme ou une application ;
• créer des environnements spécifiques ;
• appliquer des corrections à des applications existantes.

Le programme QINSTAPP n'est exécuté qu'une seule fois, à chaque lancement de la commande LODRUN.

La commande LODRUN transfère le ou les paramètres au programme QINSTAPP.

• La commande LODRUN transfère toujours un nom d'unité de 10 caractères. Pour un nom d'unité de bande ou d'unité optique, cette commande spécifie l'unité à partir de laquelle le programme QINSTAPP est effectivement restauré. Si *SAVF a été indiqué pour le paramètre DEV, ce paramètre inclut *SAVF et le nom qualifié du fichier sauvegarde est transféré dans un second paramètre.
• Si *SAVF a été indiqué pour le paramètre DEV, la commande LODRUN transfère un nom de 20 caractères pour le fichier sauvegarde et sa bibliothèque. Les 10 premiers caractères correspondent au nom du fichier sauvegarde et les 10 caractères suivants correspondent au nom de la bibliothèque de ce fichier.

Le programme QINSTAPP ne doit pas tenter de réutiliser la commande LODRUN, les résultats étant alors imprévisibles.

L'utilisateur qui met le programme QINSTAPP à disposition est responsable de son écriture, mais il est également tenu de fournir le support contenant ce programme.

Pour distribuer le programme sur une bande ou une unité optique, procédez comme suit :

1. Préparez le support.
   • Pour une bande, exécutez la commande INZTAP (Initialiser une bande).
   • Pour un support optique, exécutez la commande INZOPT (Initialiser un volume optique.
2. Assurez-vous que la commande existe bien dans QTEMP (pour une bande ou un support optique) ou que cette commande existe dans la bibliothèque à sauvegarder dans un fichier sauvegarde.
3. Sauvegardez les objets sur le support.
   • Pour une bande

     A l'aide de la commande SAVOBJ (Sauvegarder un objet), sauvegardez le programme QINSTAPP depuis QTEMP vers l'unité de bande de votre choix. Le fichier support contenant le programme ne doit inclure aucun autre objet. Indiquez les paramètres suivants :

     • LIB(QTEMP)
     • LABEL(*LIB)
     • CLEAR(*ALL)

     Le fait de spécifier LABEL(*LIB) garantit que le label QTEMP sera utilisé. Si d'autres applications, programmes ou bibliothèques doivent être sauvegardés sur la bande, ENDOPT(*LEAVE) doit également être indiqué.

     Sauvegardez sur la bande tout autre élément requis par QINSTAPP.

     Après restauration du programme QINSTAPP, la bande n'est pas rembobinée ; l'application ou la série d'applications restaurée par le programme QINSTAPP sur le système de l'utilisateur doit être placée à la suite de ce programme sur la bande.

   • Pour un support optique

     A l'aide de la commande SAVOBJ (Sauvegarder un objet), sauvegardez le programme QINSTAPP depuis QTEMP vers l'unité optique de votre choix. Si vous souhaitez sauvegarder le programme QINSTAPP ailleurs que dans le répertoire principal, vous devez définir le paramètre OPTFILE comme suit :

     • OPTFILE('/sous-rép1/sous-répN/QTEMP')

     Sauvegardez sur l'unité optique tout autre élément requis par QINSTAPP.

   • Pour un fichier sauvegarde.

     Assurez-vous que tous les objets nécessaires se trouvent bien dans la bibliothèque que vous prévoyez de sauvegarder dans le fichier sauvegarde. Exécutez ensuite la commande SAVLIB ou SAVOBJ pour sauvegarder les objets de la bibliothèque dans ce fichier.

   Pour tous les types de support, la valeur appropriée du paramètre TGTRLS doit également être indiquée si l'édition cible n'est pas *CURRENT (valeur par défaut).

   Les autres éléments sauvegardés sur support ne peuvent pas être des bibliothèques, objets de bibliothèque, répertoires IFS, etc. que le programme QINSTAPP doit restaurer dans le cadre de son processus d'installation.

Restriction : Des droits spécifiques peuvent être nécessaires pour une exécution correcte du programme QINSTAPP chargé depuis le support et appelé. L'utilisateur qui fournit ce programme doit donc vous informer sur ce point.

Paramètres

Unité (DEV)

Indique l'unité d'E-S à partir de laquelle le programme est chargé.

Ce paramètre est obligatoire.

*TAP

Le programme est chargé à partir de l'unité de bande par défaut connectée au système.

*OPT

Le programme est chargé à partir de l'unité optique par défaut connectée au système.

*SAVF

Le programme est chargé à partir du fichier sauvegarde indiqué pour le paramètre Fichier sauvegarde (SAVF).

unité-bande

Indiquez le nom de l'unité de bande à partir de laquelle le programme est chargé sur le système.

unité-optique

Indiquez le nom de l'unité optique à partir de laquelle le programme est chargé sur le système.

Numéro de séquence (SEQNBR)

Indique, dans le cas d'une bande uniquement, le numéro de séquence utilisé pour l'opération de restauration.

*FIRST

Le fichier de données dont l'identificateur correspond au label QTEMP est recherché à partir du début du volume placé dans l'unité de bande. L'objet est restauré lorsque le premier fichier correspondant est trouvé.

*SEARCH

Le fichier de données dont l'identificateur correspond au label QTEMP est recherché à partir de la position en cours de la bande. L'objet est restauré lorsque le fichier correspondant est trouvé.

numéro-séquence

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

Identificateur de volume (VOL)

Indique, uniquement lorsqu'une bande est utilisée, l'ID volume des unités de bande.

*MOUNTED

Le volume actuellement monté sur l'unité de bande est utilisé.

Identificateur-de-volume

Indiquez l'ID volume monté sur l'unité de bande.

Répertoire (DIR)

Spécifie, uniquement lorsqu'une unité optique est utilisée, le répertoire utilisé pour l'opération de restauration. Si le fichier QTEMP est trouvé dans le répertoire indiqué, l'objet est restauré.

'/'

Le répertoire principal (/) est utilisé.

nom-répertoire

Indiquez le répertoire dans lequel le fichier QTEMP doit être recherché.

Fichier sauvegarde (SAVF)

Indique le fichier sauvegarde contenant le programme QINSTAPP.

Remarque :Vous devez indiquer une valeur pour ce paramètre si la valeur *SAVF est spécifiée au paramètre (Unité (DEV)).

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.

Exemples

Exemple 1 : Restauration du programme QINSTAPP depuis une bande

LODRUN   DEV(TAP01)

Cette commande restaure l'objet programme QINSTAPP depuis la bande placée dans l'unité TAP01 vers la bibliothèque QTEMP. Le contrôle est alors transféré au programme restauré.

Exemple 2 : Restauration du programme QINSTAPP depuis une bande avec spécification d'un numéro de séquence

LODRUN   DEV(TAP01)  SEQNBR(5)

Cette commande restaure l'objet programme QINSTAPP depuis la bande au numéro de séquence 5 de l'unité TAP01 vers la bibliothèque QTEMP. Le contrôle est alors transféré au programme restauré. Si le numéro de séquence n'est pas trouvé, un message d'arrêt programme est envoyé. Si le label du fichier à ce numéro de séquence n'est pas QTEMP, un message d'arrêt programme est envoyé.

Exemple 3 : Restauration du programme QINSTAPP depuis un support optique

LODRUN   DEV(*OPT)  DIR('/APP1/INST')

Cette commande restaure l'objet programme QINSTAPP depuis le support placé dans l'unité OPT01 vers la bibliothèque QTEMP. Le nom de fichier de la bibliothèque QTEMP sur le support optique est /APP1/INST/QTEMP. Le contrôle est alors transféré au programme restauré. Si le fichier n'est pas trouvé, un message d'arrêt programme est envoyé.

Exemple 4 : Restauration du programme QINSTAPP depuis un support optique virtuel

LODRUN   DEV(OPTVRT01)

Cette commande restaure l'objet programme QINSTAPP depuis l'unité optique virtuelle OPTVRT01 vers la bibliothèque QTEMP. Le nom de fichier de la bibliothèque QTEMP sur le support optique est /QTEMP. Le contrôle est alors transféré au programme restauré. Si le fichier n'est pas trouvé, un message d'arrêt programme est envoyé.

Exemple 5 : Restauration du programme QINSTAPP depuis un fichier sauvegarde

LODRUN   DEV(*SAVF)  SAVF(MYAPPLIB/MYSAVF)

Cette commande restaure l'objet programme QINSTAPP depuis le fichier sauvegarde MYSAVF de la bibliothèque MYAPPLIB vers la bibliothèque QTEMP. Le contrôle est alors transféré au programme restauré. Si le programme QINSTAPP n'est pas trouvé, un message d'arrêt programme est envoyé.

Messages d'erreur

Aucun