Lorsque vous installez WebSphere Business Integration Server Express sous i5/OS, un grand nombre d'objets i5/OS est créé dans le système i5/OS. Le tableau ci-dessous décrit ces objets :
Elément | Nom | Description |
---|---|---|
Profil utilisateur | QWBISVR44 | Profil utilisateur par défaut qui possède l'ensemble du contenu installé et sous lequel les travaux sont exécutés. |
Bibliothèque | QWBISVR44 | Contient tous les objets natifs i5/OS. |
Descriptions des travaux | QWBIxxxx, où xxxx est une valeur unique spécifique à chaque processus. | Permet d'identifier les travaux s'exécutant dans le sous-système et peut être personnalisé pour chaque travail. Pour visualiser les descriptions des travaux, utilisez la commande WRKJOBD JOBD(QWBISVR44/*ALL). |
Instance d'Interchange Server Express | QWBIDFT44 | L'installation entraîne la création, la configuration et le déploiement du modèle de collaboration CollaborationFoundation sur le serveur, ainsi que du contenu permettant d'exécuter les exemples installés. |
Gestionnaire de files d'attente MQ | QWBIDFT44.QUEUE.MANAGER | L'installation entraîne la création d'un gestionnaire de files d'attente, ainsi que d'un programme d'écoute MQ sur le port par défaut. |
Base de données DB2/400 | QWBIDFT44 | Référentiel du serveur InterChange Server QWBIDFT44. |
Description du sous-système | QWBISVR44/QWBISVR44 | Contient les attributs du sous-système QWBISVR44 dans lequel s'exécutent les processus i5/OS. |
Serveur avec démarrage automatique TCP/IP | QWBISVR44 | Démarre automatiquement le sous-système en activant les serveurs avec démarrage automatique TCP/IP. |
Travail d'auto-démarrage | QWBITNAMES | Serveur de noms requis pour qu'InterChange Server, les adaptateurs et les outils puissent communiquer entre eux. Le port par défaut est utilisé pour le serveur de noms. |
Travail d'auto-démarrage | QWBIDFT44 | Démarre le serveur InterChange Server installé. |
HTTP Server et WebSphere Application Server | ICSMON44 | Instances de HTTP Server et de WebSphere Application Server. |
La prise en charge de i5/OS s'exécute dans le sous-système QWBISVR44, sous le nom de profil utilisateur QWBISVR44. i5/OS affecte un objet unique de description du travail pour chacun des composants suivants :
Pour rechercher un travail, utilisez la commande WRKACTJOB SBS (QWBISVR44). Pour chaque composant, les noms des travaux sont identiques aux noms des descriptions de travaux.
Il existe plusieurs travaux, associés aux travaux nommés du sous-système, ne requérant aucune gestion comme, par exemple, QP0ZSPWP, QP0ZSPWT et QZSHSH.
D'autres travaux, tels QWBIDFT44, vérifient l'état du serveur et d'un adaptateur, tel QWBIJTEXTC pour l'adaptateur JText. Il est recommandé, mais non nécessaire, de créer différents noms et descriptions de travaux pour chaque instance d'un adaptateur si vous exécutez plusieurs instances d'un même adaptateur, par exemple deux instances d'adaptateur JText.
Sous i5/OS, tous les travaux s'exécutent à l'aide du CCSID du profil utilisateur QWBISVR44 correspondant à la valeur système QCCSID. Si votre système exécute les CCSID japonais 5026 ou 290, vous devez remplacer le paramètre CCSID du profil utilisateur QWBISVR44 par la valeur 5035 pour que le produit fonctionne correctement.
Si vous ne souhaitez pas que WebSphere Business Integration Server Express démarre automatiquement lorsque TCP/IP démarre sur votre système, utilisez la commande RMVTCPSVR SVRSPCVAL(*QWBISVR44) pour supprimer QWBISVR44 en tant que serveur avec démarrage automatique TCP.
Si vous ne souhaitez pas que le sous-système démarre automatiquement lorsque TCP/IP démarre sur votre système et ne voulez pas que le serveur QWBIDFT44 démarre automatiquement, utilisez le script remove_autostart_server.sh pour supprimer de votre sous-système le serveur InterChange Server automatiquement démarré.
Avant d'exécuter ce script, exécutez d'abord la commande CL QSH pour accéder à l'environnement QShell. Utilisez la syntaxe suivante pour le script remove_autostart_server.sh :
/QIBM/ProdData/WBIServer44/bin/remove_autostart_server.sh QWBIDFT44
Il est recommandé de conserver le serveur de noms en tant que travail de démarrage automatique dans le sous-système. Le fait de démarrer ce travail automatiquement permet à un moniteur de détecter tout arrêt contrôlé du système ou du sous-système. Sans ce moniteur, un arrêt contrôlé n'arrêterait pas le sous-système QWBISVR44 et ses travaux.
Pour démarrer automatiquement InterChange Server, les agents d'adaptateur et les agents ODA (Object Discovery Agents), exécutez le script start_server.sh (pour InterChange Server), les scripts spécifiques aux adaptateurs, comme start_JText.sh ou ceux spécifiques aux agents ODA, par exemple start_JDBCODA.sh, directement avec le sous-système QWBISVR44.
Tous les fichiers exécutables, la base de données de référentiel et les fichiers spécifiques sont exclusivement associés au profil utilisateur, il est donc important d'utiliser le sous-système QWBISVR44. En outre, vous devez toujours exécuter InterChange Server sous le profil utilisateur QWBISVR44 afin d'éviter tout incident inattendu en matière de droits d'accès.
Pour exécuter un travail d'un agent d'adaptateur sous un autre profil utilisateur, remplacez le paramètre utilisateur figurant dans la description du travail issue du sous-système QWBISVR44 par cet autre profil utilisateur. Cette fonction s'avère particulièrement utile lorsqu'il est nécessaire d'interdire au profil utilisateur QWBISVR44 d'accéder à des données d'application sécurisées par un autre profil utilisateur.
Appliquez la procédure suivante pour changer de port ORB IBM :
Si vous utilisez des outils client Windows, vous devez modifier le fichier CWSharedEnv.bat situé dans le répertoire du produit, arrêter tous les outils actifs puis les redémarrer.
Lors de la création d'une instance de serveur, vous pouvez spécifier le port du programme d'écoute MQ à l'aide du script create_instance.sh. Appliquez la procédure suivante pour changer le port du programme d'écoute MQ :
<tns:name>PORT</tns:name>
<tns:value xml:space="preserve">1416</tns:value>
CHGJOBD JOBD(QWBISVR44/QWBIDFT44) RQSDTA('QSYS/CALL
PGM(QWBISVR44/QWBIDFT44) PARM(QWBIDFT44 ''1417'')')
Lors de la création d'une instance de serveur, vous pouvez spécifier le nom du référentiel d'InterChange Server à l'aide du script create_instance.sh. Appliquez la procédure suivante pour modifier le nom du référentiel :
Lors de la création d'une instance de serveur, vous pouvez spécifier le nom du gestionnaire de files d'attente à l'aide du script create_instance.sh. Appliquez la procédure suivante pour modifier le nom d'un gestionnaire de file d'attente :
WebSphere Business Integration Server Express est fourni avec un grand nombre de scripts spécifiques à i5/OS. Ces scripts sont situés dans le répertoire /QIBM/ProdData/WBIServer44/bin.
Les sections suivantes décrivent chaque script en détail.
Ce script permet de déployer automatiquement l'agent d'adaptateur dès qu'InterChange Server est démarré avec le sous-système QWBISVR44. Il ajoute également des informations relatives au travail de démarrage automatique à l'attention de l'instance du serveur, permettant à cette dernière de soumettre un travail à l'agent d'adaptateur.
La syntaxe ci-dessous correspond au script add_autostart_adapter.sh :
add_autostart_adapter.sh Nom_Adaptateur Nom_Instance Script_Démarrage Description_Travail
où :
L'exemple suivant correspond à l'adaptateur JText :
add_autostart_adapter.sh JText QWBIDFT44 /QIBM/UserData/WBIServer44/QWBIDFT44/connectors/JText/start_JText.sh QWBIJTEXTC
Ce script permet de configurer InterChange Server pour qu'il démarre automatiquement avec le sous-système. Lors de la création d'une instance de serveur à l'aide du script create_instance.sh, l'instance est configurée pour démarrer automatiquement avec le sous-système. Si vous supprimez cette fonctionnalité à l'aide du script remove_autostart_server.sh, utilisez le script add_autostart_server.sh pour rétablir le démarrage automatique initial.
La syntaxe ci-dessous correspond au script add_autostart_server.sh :
add_autostart_server.sh Nom_Serveur Description_Travail,
où :
Ce script permet de créer une nouvelle instance d'Interchange Server, ainsi que des nouveaux répertoires dans /QIBM/UserData/WBIServer44 pour InterChange Server. Il copie également les adaptateurs installés dans ce répertoire, crée une base de données de référentiel DB2/400 et une file d'attente MQ portant le même nom que l'instance, crée un programme d'écoute MQ pour cette file d'attente MQ avec le numéro de port spécifié et ajoute un travail de démarrage automatique au sous-système QWBISVR44 pour le nouveau serveur InterChange Server.
La syntaxe ci-dessous correspond au script create_instance.sh :
create_instance.sh [ -rNom_Référentiel ] [ -qNom_Gestionnaire_Files [ -exists ] ] [ -uuser -ppassword ] [ -dsystème -nUtilisateur_BD -wMot_Passe_BD ] Nom_Serveur Numéro_Port_MQ Numéro_Port_HTTP
Ce script permet de supprimer une instance d'Interchange Server, ainsi que les répertoires associés au serveur dans /QIBM/UserData/WBIServer44, qui est la base de données de référentiel DB2/400 associée au serveur, et le travail de démarrage automatique du serveur figurant dans la description du sous-système QWBISVR44. Ce script ne supprime pas le gestionnaire de files d'attente existant associé au serveur.
La syntaxe ci-dessous correspond au script delete_instance.sh :
delete_instance.sh Nom_Instance,
où :
Ce script permet de supprimer la désignation de démarrage automatique d'un agent d'adaptateur faisant actuellement l'objet d'un démarrage automatique avec une instance de serveur. Il permet également d'éditer un travail de démarrage automatique associé à l'instance d'InterChange Server et de supprimer les instructions chargées de soumettre le travail de l'agent d'adaptateur.
La syntaxe ci-dessous correspond au script remove_autostart_adapter.sh :
remove_autostart_adapter.sh Nom_Adaptateur Nom_Instance,
où :
Ce script permet de supprimer la désignation de démarrage automatique d'une instance d'InterChange Server, ainsi que de supprimer du sous-système QWBISVR44 le travail de démarrage automatique associé à l'instance d'InterChange Server.
La syntaxe ci-dessous correspond au script remove_autostart_adapter.sh :
remove_autostart_server.sh Nom_Instance,
où :
Ce script définit le mode d'InterChange Server. Il applique le nouveau mode (design, production, testOn ou testOff) au prochain démarrage d'InterChange Server.
La syntaxe ci-dessous correspond au script set_ics_server_mode.sh :
set_ics_server_mode.sh Nom_Instance mode,
où :
Ce script permet d'arrêter InterChange Server avec dégradation progressive à partir d'un programme CL ou d'une entrée de commande sur i5/OS ; il équivaut à une commande d'arrêt avec dégradation progressive émise par System Manager ou System Monitor.
La syntaxe ci-dessous correspond au script stop_server_gracefully.sh :
stop_server_gracefully.sh Nom_Instance,
où :
Ce script permet d'arrêter un travail d'agent d'adaptateur avec dégradation progressive lorsqu'il n'est pas pratique d'utiliser System Manager ou System Monitor.
La syntaxe ci-dessous correspond au script stop_adapter.sh :
stop_adapter.sh Nom_Instance Nom_Adaptateur,
où :
L'exemple suivant correspond à l'adaptateur JText :
stop_adapter.sh QWBIDFT44 JText
Ce script permet de soumettre un travail d'agent d'adaptateur pour qu'il s'exécute dans le sous-système QWBISVR44. Vous devez démarrer le sous-sytème QWBISVR44 avant d'utiliser cette commande.
La syntaxe ci-dessous correspond au script submit_adapter.sh :
submit_adapter.sh adapterName instanceName startScript jobDescription [parm5] [parm6] [parm7],
où :
L'exemple suivant correspond à l'adaptateur JText :
submit_adapter.sh JText QWBIDFT44 /QIBM/UserData/WBIServer44/QWBIDFT44/connectors/JText/start_JText.sh QWBIJTEXTC -c/ QIBM/UserData/WBIServer44/QWBIDFT44/connectors/JText/JText.cfg
Ce script permet de soumettre un travail d'instance d'InterChange Server pour qu'il s'exécute dans le sous-système QWBISVR44, en fournissant la logique nécessaire à l'exécution d'un travail par lots à l'aide du script start_server.sh. Ce script inclut les paramètres facultatifs 2 à 6, qui permettent de transmettre des paramètres au script start_server.sh.
La syntaxe ci-dessous correspond au script submit_ics_server.sh :
submit_ics_server.sh Nom_Instance [parm2] [parm3] [parm4] [parm5] [parm6],
où :
Ce script permet de soumettre le travail du serveur de noms pour qu'il s'exécute dans le sous-système QWBISVR44.
Ce script permet de soumettre un travail d'agent ODA (Object Discovery Agent) pour qu'il s'exécute dans le sous-système QWBISVR44, en fournissant la logique nécessaire à la soumission d'un travail dans le sous-système QWBISVR44 en vue d'exécuter le nom de script transmis en tant que paramètre 1.
La syntaxe ci-dessous correspond au script submit_oda.sh :
submit_oda.sh scriptDémarrageODA Description_Travail,
où :
L'exemple suivant correspond à l'agent ODA JDBC :
submit_oda.sh /QIBM/ProdData/WBIServer44/product/oda/JDBC/start_JDBCODA.sh QWBIJDBODA
Pour des raisons de sécurité, il peut être nécessaire de changer le profil utilisateur sous lequel les processus de l'agent d'adaptateur s'exécutent, par exemple, les droits d'accès à la base de données JDBC ou les répertoires et fichiers JText. La modification du profil utilisateur interdit au profil utilisateur QWBISVR44 d'accéder à ces processus d'adaptateur.
Pour modifier le profil utilisateur, procédez comme suit :
Lorsque vous arrêtez le sous-système à l'aide d'i5/Os, le code inclut un gestionnaire de fonctions sigaction qui contrôle l'action ENDSBS *CNTRLD. Ce gestionnaire permet au sous-système QWBISVR44 de s'arrêter de façon contrôlée en arrêtant InterChange Server avec dégradation progressive, ainsi que tous les travaux ou adaptateurs en cours d'exécution sur le système local. Une fois ce processus terminé, le gestionnaire s'arrête automatiquement.