UPDSRVPGM

La commande UPDSRVPGM (Mettre à jour un programme de service) peut être utilisée pour remplacer les modules d'un programme de service lié ILE (Integrated Language Environment) par d'autres modules du système, sans modifier ou recompiler le programme de service lié. Les modules remplacés doivent être des objets modules (*MODULE) du système.

D'autres travaux qui utilisent le programme de service lié peuvent s'exécuter pendant la mise à jour du programme à l'aide de cette commande. Le programme de service en cours d'exécution est transféré dans la bibliothèque QRPLOBJ et une version mise à jour du programme de service est placée dans la bibliothèque du programme de service. Les activations en cours du programme de service continuent à s'exécuter avec la version du programme de service dans la bibliothèque QRPLOBJ

Restrictions :

• Vous devez disposer des droits d'utilisation (*USE) et d'ajout (*ADD) sur la bibliothèque du programme de service.
• Vous devez disposer des droits d'utilisation (*USE), de gestion des objets (*OBJMGT) et d'existence sur l'objet (*OBJEXIST) sur le programme de service.
• Vous devez être propriétaire du programme de service ou membre du groupe propriétaire, ou posséder le droit spécial sur tous les objets (*ALLOBJ).
• Vous devez disposer du droit d'utilisation (*USE) sur les objets suivants :
  • Objets *MODULE indiqués à l'invite Module (paramètre MODULE) et leur bibliothèque, droit *EXECUTE sur la bibliothèque dans laquelle le module réside.
  • Objets *SRVPGM indiqués à l'invite Lier programme de service (paramètre BNDSRVPGM).
  • Objets *BNDDIR indiqués à l'invite Répertoire de liage (paramètre BNDDIR) et leur bibliothèque, droit *EXECUTE sur la bibliothèque ainsi que tous les objets utilisés pour résoudre les symboles externes des objets *BNDDIR et leur bibliothèque.
• Vous devez disposer des droits d'opération sur l'objet (*OBJOPR) et de lecture (*READ) sur le fichier indiqué au paramètre Fichier source d'exportation (SRCFILE).
• Vous devez disposer du droit de lecture (*R) sur le fichier STREAM indiqué au paramètre Fichier source export STREAM (SRCSTMF).
• Vous devez disposer du droit d'exécution (*X) sur chacun des répertoires du chemin vers le fichier STREAM indiqué au paramètre Fichier source export STREAM (SRCSTMF).

Paramètres

Programme de service (SRVPGM)

Indique le programme de service à mettre à jour.

Ce paramètre est obligatoire.

Qualificatif 1 : Programme de service

nom

Indiquez le nom du programme de service lié à mettre à jour.

Qualificatif 2 : Biblio

*USRLIBL

La recherche porte uniquement sur les bibliothèques figurant dans la partie utilisateur de la liste des bibliothèques du travail.

*CURLIB

La recherche porte sur la bibliothèque en cours du travail. Si aucune bibliothèque n'est indiquée, QGPL est utilisée.

nom

Indiquez le nom de la bibliothèque dans laquelle se trouve le programme de service lié.

Module (MODULE)

Indique les objets *MODULE existants qui doivent remplacer les modules de même nom dans le programme lié. Jusqu'à 300 noms peuvent être définis. Si plusieurs modules du programme lié portent le même nom, l'invite Bibliothèque de remplacement (paramètre RPLLIB) indique lequel doit être remplacé.

Si le module remplacé et le<module de remplacement proviennent de deux bibliothèques différentes, une fois la mise à jour terminée, le module reste dans la bibliothèque où il se trouvait lors de la création du programme. Si le paramètre RPLLIB est requis pour déterminer quel module doit être remplacé, la valeur à indiquer pour celui-ci ne change pas après la mise à jour.

Ce paramètre est obligatoire.

Valeurs particulières

*NONE

Aucun module n'est indiqué.

Remarque :Cette valeur peut être indiquée lorsque le module n'est pas modifié et que la mise à jour du programme de service (paramètre BNDSRVPGM) ou du répertoire de liage (paramètre BNDDIR) vise à rechercher d'éventuelles exportations. Le module existant est utilisé.

Qualificatif 1 : Module

