Ajouter un programme

Sur la page de l'assistant, les options de la zone Ajouter un programme sont disponibles par défaut lorsque vous sélectionnez le bouton d'option Utiliser un programme ou une procédure IBM® i. Les options décrites dans le tableau suivant permettent de définir l'objet de programme ou programme de service que vous souhaitez appeler. Si vous avez déjà défini des programmes ou des programmes de service pour les interactions Web, vous pouvez modifier les options définies dans la zone Editer un programme. Pour définir un nouveau programme ou programme de service, cliquez sur le bouton Ajouter un programme. Vous pouvez également cliquer avec le bouton droit de la souris sur l'icône Racine ou l'icône Programme dans la vue Définitions d'appel de programme et sélectionner Ajouter un programme.

Option Description
Alias de programme Entrez un nom comme alias de programme pour l'objet de programme que vous indiquez. Cette valeur est utilisée lors de la création des classes Java™ pour cette interaction.
Objet de programme Nom de l'objet programme ou de l'objet programme de service. Il doit s'agir d'un nom d'objet IBM i correct. Cliquez sur Parcourir et connectez-vous à un serveur IBM i pour rechercher l'objet de programme que vous souhaitez appeler. Pour plus d'informations, voir Recherche d'objets ci-dessous.
Bibliothèque Nom de la bibliothèque qui contient l'objet de programme. Il doit s'agir d'un nom de bibliothèque IBM i correct. Vous pouvez également sélectionner *LIBL si la bibliothèque qui contient l'objet de programme est dans votre liste de bibliothèques ou *CURLIB si elle correspond à la bibliothèque active. Le chemin résultant sera /QSYS.LIB/%LIBL%/Nom_programme.pgm.
Type de programme Par défaut : *PGM. Sélectionnez *PGM pour indiquer que l'objet est un objet de programme. Sélectionnez *SRVPGM si l'objet est un objet de programme de service.
Point d'entrée Le nom de la procédure ou de la fonction au sein de l'objet programme de service. La cible de cet appel de programme, à indiquer s'il s'agit d'un objet programme de service. Cette valeur est soumise à la distinction majuscules/minuscules. Cliquez sur Parcourir et connectez-vous à un serveur IBM i pour rechercher le programme de service que vous souhaitez appeler. Pour plus d'informations, voir Recherche de procédures ci-dessous.
CCSID de point d'entrée L'ID de jeu de caractères du point d'entrée au sein d'un programme de service. Vous trouverez de plus amples informations dans les notes relatives aux entrées de programme, dans le document ServiceProgramCall javadoc.
Type de retour Type de valeur renvoyée, le cas échéant, par un appel de programme de service. Seuls les objets *SRVPGM sont associés à un type de retour.

void : Le programme ne renvoie pas de valeur.

integer : Le programme renvoie un entier signé de quatre octets.

La valeur par défaut est void.

void et integer sont les seuls types de retour admis. Pour que le programme de service renvoie d'autres types de données, vous devez indiquer un paramètre output ou input & output via l'option Ajouter un paramètre.

Ordre d'analyse Ordre dans lequel les paramètres de sortie seront traités. Vous devez fournir une liste de noms de paramètre séparés par des blancs selon l'ordre dans lequel les paramètres seront traités. Les noms de la liste doivent être identiques à ceux spécifiés pour l'attribut de nom des balises appartenant au programme. Par défaut, le programme traite les paramètres de sortie dans l'ordre d'apparition des balises dans le document.
Autorisant les unités d'exécution multiples Lorsque vous appelez un programme Java et un programme IBM i se trouvant sur le même serveur, utilisez cette zone pour indiquer si vous souhaitez appeler le programme IBM i dans le même travail et dans la même unité d'exécution que le programmeJava. Si vous savez que votre programme prend en charge les unités d'exécution multiples, vous pouvez obtenir de meilleures performances en attribuant une valeur true à la propriété. Pour que l'environnement reste sûr, la valeur par défaut est d'appeler des programmes dans des travaux de serveur distincts. La valeur par défaut est false.
Associer ce programme à l'interaction Cette case est automatiquement sélectionnée lorsque le programme défini est le seul qui apparaît dans la zone de définitions d'appel de programme. Si la liste comprend plusieurs programmes, vous pouvez sélectionner celui à utiliser avec l'interaction que vous définissez :
  1. Dans la liste, sélectionnez le programme à utiliser avec l'interaction Web. La description figurant au-dessus des options est remplacée par Editer un programme.
  2. Cochez la case Associer ce programme à l'interaction, puis cliquez sur OK.

