Configuration de votre environnement d'exécution Java IBM i

La troisième page de l'assistant Appel de programme permet de définir les valeurs de configuration d'exécution et d'authentification des programmes et procédures IBM® i appelés par l'application Java™ ou Web.
Avant de commencer
Pourquoi et quand exécuter cette tâche

Authentification

Pourquoi et quand exécuter cette tâche
Dans l'onglet Authentification, précisez comment les applications Java et Web appelant des programmes résidant sur un système hôte IBM i doivent être connectées et authentifiées. Dans le cas des beans de services, l'assistant Appel de programme génère toujours un fichier de configuration d'exécution. Par contre, vous n'êtes pas obligé de générer le fichier dans le cas des beans d'applications Java. Par défaut, le fichier est appelé defaultPCW.config et réside dans le dossier source Java du projet. Vous pouvez remplacer le fichier en générant votre propre fichier de configuration, que vous pourrez appliquer à un ou plusieurs beans Java du projet.
  • Si vous avez choisi Application Java sur la deuxième page de l'assistant, l'option Générer un fichier de configuration est sélectionnée par défaut. Si vous la désélectionnez, aucune des zones de la page n'est disponible.
  • Si vous avez choisi Services sur la deuxième page de l'assistant, l'option Générer un fichier de configuration est sélectionnée par défaut. Vous ne devez pas modifier ce paramètre.
Vous pouvez choisir un autre fichier de configuration dans la liste déroulante, ou taper le nom d'un nouveau fichier de configuration. La liste regroupe le nom de tous les fichiers .config du projet. Plusieurs beans Java peuvent désigner le même fichier .config.

Liste des bibliothèques

Pourquoi et quand exécuter cette tâche
Facultatif : Dans l'onglet Liste des bibliothèques, définissez les informations de la liste des bibliothèques d'exécution des applications Java ou Web qui appellent des programmes résidant sur un système hôte IBM i.
  1. Dans la zone Liste de bibliothèques d'exécution, indiquez les bibliothèques d'exécution requises par le programme. Une fois le travail créé et avant que le programme ou la procédure IBM i soient appelés, le système ajoute alors les bibliothèques à la liste de bibliothèques résidant sur le serveur IBM i.
    1. Dans la zone Bibliothèque, indiquez le nom de la bibliothèque et cliquez sur Ajouter pour l'ajouter à la liste.
    2. Dans la zone Position en bibliothèque, cliquez et sélectionnez *FIRST ou *LAST pour indiquer si la bibliothèque doit être ajoutée en première ou en dernière position dans la liste. Appuyez sur Entrée pour enregistrer l'entrée dans la liste des bibliothèques. Les bibliothèques de la liste sont utilisées par le programme au stade de l'exécution.
    3. Pour supprimer une bibliothèque de la liste, sélectionnez la bibliothèque concernée et cliquez sur Supprimer.
    4. Pour modifier l'ordre des bibliothèques dans la liste, cliquez sur Monter ou Descendre.
  2. Si vous affectez la valeur *CRTDFT à la zone Bibliothèque actuelle, tous les objets créés dans la bibliothèque actuelle (avec le paramètre *CURLIB, indiqué sur la ligne de commande) utilisent la bibliothèque QGPL comme bibliothèque actuelle par défaut. Si vous affectez la valeur *USRPRF à la zone Bibliothèque actuelle, le système utilise le paramètre défini dans le profil utilisateur.
  3. Dans la zone Commande initiale, indiquez la commande hôte à exécuter une fois que vous vous êtes identifié sur le système hôte. Par exemple, vous pouvez spécifier un programme de configuration CL pour configurer l'environnement avant d'appeler des applications. Selon l'ID utilisateur, le programme peut ajouter des bibliothèques supplémentaires à la liste de bibliothèques.
  4. Cliquez sur Suivant, pour afficher les informations récapitulatives, ou sur Terminer.
Que faire ensuite
Fichier de configuration d'exécution

Le système génère et place un fichier de configuration d'exécution comprenant tous vos paramètres dans le dossier source du projet Java. Par défaut, tous les beans Java générés à partir du fichier PCML utilisent le même fichier, defaultPCW.config, pour leur configuration d'exécution. Vous pouvez remplacer le fichier en générant votre propre fichier de configuration, que vous pourrez appliquer à un ou plusieurs beans Java du projet.

Par défaut, le bean Java généré recherche le fichier de configuration d'exécution à l'emplacement du chemin d'accès aux classes. S'il le trouve, le bean Java utilise les paramètres d'exécution du fichier. Dans le cas contraire, l'application client doit définir les propriétés d'exécution du bean Java. Même si le bean Java trouve le fichier, l'application client peut toutefois remplacer les paramètres dans le fichier en utilisant les méthodes correspondantes du bean Java généré.

  • Si le fichier defaultPCW.config existe, le programme complète les zones de texte des deux onglets en utilisant les données du fichier defaultPCW.config pour créer un bean d'appel de programme.
  • S'il s'agit d'un projet Java mais que le fichier defaultPCW.config n'existe pas, le programme utilise par défaut la méthode d'authentification "Définir des valeurs d'ouverture de session" et toutes les zones restent vides.
  • Si le projet est un projet Web dynamique que le fichier defaultPCW.config n'existe pas, le programme récupère les données à partir du fichier web.xml.

Remarques supplémentaires

Outre la définition des valeurs d'authentification et d'exécution, vous devez également vérifier que les serveurs hôte sont en cours d'exécution sur le système hôte IBM i. Les serveurs sont *SRVMAP, *CENTRAL, *RMTCMD et *SIGNON.

Pour démarrer un serveur hôte, vous devez exécuter la commande STRHOSTSVR. Par exemple, tapez STRHOSTSVR *RMTCMD pour démarrer le serveur *RMTCMD. Pour démarrer tous les serveurs hôte, exécutez la commande STRHOSTSVR *ALL.

Pour pouvoir tester les applications Web IBM i dans l'environnement de test Rational Developer for Power Systems Software, vous devez disposer d'une connexion TCP/IP avec le système hôte IBM i et le profil utilisateur QUSER doit être activé.


Commentaires en retour