*ALL

Tous les modules portant le même nom sur lesquels l'utilisateur détient des droits remplacent les modules du programme de service lié.

nom-générique

Indiquez le nom générique des modules qui remplacent les modules du programme lié. Un nom générique est composé d'un ou plusieurs caractères suivis d'un astérisque (*) : ABC*, par exemple. Tous les modules dont le nom commence par le nom générique et sur lesquels l'utilisateur détient des droits remplacent les modules du programme de service lié.

nom

Indiquez le nom du module qui remplace un module du programme de service lié.

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

La recherche porte sur la bibliothèque en cours du travail. Si aucune bibliothèque n'est indiquée, QGPL est utilisée.

*USRLIBL

La recherche porte uniquement sur les bibliothèques figurant dans la partie utilisateur de la liste des bibliothèques du travail.

nom

Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche.

Exportation (EXPORT)

Indique les variables et les procédures qui doivent être exportées à partir du programme de service mis à jour. Ce paramètre indique également si de nouvelles signatures identifiant la séquence des exportations dans le programme de service sont créées.

*CURRENT

Les variables, les procédures et les signatures exportées à partir du programme de service continuent de l'être. Aucune nouvelle signature n'est créée.

Remarque :Si une variable ou une procédure qui est exportée n'est pas disponible pour l'exportation après la mise à jour, une erreur est signalée et le programme de service n'est pas mis à jour.

*SRCFILE

Le membre du fichier source indiqué aux paramètres Fichier source d'exportation (SRCFILE) et Membre source d'exportation (SRCMBR) ou au paramètre Fichier source export STREAM (SRCSTMF) contient les instructions EXPORT qui indiquent les données et les procédures à exporter à partir du programme de service. Si le fichier source indiqué est différent de celui utilisé pour créer le programme de service, il se peut qu'une nouvelle signature ou un nouvel ensemble de signatures soient créé.

Remarque :Si une signature est perdue, certains clients du programme de service devront peut-être lier de nouveau le programme de service avant de pouvoir l'utiliser.

*ALL

Toutes les variables et les procédures exportées à partir des modules du programme de service sont exportées à partir du programme de service mis à jour.

Si le nombre ou le nom des variables et des procédures exportées est modifié après la mise à jour du programme de service, une nouvelle signature est créée.

Remarque :Si une nouvelle signature est créée, tous les clients du programme de service doivent être liés de nouveau avant de pouvoir utiliser le programme.

Fichier source d'exportation (SRCFILE)

Indique le fichier source contenant les spécifications pour les exportations du programme de service. Ce paramètre ne peut pas être utilisé avec le paramètre Fichier source export STREAM (SRCSTMF).

Qualificatif 1 : Fichier source d'exportation

QSRVSRC

Le nom de fichier source est QSRVSRC.

nom

Indiquez le nom du fichier source contenant les spécifications pour les exportations du programme de service.

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

La recherche porte sur la bibliothèque en cours du travail. Si aucune bibliothèque n'est indiquée, QGPL est utilisée.

nom

Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche.

Membre source d'exportation (SRCMBR)

Indique le membre de fichier indiqué au paramètre Fichier source d'exportation (SRCFILE) qui contient les spécifications pour les exportations du programme de service. Ce paramètre ne peut pas être utilisé avec le paramètre Fichier source export STREAM (SRCSTMF).

*SRVPGM

Le membre du fichier source porte le même nom que le programme de service mis à jour.

nom

Indiquez le nom du membre qui contient les spécifications d'exportation.

Fichier source export STREAM (SRCSTMF)

Indique le nom du chemin du fichier STREAM contenant les spécifications pour l'exportation des données et des procédures à partir de ce programme de service lié. Ce paramètre peut être un nom de chemin absolu ou un nom de chemin relatif. Un nom de chemin absolu commence par un séparateur (qui est généralement le caractère /). Si le nom de chemin ne commence pas par un séparateur, il s'agit d'un nom de chemin relatif et le système suppose que le chemin commence par le répertoire de travail en cours. Le paramètre Fichier source export STREAM (SRCSTMF) ne peut pas être utilisé avec les paramètres Fichier source d'exportation (SRCFILE) ou Membre source d'exportation (SRCMBR). Il ne peut pas non plus être utilisé si l'objet en cours de mise à jour possède une édition cible antérieure à V7R3M0.