Le système affiche un petit astérisque dans le coin supérieur droit de l'icône programme, indiquant que le programme est associé à l'interaction Web que vous définissez.

Remarque : Pour appeler à distance un objet ou une procédure de programme de service, les conditions suivantes doivent être remplies :
  • Le programme de service doit figurer sur un serveur IBM i.
  • Vous ne pouvez pas transmettre plus de sept paramètres au programme de service.
  • La valeur renvoyée par le programme de service est void ou un entier signé de 4 octets.

Le bouton Importer un fichier PCML apparaît toujours dans cette page.

Commande Description
Importer un fichier PCML Cliquez sur Importer un fichier PCML pour sélectionner un fichier PCML autonome dans votre espace de travail ou dans le système de fichiers distant. Vous pouvez également sélectionner le code source ILE COBOL ou ILE RPG dans le système de fichiers distant afin de générer automatiquement un fichier PCML et de pouvoir l'importer.
  • Cliquez sur Espace de travail pour afficher la fenêtre Choix du fichier d'espace de travail. Sélectionnez un fichier PCML, puis cliquez sur OK.
  • Cliquez sur Système de fichiers distant pour ouvrir la fenêtre Recherche de fichier. Sélectionnez un fichier PCML, puis cliquez sur OK. Si vous importez un fichier PCML généré par le vérificateur de programme ILE RPG ou ILE COBOL, choisissez Système de fichiers éloigné et naviguez jusqu'à votre espace de travail local.

    L'arborescence du fichier PCML sélectionné apparaît dans le volet droit de la fenêtre. Vous pouvez sélectionner une ou plusieurs structures et un ou plusieurs programmes dans la sous-fenêtre de gauche.

Cliquez sur OK pour importer les éléments sélectionnés dans vos définitions d'appel de programme en cours.

Si le nom d'un élément importé est en conflit avec celui d'un élément existant dans les définitions d'appel de programme en cours, une boîte de dialogue demande à l'utilisateur de supprimer l'élément existant. Pour conserver celui-ci au lieu de l'écraser, l'utilisateur doit renommer l'élément avant de procéder à l'importation. Si l'élément sélectionné requiert une structure, l'assistant importe également la structure en question.

Recherche d'objets

Permet de sélectionner un objet dans la bibliothèque native IBM i.

  1. Si vous n'avez pas défini de connexion à votre serveur IBM i, développez Nouvelle connexion pour définir une connexion, sinon développez la connexion souhaitée pour rechercher un objet.
  2. Si vous souhaitez rechercher un objet de programme figurant dans la liste des bibliothèques associées à votre profil d'ouverture de session, développez *LIBL ; sinon, développez Gérer des bibliothèques pour créer un nouveau filtres de bibliothèques.
  3. Développez l'arborescence de la bibliothèque dans laquelle vous souhaitez effectuer la recherche.
  4. Sélectionnez un objet programme ou programme de service.
  5. Cliquez sur OK.
    • La zone Objet de programme contient le nom de l'objet que vous venez de sélectionner.
    • La zone Bibliothèque contient le nom de la bibliothèque.
    • La zone Type de programme est définie soit à *PGM, soit à *SRVPGM.

Recherche de procédures

Permet de sélectionner une procédure dans les bibliothèques IBM i natives.

  1. Si vous n'avez pas défini de connexion à votre serveur IBM i, développez Nouvelle connexion pour définir une connexion, sinon développez la connexion souhaitée pour rechercher un objet.
  2. Si vous souhaitez rechercher un objet de programme de service figurant dans la liste des bibliothèques associées à votre profil d'ouverture de session, développez *LIBL ; sinon, développez Gérer des bibliothèques pour créer un nouveau filtre de bibliothèques.
  3. Développez l'arborescence de la bibliothèque dans laquelle vous souhaitez effectuer la recherche.
  4. Sélectionnez un objet de programme de service.
  5. Développez un module.
  6. Sélectionnez une procédure.
  7. Cliquez sur OK.
    • La zone Point d'entrée contient le nom de la procédure que vous venez de sélectionner.
    • La zone Bibliothèque contient le nom de la bibliothèque.
    • La zone Objet de programme contient le nom de l'objet de programme de service.
    • La zone Type de programme est définie sur *SRVPGM.

Commentaires en retour