CRTPGM

La commande CRTPGM (Créer un programme) permet de créer un programme lié à partir d'un ensemble de modules et de répertoires de liage.

Restrictions :

• Vous devez disposer des droits de lecture (*READ) et d'ajout (*ADD) sur la bibliothèque dans laquelle le programme doit être créé.
• Vous devez disposer du droit d'utilisation (*USE) sur les modules, les programmes de service et les répertoires de liage spécifiés.

Paramètres

Programme (PGM)

Indique l'objet programme à créer.

Ce paramètre est obligatoire.

Qualificatif 1 : Programme

nom

Indiquez le nom du programme à créer.

Qualificatif 2 : Biblio

*CURLIB

L'objet programme est créé dans 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 l'objet programme est créé.

Module (MODULE)

Indique la liste des modules copiés et liés pour créer l'objet programme. Si des spécifications de module et de bibliothèque existent en double, seule la première occurrence est utilisée. Les modules de cette liste sont copiés dans l'objet programme final. Jusqu'à 300 noms peuvent être définis.

Valeurs particulières

*PGM

Le nom indiqué à l'invite Programme (paramètre PGM) est utilisé comme nom de l'objet module.

Qualificatif 1 : Module

*ALL

Recherchez tous les objets modules dans la ou les bibliothèques indiquées.

nom-générique

Indiquez tous les objets modules dont le nom commence par les caractères qui précèdent l'astérisque (*) dans la ou les bibliothèques indiquées.

nom

Indiquez le nom du module copié pour créer l'objet programme.

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.

Texte 'descriptif' (TEXT)

Indique le texte qui décrit brièvement l'objet programme.

*ENTMODTXT

La description du module indiquée à l'invite Module procédure entrée pgm (paramètre ENTMOD) est utilisée.

*BLANK

Aucun texte n'est indiqué.

valeur-caractère

Indiquez, entre apostrophes, un texte de 50 caractères au maximum.

Module procédure entrée pgm (ENTMOD)

Indique le nom du module qui contient la spécification de procédure d'entrée de programme à utiliser.

Valeurs particulières

*FIRST

Le premier module de la liste des modules qui contient une spécification de procédure d'entrée de programme est choisi comme procédure d'entrée de programme.

*ONLY

Un seul module de la liste des modules peut contenir une spécification qui soit une procédure d'entrée de programme. Si plusieurs modules contiennent une telle spécification, une erreur est signalée.

*PGM

Le nom et la bibliothèque indiqués à l'invite Programme (paramètre PGM) identifient le module qui contient la spécification de procédure d'entrée de programme.

Qualificatif 1 : Module procédure entrée pgm

nom

Indiquez le nom du module qui contient la spécification de procédure d'entrée de programme. Si ce module ne figure pas dans la liste des modules à inclure dans ce programme, il y est ajouté. Si ce module ne contient pas de spécification de procédure d'entrée de programme, le programme n'est pas créé.

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.

Lier programme de service (BNDSRVPGM)

Indique la liste des exportations de programmes de service à examiner lors du liage afin de s'assurer qu'elles peuvent satisfaire toute demande d'importation de module. Les exportations de programmes de service sont vérifiées uniquement s'il existe des demandes d'importation de module non résolues et non satisfaites par les exportations. Tout programme de service indiqué au paramètre BNDSRVPGM satisfaisant une demande d'importation de module est lié au programme en cours de création. Le nom de programme de service et la bibliothèque indiqués au paramètre BNDSRVPGM sont sauvegardés pour être utilisés au moment de l'exécution. 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 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 n'est indiqué.

Elément 1 : Programme de service

Qualificatif 1 : Programme de service

*ALL

Recherchez tous les objets programmes de service dans la ou les bibliothèques indiquées.

Remarque :N'indiquez cette valeur que dans environnement contrôlé par l'utilisateur, c'est-à-dire lorsque vous savez avec précision quels éléments seront liés à votre programme. Si vous spécifiez *LIBL avec *ALL, vous risquez d'obtenir des résultats inattendus lors de l'exécution du programme. Afin de mieux contrôler les éléments qui seront liés à votre programme, indiquez le nom générique du programme de service, ou bien précisez des bibliothèques particulières.

nom-générique

Indiquez tous les objets programmes de service dont le nom commence par les caractères qui précèdent l'astérisque (*) dans la ou les bibliothèques indiquées.

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.

Remarque :QTEMP n'est pas un nom de bibliothèque admis pour ce paramètre.

Elément 2 : Activation