nom-chemin

Indiquez le nom du chemin du fichier STREAM qui contient les spécifications pour les exportations du programme de service.

Bibliothèque de remplacement (RPLLIB)

Indique la méthode utilisée pour sélectionner le module à remplacer lorsque plusieurs modules du programme lié portent le nom indiqué dans le paramètre MODULE.

*ONLY

Le programme de service lié contient un seul module portant le nom indiqué et le remplacement est effectué. Si plusieurs modules du programme de service lié portent le nom indiqué, une erreur est signalée et le programme de service lié n'est pas mis à jour.

*FIRST

Le premier module portant le nom indiqué dans la liste des modules du programme de service lié est remplacé.

*MODULE

Le module appartenant à la même bibliothèque que le module indiqué est remplacé. Si aucun module portant le nom indiqué ne provient de la même bibliothèque que le module de remplacement, aucun module n'est remplacé et une erreur est signalée.

nom

Indiquez le nom de la bibliothèque d'origine du module à remplacer. Si aucun module portant le nom indiqué ne provient de la bibliothèque précisée, aucun module n'est remplacé.

Lier programme de service (BNDSRVPGM)

Indique le programme de service dans lequel des exportations doivent être recherchées lorsque des demandes d'importation pour la résolution des symboles externes ne peuvent pas être satisfaites par les modules et les programmes de service du programme de service lié mis à jour. Si le programme de service indiqué peut résoudre les symboles externes, il est ajouté aux programmes de service qui sont liés au programme de service lié. Jusqu'à 300 noms peuvent être définis. Vous pouvez contrôler l'activation de chaque programme de service. Vous pouvez indiquer si le programme de service référencé est activé au même moment que le programme ou le programme de service en cours de création ou s'il est différé jusqu'à l'appel d'une procédure exportée du programme de service référencé. La mise en différé de l'activation peut améliorer les performances de votre application.

Valeurs particulières

*NONE

Aucun programme de service, à l'exception de ceux du programme de service lié mis à jour, n'est examiné pendant la résolution des symboles.

Elément 1 : Programme de service

Qualificatif 1 : Programme de service

*ALL

Tous les programmes de service sont examinés pendant la résolution des symboles.

nom-générique

Indiquez le nom générique des programmes de service à examiner pendant la résolution des symboles. Un nom générique est composé d'un ou plusieurs caractères suivis d'un astérisque (*) : ABC*, par exemple. Tous les programmes de service dont le nom commence par le nom générique et pour lesquels l'utilisateur dispose de droits sont examinés pendant la résolution des symboles.

nom

Indiquez le nom du programme de service à examiner pendant la résolution des symboles.

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.

nom

Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche. QTEMP n'est pas un nom de bibliothèque admis pour ce paramètre.

Elément 2 : Activation

*SAME

L'activation du programme de service référencé reste inchangée.

*IMMED

L'activation du programme de service lié a lieu dès que le programme de service en cours de mise à jour est activé.

*DEFER

L'activation du programme de service lié peut être mise en différé jusqu'à ce qu'une fonction exportée par ce programme soit appelée.

Nom bibliothèque *SRVPGM lié (SRVPGMLIB)

Indique le nom de bibliothèque utilisé pour la conversion en programmes de service liés. Une valeur autre que *SAME peut être spécifiée pour ce paramètre si l'attribut de programme ALWLIBUPD a pour valeur *YES.

*SAME

Utilisez le nom de bibliothèque à partir duquel le programme de service (*SRVPGM) est lié.

*LIBL

La recherche s'effectue dans toutes les bibliothèques de la liste des bibliothèques du travail jusqu'à ce que la première correspondance soit trouvée pour chaque objet *SRVPGM lié. La première occurrence d'un objet *SRVPGM est utilisée pour la conversion en programmes de service liés et l'objet *LIBL est sauvegardé pour être utilisé lors de l'exécution. Si aucune correspondance n'est trouvée dans la liste des bibliothèques du travail, l'objet *SRVPGM lié au programme est utilisé. Vous devez disposer du droit *USE sur les objets *SRVPGM de la bibliothèque spécifiée et du droit *EXECUTE sur la bibliothèque elle-même.

