RTVBNDSRC

La commande RTVBNDSRC (Extraire source de liage) permet d'extraire les exportations d'un ensemble de modules, d'un programme de service ou des deux, pour les placer (ainsi que les instructions du langage de liage requis pour les exportations) dans un fichier donné. Ce dernier pourra être indiqué ultérieurement pour la commande CRTSRVPGM (Créer un programme de service). Une fois extrait et placé dans un fichier source, le langage de liage peut être modifié, le cas échéant.

Par défaut, un fichier de langage de liage est indiqué aux paramètres EXPORT et SRCFILE de la commande CRTSRVPGM pour identifier les exportations du programme de service. La commande RTVBNDSRC est utile pour la création automatique de ce langage de liage.

Restrictions :

• Vous devez disposer du droit d'utilisation (*USE) sur la commande CRTSRCPF (Créer un fichier source) si le fichier n'existe pas.
• Vous devez disposer du droit d'utilisation (*USE) sur la commande RGZPFM (Réorganiser un membre de fichier physique).
• Vous devez disposer du droit d'utilisation (*USE) sur la commande ADDPFM (Ajouter un membre à un fichier physique) si le membre n'existe pas.
• Vous devez disposer du droit *USE sur les modules ou le programme de service à partir duquel ou desquels les exportations sont extraites.
• Vous devez disposer du droit d'exécution (*EXECUTE) sur les bibliothèques dans lesquelles se trouvent les modules ou le programme de service.
• Si le fichier et le membre source devant recevoir le langage de liage existe, vous devez disposer des droits de modification (*CHANGE) et du droit de modification des attributs de l'objet (*OBJALTER) ou de gestion (*OBJMGT) sur le fichier, ainsi que du droit d'exécution (*EXECUTE) sur la bibliothèque contenant le fichier.
• Si le fichier source existe et que le membre source doit être créé, vous devez disposer du droit de modification (*CHANGE) et du droit de modification des attributs de l'objet (*OBJALTER) ou de gestion (*OBJMGT) sur le fichier, ainsi que des droits d'exécution (*EXECUTE), de lecture (*READ) et d'ajout (*ADD) sur la bibliothèque contenant le fichier.
• Si le fichier et le membre source doivent être créés, vous devez disposer des droits d'exécution (*EXECUTE), de lecture (*READ) et d'ajout (*ADD) sur la bibliothèque.
• Vous devez disposer du droit d'écriture (*W) sur le répertoire dans lequel le fichier STREAM source doit être créé ou du droit d'écriture (*W) sur le fichier STREAM source si celui-ci existe déjà.
• 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

Module (MODULE)

Indique la liste des modules à partir desquels les symboles exportés doivent être extraits. Si des spécifications de module et de bibliothèque existent en double, seule la première occurrence est utilisée.

Au moins une valeur doit être indiquée pour ce paramètre ou à l'invite Programme de service (paramètre SRVPGM).

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

Qualificatif 1 : Module

*ALL

Les symboles exportés depuis tous les modules de la bibliothèque indiquée sont extraits.

nom-générique

Indiquez un nom de module générique à partir duquel les symboles exportés doivent être extraits. Tous les modules dont le nom commence par le préfixe indiqué dans la ou les bibliothèques précisées sont utilisés. Un nom générique est composé d'un ou plusieurs caractères suivis d'un astérisque (*) : ABC*, par exemple. L'astérisque remplace tout caractère admis. Un nom générique désigne tous les objets dont le nom commence par le préfixe générique sur lesquels l'utilisateur a des droits. Si l'astérisque n'est pas inclus dans le nom (préfixe) générique, le système considère qu'il s'agit d'un nom d'objet complet.

nom

Indiquez le nom du module à partir duquel les symboles exportés doivent être extraits.

Qualificatif 2 : Biblio

*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

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.

Programme de service (SRVPGM)

Indique le programme de service à partir duquel les symboles exportés doivent être extraits. Au moins une valeur doit être indiquée pour ce paramètre ou à l'invite Module (paramètre MODULE).

Qualificatif 1 : Programme de service

nom

Indiquez le nom du programme de service à partir duquel les symboles exportés doivent être extraits.

Qualificatif 2 : Biblio

*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

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.

Fichier source d'exportation (SRCFILE)

Indique le fichier source devant contenir le langage de liage pour les symboles exportés. Si le fichier source n'existe pas, il est créé.

Remarques :

• Seul un fichier physique base de données de type *SRC peut être indiqué. Les fichiers DDM (Gestion de fichiers éloignés) ne sont pas pris en charge.
• Si le fichier source destiné à recevoir le langage de liage existe, sa longueur d'enregistrement doit être au minimum de 92 octets.
• 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.

Qualificatif 2 : Biblio

*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. Si un fichier source portant le nom indiqué n'est pas trouvé dans cette liste, il est créé dans la bibliothèque en cours. Si aucune bibliothèque en cours n'est spécifiée, QGPL est prise par défaut.