*IMMED

L'activation du programme de service lié a lieu dès que le programme en cours de création 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.

Répertoire de liage (BNDDIR)

Indique la liste des répertoires de liage utilisés dans la résolution des symboles. Les exportations des modules et des programmes de service contenus dans le répertoire de liage sont vérifiées uniquement s'il existe des demandes d'importation de module non résolues par les exportations des modules et des programmes de service indiqués dans les paramètres MODULE et BNDSRVPGM. Jusqu'à 300 noms peuvent être définis.

Valeurs particulières

*NONE

Aucun répertoire de liage n'est indiqué.

Qualificatif 1 : Répertoire de liage

nom

Indiquez le nom du répertoire de liage utilisé dans 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 auquel ce programme est associé lorsqu'il est appelé. Un groupe d'activation fournit les éléments suivants :

• Structures de données pour gérer l'exécution des programmes
• Protection d'adressage
• Frontière logique pour la création de messages
• Frontière logique pour le ménage des applications

*ENTMOD

Lorsque ACTGRP(*ENTMOD) est défini, le module de procédure d'entrée de programme (paramètre ENTMOD) est examiné. Si l'attribut de module est RPGLE, CBLLE ou CLLE, alors ACTGRP(QILE) ou ACTGRP(QILETS) est utilisé. QILE est utilisé lorsque STGMDL(*SNGLVL) est défini et QILETS lorsque STGMDL(*TERASPACE) est défini. Si l'attribut de module n'est pas RPGLE, CBLLE ou CLLE, alors ACTGRP(*NEW) est utilisé.

*NEW

Lorsque ce programme est appelé, un nouveau groupe d'activation est créé. Le programme est ensuite associé à ce dernier.

*CALLER

Lorsque ce programme est appelé, il est activé dans le groupe d'activation du programme appelant.

nom

Indiquez le nom du groupe d'activation à utiliser lors de l'appel de ce programme.

Options de création (OPTION)

Indique les options à utiliser lorsque l'objet programme est créé.

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

Objets programmes

*GEN

Un objet programme est généré.

*NOGEN

Aucun objet programme n'est généré.

Noms de procédure en double

*NODUPPROC

Pendant la phase de résolution des symboles du processus de liage, le nom de chaque procédure exportée à partir des modules et des programmes de service doit être unique.

*DUPPROC

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

Noms de variable en double

*NODUPVAR

Pendant la phase de résolution des symboles du processus de liage, le nom de chaque variable exportée à partir des modules et des programmes de service doit être unique.

*DUPVAR

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

Génération des messages de diagnostic

*WARN

Si des variables ou des procédures existent en double, le système signale les doublons à l'aide d'un message de diagnostic.

*NOWARN

Si des variables ou des procédures existent en double, aucun message de diagnostic n'est généré.

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

*RSLVREF

Toutes les importations doivent être résolues dans des exportations pour le programme à créer.

*UNRSLVREF

Toutes les importations n'ont pas besoin d'être résolues dans des exportations pour le programme à créer. Si le programme tente d'utiliser l'une des importations non résolues au moment de l'exécution, une erreur d'exécution MCH4439 est générée.

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 créez un programme à 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 créé. Si le fichier EVFEVENT n'existe pas, il est créé automatiquement. Le nom de membre du fichier événements est le même que celui de l'objet créé.

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

Détail liste (DETAIL)

Indique le niveau de détail à imprimer.

*NONE

Aucun listage n'est généré.

*BASIC

Contient un listage des options fournies à CRTPGM et des statistiques de traitement, ainsi que la table récapitulative abrégée.

*EXTENDED

En plus des informations fournies dans le listage *BASIC, ce listage contient la table récapitulative développée et des informations de liage.

*FULL

Ce listage contient le listage *EXTENDED et le listage des références croisées.

Remarque :Si un listage imprimé est demandé, le fichier imprimante *LIBL/QSYSPRT est utilisé.

Mise à jour admise (ALWUPD)

Indique si une mise à jour du programme créé, à l'aide de la commande UPDPGM (Mettre à jour un programme), est ou non admise.

*YES

La commande UPDPGM peut mettre à jour le programme créé.

*NO

La commande UPDPGM ne peut pas être utilisée pour mettre à jour le programme créé.

Màj biblio *SRVPGM admise (ALWLIBUPD)

Indique s'il convient ou non de permettre que le nom de la bibliothèque de programme de service lié correspondant au programme en cours de création soit modifié lors de sa mise à jour à l'aide de la commande UPDPGM (Mettre à jour un programme).