Remarque :Les programmes de service provenant des répertoires de liage implicites (programmes de service fournis par le système) ne sont pas modifiés.

nom

Indiquez le nom de la bibliothèque à utiliser en premier pour la conversion vers tous les programmes de service liés. Si un objet *SRVPGM lié existe dans la bibliothèque spécifiée au paramètre SRVPGMLIB, cet objet *SRVPGM est utilisé à la place de l'objet *SRVPGM lié et le nom de bibliothèque spécifié au paramètre SRVPGMLIB est sauvegardé pour être utilisé lors de l'exécution. Si aucun objet *SRVPGM n'existe dans cette bibliothèque, l'objet *SRVPGM lié au programme est utilisé. Vous devez disposer du droit *USE sur les objets *SRVPGM de la bibliothèque spécifiée et du droit *EXECUTE sur la bibliothèque elle-même.

Répertoire de liage (BNDDIR)

Indique le répertoire de liage dans lequel des exportations doivent être recherchées lorsque des demandes d'importation pour la résolution des symboles externes ne peuvent pas être satisfaites par (1) les modules et les programmes de service du programme lié mis à jour ou par (2) le programme de service indiqué au paramètre BNDSRVPGM. Si un module ou un programme de service listé dans le répertoire de liage indiqué peut résoudre les symboles externes, il est ajouté aux modules ou aux programmes de service qui sont liés au programme lié. Jusqu'à 300 noms peuvent être définis.

Valeurs particulières

*NONE

Aucun répertoire de liage, à l'exception de ceux du programme de service lié mis à jour, n'est examiné pendant la résolution des symboles.

Qualificatif 1 : Répertoire de liage

nom

Indiquez le nom du répertoire de liage à utiliser pendant la résolution des symboles.

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

La recherche porte sur la bibliothèque en cours du travail. Si aucune bibliothèque n'est indiquée, QGPL est utilisée.

*USRLIBL

La recherche porte uniquement sur les bibliothèques figurant dans la partie utilisateur de la liste des bibliothèques du travail.

nom

Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche.

Groupe d'activation (ACTGRP)

Indique le groupe d'activation à utiliser pour le programme de service mis à jour.

*SAME

Le groupe d'activation n'est pas modifié. Spécifiez cette valeur si le groupe d'activation *CALLER a été attribué au programme de service au moment de sa création.

nom

Indiquez le nom du groupe d'activation associé à ce programme de service appelé. Si un groupe d'activation nommé a été attribué au programme de service au moment de sa création, le nom de ce groupe d'activation peut être remplacé par un autre.

Remarque :La modification du nom du groupe d'activation peut avoir une influence sur le fonctionnement du programme (ou programme de service). Reportez-vous au manuel ILE Concepts, SC41-5606 pour obtenir des informations détaillées sur le fonctionnement des groupes d'activation nommés.

Options de création (OPTION)

Indique les options à utiliser lorsque l'objet programme de service est mis à jour.

Vous pouvez indiquer jusqu'à 7 valeurs pour ce paramètre.

Création d'objets programme

*GEN

Un objet programme mis à jour est créé.

*NOGEN

Aucun objet programme mis à jour n'est créé.

Noms de procédure en double

*DUPPROC

Pendant la résolution des symboles, les noms des procédures exportées depuis les modules et les programmes de service ne doivent pas nécessairement être uniques. Pour plus de détails, reportez-vous au manuel ILE Concepts, SC41-5606.

*NODUPPROC

Pendant la résolution des symboles, le nom de chacune des procédures exportées depuis les modules et les programmes de service doit être unique.

Noms de variable en double

*DUPVAR

Pendant la résolution des symboles, les noms des variables exportées depuis les modules et les programmes de service ne doivent pas nécessairement être uniques. Pour plus de détails, reportez-vous au manuel ILE Concepts, SC41-5606.

*NODUPVAR

Pendant la résolution des symboles, le nom de chacune des variables exportées depuis les modules et les programmes de service doit être unique.

Génération des messages de diagnostic

*WARN