*CURLIB

La recherche porte sur la bibliothèque en cours du travail. Si un fichier source portant le nom indiqué n'existe pas, il est créé dans la bibliothèque en cours. Si aucune bibliothèque en cours n'est spécifiée, QGPL est prise par défaut.

nom

Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche. Si un fichier source portant le nom indiqué n'est pas trouvé, il est créé dans cette bibliothèque.

Membre source d'exportation (SRCMBR)

Indique le membre du fichier source devant contenir le langage de liage pour les symboles exportés. Un seul membre source contiendra le langage de liage.

Si le membre n'existe pas dans le fichier source indiqué, il est créé.

Ce paramètre ne peut pas être utilisé avec le paramètre Fichier source export STREAM (SRCSTMF).

*DFT

Le nom du membre de fichier source correspond à la valeur indiquée à l'invite Programme de service (paramètre SRVPGM), si un programme de service est spécifié. Sinon, le nom du membre de fichier source correspond à la valeur indiquée à l'invite :Module (paramètre MODULE),

• Si un seul module est indiqué, son nom correspond au nom du membre utilisé.
• Si plusieurs noms de module sont indiqués, le premier d'entre eux est utilisé.
• Si la valeur *ALL ou un nom générique est indiqué, le nom de module de la première occurrence trouvée est utilisé comme nom de membre source.

nom

Indiquez le nom du membre qui contiendra le langage de liage source.

Fichier source export STREAM (SRCSTMF)

Indique le nom du chemin du fichier STREAM devant contenir le langage de liage pour les symboles exportés. Si le fichier n'existe pas, il sera créé.

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

nom-chemin

Indiquez le nom du chemin du fichier STREAM qui contiendra les spécifications pour l'exportation des données et des procédures.

Remplacement ou ajout enregs (MBROPT)

Indique si les instructions de langage de liage générées sont remplacées ou bien ajoutées aux instructions existantes.

*REPLACE

Le système efface le membre existant ou le fichier STREAM et ajoute es nouveaux enregistrements.

*ADD

Le système ajoute les nouveaux enregistrements à la suite des enregistrements existants.

Remarque :Si le membre ou le fichier STREAM existe déjà et qu'il contient, par exemple, les instructions STRPGMEXP et ENDPGMEXP, il se peut que sont langage de liage comporte plusieurs instructions STRPGMEXP et ENDPGMEXP à la fin de cette opération. Vous devez éditer toutes ces instructions pour utiliser le langage de liage avec la commande CRTSRVPGM (Créer un programme de service).

Exemples

RTVBNDSRC   MODULE(MYLIB/*ALL)
            SRCFILE(MYLIB/MYBINDFILE)  MBROPT(*ADD)

Cette commande extrait les exportations de tous les modules de la bibliothèque MYLIB et les place dans le membre source portant le nom du premier module trouvé. Si ce membre source n'existe par dans le fichier MYBINDFILE de la bibliothèque MYLIB, il est créé. Les instructions d'exportation sont ajoutées à la fin du membre. Si plusieurs instructions de début et de fin relatives à l'exportation de programmes existent dans le fichier lorsque cette commande est terminée, le membre source doit être édité avant d'être utilisé pour créer un programme de service. Les instructions supplémentaires STRPGMEXP, ENDPGMEXP peuvent être enlevées ou le paramètre PGMLVL peut être ajouté aux instructions STRPGMEXP, si certains des blocs d'exportation sont destinés aux versions précédentes du programme de service.

Messages d'erreur

Messages *ESCAPE

CPF5CA5

Longueur d'enregistrement insuffisante pour le fichier source base de données.

CPF5CAC

Impossible d'ouvrir le fichier STREAM.

CPF5CAD

Une erreur s'est produite lors de l'écriture du fichier STREAM.

CPF5CAE

Une erreur s'est produite lors de la fermeture du fichier.

CPF5CAF

Une erreur s'est produite lors de la conversion du chemin d'accès au fichier STREAM, d'un chemin relatif en chemin absolu.

CPF5D06

Non autorisé à accéder à la bibliothèque &2, au fichier &1 de &2 ou au membre &3.

CPF5D08

Le type du fichier &1 de la bibliothèque &2 n'est pas accepté.

CPF9801

Objet &2 non trouvé dans la bibliothèque &3.

CPF9802

Non autorisé à l'objet &2 de &3.

CPF9803

Impossible d'allouer l'objet &2 de la bibliothèque &3.

CPF9810

Bibliothèque &1 non trouvée.

CPF9820

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

CPF9832

Fonction non acceptée pour le fichier DDM &2.

CPF9834

Le fichier en entrée &1 dans &2 n'est pas un fichier source.

CPF9848

Ouverture du membre &3 du fichier &1 de &2 impossible.

CPF9899

Erreur lors du traitement de la commande.