*NO

La commande UPDPGM n'est pas admise pour la mise à jour des noms de bibliothèque de programme de service lié correspondant au programme en cours de création, même si *YES est indiqué à l'invite Mise à jour admise (paramètre ALWUPD).

*YES

La commande UPDPGM est admise pour la mise à jour des noms de bibliothèque de programme de service lié correspondant au programme en cours de création lorsque ALWUPD(*YES) est spécifié.

Profil utilisateur (USRPRF)

Indique si la vérification des droits effectuée pendant l'exécution du programme concerne uniquement l'utilisateur de ce programme (*USER) ou si elle porte aussi sur le propriétaire du programme (*OWNER). Le profil de l'utilisateur, et éventuellement celui du propriétaire du programme sont utilisés pour déterminer les objets qui peuvent être utilisés par le programme, ainsi que les droits détenus sur chaque objet.

*USER

Le programme s'exécute sous le profil de l'utilisateur qui l'a démarré.

*OWNER

Les profils utilisateur du propriétaire et de l'utilisateur du programme sont utilisés pendant l'exécution de ce dernier.

Remplacer programme (REPLACE)

Indique si le programme viendra remplacer tout programme de même nom existant déjà dans la bibliothèque indiquée.

*YES

Remplace le programme existant en le plaçant dans la bibliothèque QRPLOBJ. Les activations en cours du programme continuent à s'exécuter avec la version du programme dans la bibliothèque QRPLOBJ.

*NO

Aucun remplacement n'est effectué. Un message d'erreur est généré si un programme existe déjà avec le nom et la bibliothèque indiqués à l'inviteProgramme (paramètre PGM).

Droits (AUT)

Indique les droits que vous accordez aux utilisateurs qui n'ont pas de droits spécifiques sur l'objet, qui ne figurent pas sur une liste d'autorisation ou dont le profil de groupe ou les profils du groupe supplémentaire ne disposent pas de droits spécifiques sur l'objet.

*LIBCRTAUT

Le système détermine les droits sur l'objet à l'aide de la valeur spécifiée à l'invite Droits pour objets créés (paramètre CRTAUT) dans la commande CRTLIB pour la bibliothèque contenant l'objet à créer. Si la valeur précisée au paramètre CRTAUT est modifiée, la nouvelle valeur n'affecte pas les objets existants.

*CHANGE

L'utilisateur peut effectuer toutes les opérations sur l'objet, à l'exception de celles réservées au propriétaire ou contrôlées par les droits d'existence de l'objet (*OBJEXIST) et de gestion de l'objet (*OBJMGT). L'utilisateur peut réaliser des fonctions de base sur l'objet et le modifier. Le droit *CHANGE fournit le droit d'opération sur l'objet (*OBJOPR) ainsi que les droits sur toutes les données. Si l'objet est une liste d'autorisation, vous pouvez ajouter, modifier ou supprimer des utilisateurs dans cette liste.

*ALL

L'utilisateur peut effectuer toutes les opérations, à l'exception de celles réservées au propriétaire ou soumises au droit de gestion de la liste d'autorisation (*AUTLMGT). L'utilisateur a un droit d'existence sur l'objet Il peut également effectuer des fonctions de base sur ce dernier, le modifier, définir son niveau de protection et en transférer la propriété.

*USE

L'utilisateur peut effectuer des opérations de base sur l'objet, telles que l'exécution d'un programme ou la lecture d'un fichier. Il ne peut pas le modifier. Le droit d'utilisation (*USE) fournit le droit d'opération sur l'objet (*OBJOPR) ainsi que le droit d'exécution (*EXECUTE).

*EXCLUDE

L'utilisateur n'a pas accès à l'objet.

nom

Indiquez le nom d'une liste d'autorisation permettant de déterminer les droits sur l'objet. Les droits sur l'objet précisés dans la liste sont accordés aux utilisateurs qui figurent sur cette liste. La liste d'autorisation doit exister à la création de l'objet.

Edition cible (TGTRLS)

Indique l'édition du système d'exploitation sur laquelle vous souhaitez utiliser l'objet créé.

Lorsque vous indiquez la valeur édition-cible, le format VxRxMx est utilisé pour préciser l'édition. Vx indique la version, Rx l'édition et Mx le niveau de modification. Par exemple, V5R3M0 correspond à la version 5, édition 3, modification 0.