Les messages de diagnostic appropriés sont signalés. En outre, si vous admettez les procédures ou les variables en double (*DUPPROC ou *DUPVAR), les doublons éventuels sont signalés à l'aide d'un message de diagnostic.

*NOWARN

Aucun message d'information ou de diagnostic n'est généré.

Suppression de modules obsolètes

Un module obsolète est un module du programme lié mis à jour. A l'origine, ce module était lié dans le programme d'un répertoire de liage afin de résoudre une ou plusieurs importations. Les importations ne sont pas résolues pour la mise à jour de ce programme.

*NOTRIM

Les modules obsolètes ne sont pas enlevés du programme lié.

Remarque :Lorsque *NOTRIM est indiqué, la taille des programmes risque, avec la durée, d'augmenter de façon significative.

*TRIM

Les modules obsolètes sont enlevés du programme lié.

Remarque :Si les modules obsolètes sont enlevés du programme lié, les exportations que les modules contiennent ne seront pas disponibles pour la mise à jour d'autres programmes.

Résolution des références (importations)

*RSLVREF

Toutes les importations doivent être résolues dans des exportations pour le programme de service lié à mettre à jour.

*UNRSLVREF

Toutes les importations ne doivent pas nécessairement être résolues dans des exportations pour le programme de service lié à mettre à jour.

Remarque :Si cette commande contient une importation non résolue, une erreur sera signalée lors de l'exécution de la commande.

Prise en charge des fichiers événements

*NOEVENTF

Ne crée pas le fichier événements destiné aux outils client. Les outils clients utilisent ce fichier pour fournir le suivi intégré des erreurs. Un fichier événements est normalement créé lorsque vous mettez à jour un programme de service à partir des outils client.

*EVENTF

Crée un fichier événements destiné aux outils client. Le fichier est créé en tant que membre du fichier EVFEVENT dans la bibliothèque destinée à recevoir l'objet programme de service mis à jour. Si EVFEVENT n'existe pas, il est créé automatiquement. Le nom de membre du fichier événements est identique à celui de l'objet mis à jour.

Les outils clients utilisent ce fichier pour fournir le suivi intégré des erreurs. Un fichier événements est normalement créé lorsque vous mettez à jour un programme de service à partir des outils client.

Détail liste (DETAIL)

Indique le niveau de détail du listage d'éditeur de liens à imprimer. Le fichier imprimante *LIBL/QSYSPRT est utilisé pour créer le listage.

*NONE

Aucun listage d'éditeur de liens n'est imprimé.

*BASIC

La table récapitulative abrégée, les options transmises à cette commande et des statistiques de traitement sont imprimées.

*EXTENDED

La table récapitulative développée et des informations concernant le liage sont imprimées, en plus des informations fournies par le listage *BASIC (qui comprend la table récapitulative abrégée, les options transmises à cette commande et des statistiques de traitement).

*FULL

La liste des références croisées est imprimée, en plus des informations fournies par le listage *EXTENDED (qui comprend la table récapitulative développée, des informations concernant le liage, la table récapitulative abrégée, les options transmises à cette commande et des statistiques de traitement).

Exemples

UPDSRVPGM   SRVPGM(WORKDOC)  MODULE(BIN/TASKTWO)
            RPLLIB(*MODULE)

Cette commande remplace le module nommé TASKTWO dans l'objet programme de service nommé WORKDOC par un autre module nommé TASKTWO de la bibliothèque BIN, uniquement si le module remplacé est issu de la bibliothèque BIN.

Messages d'erreur

Messages *ESCAPE

CPF223D

Non autorisé à mettre à jour &1 de &2 type *&3.

CPF223E

Echec de la vérification des droits sur l'attribut d'utilisation de droits adoptés.

CPF5CA7

La valeur de SRVPGMLIB doit être *SAME lorsque ALWLIBUPD a pour valeur *NO.

CPF5CAC

Impossible d'ouvrir le fichier STREAM.

CPF5CE1

Le programme de service &1 n'a pas été mis à jour.

CPF5CE2

Erreur inattendue lors de la mise à jour du programme ou du programme de service.

CPF5D1C

La mise à jour du programme de service &1 de la bibliothèque &2 n'est pas admise.