Utilisez l'assistant Appel de programme pour appeler un programme ou une procédure i à partir de votre application Java™. L'assistant vous demande des informations concernant les objets
programme ou programme de service, ainsi que les paramètres
des objets, puis il crée les beans Java voulus et le fichier PCML.
Avant de commencer
Avant de lancer l'assistant, vous devez avoir créé un projet Java ou un projet Web dynamique.
- Si vous envisagez d'utiliser les beans Java générés dans une application Java, vous devez les créer dans un projet Java. En outre, nous vous conseillons de lancer l'assistant Appel de programme depuis une perspective Java.
- Si vous envisagez d'utiliser les beans Java générés dans un service Web, vous devez les créer dans un projet Web dynamique. En outre, nous vous conseillons de lancer l'assistant Appel de programme depuis une perspective Web.
Pourquoi et quand exécuter cette tâche
L'assistant vous aide à définir les éléments suivants :
- Les objets programme ou les procédures de programme
service
- Les paramètres nécessaires aux objets programme ou
aux procédures de programme
- Les structures utilisées par les paramètres
En fonction des éléments que vous avez définis, l'assistant crée un fichier PCML et des beans Java, qui vous permettront d'appeler votre programme ou procédure IBM® i. S'il existe déjà un fichier PCML contenant toutes les définitions, vous pouvez importer
le fichier PCML et l'assistant peut générer des beans Java à partir de ce fichier.
Pour utiliser la première page de l'assistant Appel de programme :
- Lancez l'assistant. Si vous avez déjà créé un bean Appel de programme, cliquez deux fois sur le fichier MPCML. Nous vous conseillons d'utiliser cette méthode, car elle regroupe toutes les informations (package et configuration) dans l'assistant, ainsi que les données PCML. Sinon, exécutez la méthode de votre choix :
- Sélectionnez le projet ou le package dans lequel vous souhaitez que l'assistant génère les beans Java et le fichier PCML. Cliquez sur l'icône .
- Sélectionnez un fichier PCML si vous souhaitez transférer les
informations contenues dans celui-ci au sein de l'assistant. Cliquez sur l'icône Créer un bean d'appel de programme dans la barre de menus principale.
- Si vous souhaitez extraire les informations définies dans un fichier PCML existant ou si vous disposez d'un fichier source RPG ou COBOL et souhaitez générer un fichier PCML à partir de ce dernier, cliquez sur Importer.
- Vous pouvez importer un fichier PCML que vous avez créé, un fichier PCML généré par l'assistant Appel de programme ou un fichier PCML généré par le compilateur ILE RPG ou ILE COBOL.
- Vous pouvez sélectionner un fichier source RPG ou COBOL pour générer un fichier PCML directement à partir de ce dernier.
Lisez la description de la tâche connexe Importation d'un fichier PCML.
- Pour définir un programme ou une procédure de
programme service que vous souhaitez appeler, cliquez sur Ajouter un programme. Définissez
un programme comme indiqué dans les références
connexes ci-après. La définition apparaît dans la sous-fenêtre de gauche de l'assistant.
- Pour définir un paramètre nécessaire au programme ou à la procédure, sélectionnez le noeud qui représente le
programme dans la vue arborescente, puis cliquez sur Ajouter un paramètre.
- Après avoir défini un programme ou une structure, vous pouvez cliquer avec le bouton droit de la souris sur la définition de programme, de paramètre ou de structure dans le cadre gauche et sélectionner l'une des options suivantes. Vous pouvez également cliquer avec le bouton droit de la souris sur un noeud de la sous-fenêtre de gauche pour ajouter une définition de programme ou de structure même si aucun élément n'a été défini.
- Ajouter un programme (pour ajouter un programme)
- Ajouter un paramètre (pour ajouter un paramètre au programme ou à la structure sélectionné)
- Ajouter une structure (pour ajouter une structure)
- Monter (pour déplacer l'élément sélectionné vers le haut)
- Descendre (pour déplacer l'élément sélectionné vers le bas)
- Supprimer (pour supprimer l'élément sélectionné)
Que faire ensuite
Lorsqu'au moins un objet programme ou programme de service est défini, vous pouvez passer à la page suivante de l'assistant (Création d'un bean Java d'appel de programme IBM i et d'un fichier PCML). Pour plus d'informations sur cet assistant, cliquez sur les liens ci-après.