Les valeurs admises dépendent de la version, de l'édition et du niveau de modification du système d'exploitation, et changent à chaque nouvelle édition. Appuyez sur F4 à l'invite de ce paramètre de commande pour afficher la liste des valeurs admises.

*CURRENT

L'objet sera utilisé sur l'édition en cours du système d'exploitation installée sur votre système. Cet objet pourra également être utilisé sur un système doté de cette édition (ou de toute édition suivante qui sera installée).

*PRV

L'objet sera utilisé sur l'édition précédente, niveau de modification 0, du système d'exploitation. Cet objet pourra également être utilisé sur un système doté de cette édition (ou de toute édition suivante qui sera installée).

valeur-alphanumérique

Indiquez l'édition au format VxRxMx. L'objet pourra être utilisé sur un système doté de celle-ci ou de toute édition suivante du système d'exploitation.

Réinitialisation admise (ALWRINZ)

Indique si la mémoire statique du programme peut être réinitialisée alors que celui-ci est toujours actif.

*NO

La mémoire statique du programme ne peut pas être réinitialisée alors que celui-ci est toujours actif.

*YES

La mémoire statique du programme peut être réinitialisée alors que celui-ci est toujours actif.

Modèle d'espace mémoire (STGMDL)

Indique l'attribut de modèle d'espace mémoire du programme.

*SNGLVL

Le programme est crée avec un modèle d'espace adressable unique. Lorsqu'un programme de ce type est activé et exécuté, il est accompagné d'espace adressable unique pour mémoire automatique et pour mémoire statique. Ce type de programme ne s'exécute qu'au sein d'un groupe d'activation à espace adressable unique.

*TERASPACE

Le programme est crée avec un modèle d'espace mémoire à téraoctets. Lorsqu'un programme de ce type est exécuté, il est accompagné d'un espace mémoire à téraoctets niveau pour mémoire automatique et pour mémoire statique. Ce type de programme ne s'exécute qu'au sein d'un groupe d'activation à modèle d'espace mémoire à téraoctets.

*INHERIT

Le programme est créé avec un modèle d'espace mémoire hérité. Lorsqu'il est exécuté, il adopte le modèle d'espace mémoire correspondant au groupe d'activation au sein duquel il est activé. Il peut aussi hériter le modèle d'espace mémoire du programme appelant. Lorsque le modèle d'espace mémoire de type *INHERIT est sélectionné, *CALLER doit être indiqué à l'invite Groupe d'activation (paramètre ACTGRP).

Optimisation d'argument (ARGOPT)

Indique si l'optimisation d'argument (ARGOPT) va être effectuée lors de la création du programme. L'optimisation d'argument est une technique permettant de transmettre des arguments (paramètres) à des procédures ILE pour améliorer les performances des applications qui requièrent des appels multiples. Cette option peut entraîner une augmentation du temps nécessaire à la création du programme.

*NO

L'optimisation d'argument ne sera pas effectuée pendant la création du programme.

*YES

L'optimisation d'argument sera effectuée pendant la création du programme.

Analyse interprocédurale (IPA)

Indique si l'analyse IPA (interprocedural analysis) doit être utilisée pendant la création du programme. Pour plus d'informations sur l'analyse IPA, consultez le manuel ILE Concepts, SC41-5606.

*NO

L'analyse IPA ne s'exécute pas.

*YES

L'analyse IPA s'exécute.

Fichier de contrôle IPA (IPACTLFILE)

Donne le nom du chemin d'accès à un fichier comportant des informations de sous-option sur l'analyse IPA (interprocedural analysis). Ce paramètre n'est admis que lorsque l'analyse IPA a pour valeur *YES.

*NONE

Aucune information sur le fichier de contrôle IPA n'est nécessaire lorsque l'analyse IPA a pour valeur *YES.

nom-chemin

Indique le nom du chemin d'accès au fichier de contrôle IPA à utiliser lorsque l'analyse IPA a pour valeur *YES. Si le nom est qualifié, il doit être placé entre apostrophes, par exemple : '/directory1/directory2/myipactlfname'

Exemples

CRTPGM   PGM(STAR)

Cette commande crée un objet programme nommé STAR dans la bibliothèque en cours du travail, ou dans QGPL si aucune bibliothèque en cours n'existe. Le programme est créé à partir d'un objet module également nommé STAR et localisé à l'aide de la bibliothèque en cours du travail.

Messages d'erreur

Messages *ESCAPE

CPF223E

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

CPF3C50

Le programme &1 n'a pas été créé. Program &1 not created.

CPF5D12

Erreur détectée lors de la préparation du programme ou du programme de service.