CRTSRVPGM

La commande CRTSRVPGM (Créer un programme de service) permet de créer un programme de service 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 de service 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.
• Vous devez disposer des droits d'opération sur l'objet (*OBJOPR) et de lecture (*READ) sur le fichier indiqué à l'inviteFichier source d'exportation (paramètre 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 l'objet programme de service à créer.

Ce paramètre est obligatoire.

Qualificatif 1 : Programme de service

nom

Indiquez le nom du programme de service à créer.

Qualificatif 2 : Biblio

*CURLIB

Le programme de service 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 le programme de service doit être créé.

Module (MODULE)

Indique la liste des modules copiés et liés pour créer l'objet programme de service. 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 de service final. Jusqu'à 300 noms peuvent être définis.

Valeurs particulières

*SRVPGM

Les noms de module et de bibliothèque indiqués à l'invite Programme de service (paramètre SRVPGM) sont utilisés.

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

*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 le nom des données et des procédures exportées par ce programme de service.

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

*ALL

Toutes les données et les procédures exportées à partir des modules indiqués sont également exportées à partir du programme de service.

Fichier source d'exportation (SRCFILE)

Indique le fichier source contenant les spécifications pour l'exportation des données et des procédures à partir de ce 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 fichier source contenant les spécifications pour l'exportation des données et des procédures est nommé QSRVSRC.

nom

Indiquez le nom du fichier source contenant les spécifications pour l'exportation des données et des procédures.

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 nom du membre du fichier source contenant les spécifications pour l'exportation des données et des procédures à partir de ce programme de service. Ce paramètre ne peut pas être utilisé avec le paramètre Fichier source export STREAM (SRCSTMF).

*SRVPGM

Le nom du membre du fichier source est le même que celui du programme de service indiqué à l'invite Programme de service (paramètre SRVPGM).

nom

Indiquez le nom du membre du fichier source contenant les spécifications pour l'exportation des données et des procédures.

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. 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 le paramètre Edition cible (TGTRLS) indique une édition avant V7R3M0.

nom-chemin

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

Texte 'descriptif' (TEXT)

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

*BLANK

Aucun texte n'est indiqué.

*EXPORTSRC

Le texte descriptif associé au fichier source d'exportation est utilisé par le programme de service. Si la valeur *ALL est indiquée au paramètre Exportation (EXPORT), aucun texte n'apparaîtra.

*MODULE

Le texte descriptif associé au premier module indiqué au paramètre Module (MODULE) est utilisé pour le programme de service.

valeur-caractère

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

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 de service 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 fourni pour la résolution des symboles.

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 un environnement contrôlé par l'utilisateur, c'est-à-dire en connaissant avec précision les éléments qui seront liés au programme de service. La spécification de *LIBL avec *ALL risque de générer des résultats inattendus lors de l'exécution du programme de service. Pour mieux contrôler les éléments qui seront liés à ce dernier, indiquez son nom générique ou 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 du travail pour les programmes de service indiqués. Si l'un des programmes de service contient une exportation qui satisfait une importation de module, celui-ci est recherché dans la liste des bibliothèques au moment de l'exécution.

nom

Indiquez le nom de la bibliothèque dans laquelle les programmes de service peuvent être trouvés. Si l'un des programmes de service contient une exportation qui satisfait une importation de module et qu'une bibliothèque spécifique a été indiquée, le programme de service est recherché dans cette bibliothèque au moment de l'exécution.

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 de service 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. 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 est associé ce programme de service 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

*CALLER

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

nom

Indiquez le nom du groupe associé au programme de service appelé. Si un groupe d'activation, portant le nom indiqué, existe lorsque ce programme de service est appelé, le programme lui est associé. Si tel n'est pas le cas, un nouveau groupe d'activation est créé et le programme de service lui est associé.

Options de création (OPTION)

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

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

Objets programmes de service

*GEN

Un objet programme de service est généré.

*NOGEN

Aucun objet programme de service 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, les doublons sont signalés à 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 de service à créer.

*UNRSLVREF

Toutes les importations n'ont pas besoin d'être résolues dans des exportations pour le programme de service à créer. Si le programme de service 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 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 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 de service à 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 de service créé, à l'aide de la commande UPDPGM (Mettre à jour programme de service), est ou non admise.

*YES

Le programme de service peut être mis à jour à l'aide de la commande UPDSRVPGM.

*NO

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

Màj biblio *SRVPGM admise (ALWLIBUPD)

Indique s'il convient 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 UPDSRVPGM.

*NO

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

*YES

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

Profil utilisateur (USRPRF)

Indique si la vérification des droits concerne uniquement l'utilisateur du programme de service ou si elle porte aussi sur le propriétaire de ce programme.

*USER

Le profil de l'utilisateur du programme de service est utilisé lors de l'exécution de ce dernier.

*OWNER

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

Remplacer programme (REPLACE)

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

*YES

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

*NO

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

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 de service peut être réinitialisée alors que celui-ci est toujours actif.

*NO

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

*YES

La mémoire statique du programme de service 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 de service.

*SNGLVL

Le programme de service est crée avec un modèle d'espace adressable unique. Lorsqu'un programme de ce type est 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 de service 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 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 de service est crée avec un modèle d'espace mémoire hérité. Lorsqu'un programme de ce type est exécuté, il adopte l'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 de service. 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 de service.

*NO

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

*YES

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

Analyse interprocédurale (IPA)

Indique si l'analyse IPA (interprocedural analysis) doit être utilisée pendant la création du programme de service. 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

Indiquez 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

CRTSRVPGM   SRVPGM(WORKDOC)

Cette commande crée l'objet programme de service nommé WORKDOC dans la bibliothèque en cours. Le programme de service est créé à partir d'un objet module également nommé WORKDOC 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.

CPF5CAC

Impossible d'ouvrir le fichier STREAM.

CPF5D05

Programme de service &1 non créé.

CPF5D07

Longueur d'enregistrement du fichier source d'exportation supérieure à 240.

CPF5D12

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