![[z/OS]](../images/ngzos.gif)
Adaptateurs locaux optimisés pour les API z/OS
Les adaptateurs locaux optimisés de WebSphere Application Server for z/OS sont pris en charge par un ensemble de services d'appels en langage natif z/OS ou par des interfaces de programmation d'application (API) et l'architecture JCA (Java™ EE Connector Architecture).
- COBOL
- C/C++
- PL/I
- Assembleur de haut niveau
Un appelant en cours d'exécution dans AMODE 64 peut utiliser les versions AMODE 31 des API, à condition que la liste de paramètres soit disponible sous la barre et qu'elle transmette des paramètres en utilisant les conventions 31 bits (chaque pointeur de paramètre est une adresse 31 bits). Les appelants s'exécutant en 64 bits doivent être au format C, C++ ou assembler et s'exécuter en mode d'adressage 64 bits. Lors de l'utilisation de scripts 64 bits BBGA1* à partir d'applications d'assembleur, une zone de sauvegarde 64 bits, de format 4 ou F4SA est requise. Cet élément est utilisé par les modules de remplacement des adaptateurs locaux optimisés pour sauvegarder et restaurer les registres de l'appelant. Lors de l'appel à partir de C ou de C++, l'en-tête exemple dans <racine_FS_Prod>/util/zos/OLASamples/bboaapi.h définit les API 64 bits en tant qu'élément OS_NOSTACK externe, ce qui garantit qu'elles sont appelées avec les conditions de zone de sauvegarde et de liaison appropriées.
Lorsque le terme connexion locale est utilisé dans cette documentation API, il s'agit d'une référence à une liaison intermémoire créée pour la communication entre un espace d'adresse externe sur le système z/OS et WebSphere Application Server sur le même système z/OS. L'espace adresse client doit s'exécuter sur la même image z/OS. L'API des adaptateurs gère ces connexions locales dans des pools associés individuellement à chaque programme appelant enregistré. Le nom d'enregistrement de 12 caractères peut être utilisé pour un seul groupe de pools de connexions par espace d'adresse. Il n'y a pas de limite au nombre d'enregistrements individuels dans un même espace d'adressage. Ce nombre est uniquement limité par la quantité de mémoire disponible.
- Register - BBOA1REG/BBGA1REG
- Unregister - BBOA1URG/BBGA1URG
- Connection Get - BBOA1CNG/BBGA1CNG
- Connection Release - BBOA1CNR/BBGA1CNR
- Send Request - BBOA1SRQ/BBGA1SRQ
- Send Response - BBOA1SRP/BBGA1SRP
- Send Response Exception - BBOA1SRX/BBGA1SRX
- Receive Request Any - BBOA1RCA/BBGA1RCA
- Receive Request Specific - BBOA1RCS/BBGA1RCS
- Receive Response Length - BBOA1RCL/BBGA1RCL
- Get Message Data - BBOA1GET/BBGA1GET
- Invoke - BBOA1INV/BBGA1INV
- Host Service - BBOA1SRV/BBGA1SRV
- API de l'adaptateur JCA
Register
Les API BBOA1REG (pour les appelants 31 bits) et BBGA1REG (pour les appelants 64 bits) vous permettent de vous enregistrer dans une instance locale de WebSphere Application Server for z/OS pour accéder au serveur et au groupe de démons. Les API BBOA1REG et BBGA1REG demandent d'affecter et d'enregistrer un groupe de connexions optimisées avec un serveur et un groupe de démons d'une instance locale de WebSphere Application Server sous le nom spécifié par le paramètre "registername".
API | Syntaxe |
---|---|
BBOA1REG ou BBGA1REG | BBOA1REG ( daemongroupname , nodename , servername , registername , minconn , maxconn , registerflags , rc, rsn ) BBGA1REG ( daemongroupname , nodename , servername , registername , minconn , maxconn , registerflags , rc, rsn ) |
Paramètres
daemongroupname (entrée)Variable ou constante qui contient le nom du groupe de démons WebSphere Application Server for z/OS à contacter. Le nom de groupe de démons doit être identique au nom abrégé de la cellule, et non au nom de travail de démon.
Cette constante ou variable d'entrée doit être une chaîne de 8 caractères se terminant par une valeur null, et doit être transmise par référence. Le démon WebSphere Application Server pour z/OS doit être démarré et initialisé sur le système local.
nodename (entrée)Variable ou constante qui contient le nom du noeud (nom abrégé) WebSphere Application Server for z/OS à contacter. La valeur variable ou constante doit être transmise par référence. Le serveur WebSphere Application Server for z/OS doit être actif et initialisé sur le système local. Il s'agit obligatoirement d'une chaîne de remplissage de 8 caractères.
servername (entrée)Variable ou constante qui contient le nom du serveur (nom abrégé) WebSphere Application Server for z/OS à contacter. La valeur variable ou constante doit être transmise par référence. Le serveur WebSphere Application Server for z/OS doit être actif et initialisé sur le système local. Il s'agit obligatoirement d'une chaîne de remplissage de 8 caractères.
registername (entrée)Variable ou constante qui contient le nom utilisé pour enregistrer le groupe de connexions locales. Les appels suivants demandent ce nom pour identifier le pool de connexions à utiliser. Il s'agit obligatoirement d'une chaîne de remplissage d'exactement 12 caractères et qui ne doit pas être utilisée dans l'espace d'adressage en cours.
minconn (entrée)Entier qui indique le nombre maximum de connexions à affecter au moment de l'enregistrement. L'adaptateur essaie de porter le pool de connexions locales à cette valeur pendant une requête Connection Get quand le nombre minimum de connexions est déjà atteint.
registerflags (entrée)- reg_flag_trans - bit 30
Contient 1 si la reprise transactionnelle doit être prise en charge via des connexions sous cet enregistrement, ou 0 (zéro) si la reprise transactionnelle n'est pas prise en charge.
Si le paramètre transactionnel est activé, l'API de l'adaptateur essaie de s'enregistrer sur le service RRS (Resource Recovery Services) de z/OS et une transaction globale prenant en charge la validation à deux phases est créée entre WebSphere Application Server et l'environnement de l'utilisateur de l'API.
Depuis la version 8.5.0.2, en cas d'exécution dans une région dépendante d'IMS et si vous associez cet indicateur à la valeur 1, vous garantissez l'exécution de votre environnement IMS avec RRS=YES, et que la variable d'environnement au niveau du serveur ou du noeud ola_rrs_context_propagate a été ajoutée à votre configuration et associée à la valeur true (ou 1). Sous IMS, le contexte RRS est appliqué sur l'unité d'exécution lorsque l'appel de l'API WOLA Invoke ou Send Request est propagé et vérifié dans le conteneur d'EJB WebSphere Application Server pour z/OS.
Eviter les incidents: Si vous avez besoin d'ajouter la variable ola_rrs_context_propagate à vos paramètres de configuration ou si vous devez changer le paramètre de cette variable et définir la valeur true, vous devez redémarrer votre serveur après avoir modifié la configuration. gotcha
- reg_flag_W2Cprop - 31 bits ou 64 bits
Le paramètre reg_flag_W2Cprop contrôle la propagation des paramètres de sécurité des transactions sortantes entre WebSphere Application Server et CICS.
- reg_flag_C2Wprop - bit 29Propage l'identité de la tâche appelante entre CICS etWebSphere Application Server. Pour les transactions entrantes de CICS vers WebSphere Application Server, l'indicateur d'enregistrement reg_flag_C2Wprop contrôle la manière dont l'identité est déterminée. Quand ce bit est activé, l'identité de la tâche de l'application CICS est utilisée dans le processus d'autorisation du serveur WebSphere Application Server. Quand il est désactivé, l'identité utilisée est celle de la région du service CICS.Avertissement : Vous devez activer WebSphere Application Server pour que la sécurité au niveau de l'application CICS soit demandée. Affectez à la variable d'environnement WebSphere, ola_cicsuser_identity_propagate, la valeur 1 via la console d'administration pour définir ce type de propagation de sécurité.
- reg_flag_trcmod - bit 0
Définissez l'indicateur reg_flag_trcmod si vous voulez modifier les paramètres de trace de l'adaptateur local optimisé pour l'enregistrement requis. Si vous ne définissez pas cet indicateur, aucune modification n'est apportée au paramètre de trace, et les paramètres par défaut du système ou les paramètres de trace prédéfinis qui s'appliquent au nom d'enregistrement ou au nom du travail sont utilisés.
- reg_flag_trcmore - bit 1 et reg_flag_trcsome -
bit 2
Lorsque la valeur 1 est affectée à reg_flag_trcmod, définissez reg_flag_trcmore ou reg_flag_trcsome pour indiquer un paramètre de trace afin d'obtenir une fonction de trace détaillée ou générale pour l'enregistrement. Si vous laissez la valeur "off" pour les deux avec reg_flag_trcmod affecté de la valeur 1, vous forcez la désactivation de la trace pour l'enregistrement, quelles que soient les prédéfinitions ou valeurs par défauts définies.
Code retour représenté par un entier qui indique la réussite ou l'échec de cet appel.
rsn (sortie)Code raison représenté par un entier qui indique la raison de l'échec de cet appel.
- Vérifiez que le serveur et le groupe de démons WebSphere Application Server for z/OS spécifiés dans cet appel sont démarrés et que la prise en charge des adaptateurs locaux est activée.
- Le nombre minimum de connexions demandées est comparé au nombre maximum de connexions du serveur (que vous configurez avec la console d'administration de WebSphere
Application Server). La valeur de connexion minimale (minconn) 3 implique que trois connexions sont réservées au cours de l'appel de registre. Si plus de trois connexions sont demandées à un même moment, le pool de connexions peut être porté au nombre maximum de connexions défini par l'indicateur maxconn. Quand le total des connexions à un serveur atteint le
maximum autorisé, toutes les autres requêtes Connection
Get de l'API adressées à ce serveur sont rejetées, même si la valeur de maxconn n'est pas encore atteinte.
Important : Soyez toujours prudent lorsque vous définissez le nombre minimum de connexions. Sauf cas particuliers, les grandes valeurs sont déconseillées car les ressources de la région de contrôle de WebSphere Application Server sont réservées pour chaque connexion.
- Plusieurs appels à l'API de registre peuvent être exécutés dans la même tâche d'espace d'adresse, d'unité d'exécution et de système de contrôle (CICS) (Customer Information Control System ), mais ils ne peuvent pas partager le même nom de registre. Le nom d'enregistrement, doit être unique.
- Si vous affectez au paramètres transactionnel la valeur 1, toutes les connexions de l'enregistrement sont exécutées avec la transactionnalité. Cela signifie que le service RRS est associé à partir de l'espace d'adressage actif. Voir la section Propagation des transactions pour plus d'informations sur les conditions et la configuration associées. La transactionnalité est prise en charge uniquement entre WebSphere Application Server et CICS. Les demandes transactional(1) depuis les autres environnements génèrent un avertissement au cours de l'appel d'enregistrement, sans tenir compte de l'indicateur et le traitement continue.
- Utilisez l'appel de l'API Unregister pour annuler cet enregistrement et libérer le pool de connexions associé.
- Quand l'espace d'adressage qui émet un appel d'enregistrement prend fin, l'enregistrement se termine automatiquement et les connexions sont libérées.
Code retour | Code motif | Description | Action |
---|---|---|---|
0 | - | Réussi | |
4 | - | Avertissement - voir le code raison | |
4 | La valeur 1 a été affectée à l'indicateur d'enregistrement transactionnel dans un environnement dont l'adaptateur ne prend pas en charge les transactions globales. | Ce paramètre est ignoré et le traitement continue. | |
8 | - | Erreur - voir le code raison | |
8 | Le jeton du nom d'enregistrement existe déjà. | Vous devez désenregistrer ce nom avant d'appeler l'API Register pour l'enregistrer. | |
10 | Le nombre maximum de connexions indiqué dépasse le nombre maximum de connexions autorisé pour un même enregistrement. | La requête de l'API Register est rejetée. Vérifiez que le nombre maximum d'adaptateurs locaux optimisés du serveur cible est suffisant pour autoriser cette requête et toutes les autres. Pour plus d'informations sur la variable d'environnement WAS_DAEMON_ONLY_adapter_max_conn, voir la rubrique Propriétés des adaptateurs locaux optimisés et la rubrique Activation de l'environnement du serveur pour utiliser des adaptateurs locaux optimisés. | |
12 | Le nombre minimum de connexions indiqué est supérieur au nombre maximum autorisé. | Indiquez un nombre minimum de connexions inférieur ou égal au nombre maximum défini. | |
14 | La mémoire partagée disponible est insuffisante pour créer cet enregistrement. | Augmentez la quantité de mémoire partagée affectée à l'adaptateur local optimisé ou émettez des appels de désenregistrement pour réduire la consommation des ressources. | |
21 | Une erreur s'est produite lors d'une tentative de connexion avec l'instance locale de WebSphere Application Server. | Si vous avez affecté la valeur 1 à reg_flag_C2Wprop (bit 29), vérifiez que la variable d'environnement WebSphere ola_cicsuser_identity_propagate a aussi la valeur 1. | |
25 | Impossible d'initialiser le gestionnaire de transactions. | Si vous avez besoin d'aide, prenez contact avec le service d'assistance IBM®. | |
70 | La mémoire partagée disponible est insuffisante pour créer une connexion. | Augmentez la quantité de mémoire partagée affectée à l'adaptateur local optimisé. | |
74 | Le nom d'enregistrement saisi contient une valeur NULL. | Remplissez le nom d'enregistrement avant de démarrer l'API Register. | |
12 | 4 | Une erreur s'est produite pendant la recherche du module BBOACALL. | Vérifiez que le jeu de données contenant le module WebSphere Application Server BBOACALL est disponible dans STEPLIB, LNKLST. |
10 | Impossible de localiser le groupe de démons WebSphere Application Server sélectionné. | Vérifiez que le serveur cible et le démon WebSphere Application Server sont démarrés et que la prise en charge des adaptateurs locaux optimisés est activée, puis recommencez. | |
14 | L'ID utilisateur n'est pas autorisé pour le WebSphere Application Server demandé. | Vérifiez que cet ID utilisateur est autorisé pour la classe CBIND SAF de cette instance de WebSphere Application Server. | |
16 | Le nom de noeud ou de serveur indiqué est introuvable. | Vérifiez que le nom de noeud et/ou le nom de serveur indiqués sont valides et que le serveur est actif. | |
23 | Une erreur s'est produite pendant la définition du nom du jeton. | Si vous avez besoin d'aide, prenez contact avec le service d'assistance IBM. | |
24 | Une erreur s'est produite pendant l'établissement de la connexion locale initiale avec WebSphere Application Server. | Consultez les fichiers journaux de la région de WebSphere Application Server pour plus d'informations sur l'appel de connexion de la communication locale. | |
28 | L'enregistrement identifié par ce nom est incorrect. | Le nom d'enregistrement indiqué est déjà utilisé mais le RGE est absent. Contactez le support IBM pour signaler cet incident. Pour tenter de résoudre ce problème, appelez l'API Unregister puis essayez de rappeler l'API Register. | |
30 | Le groupe de démons ne s'exécute pas avec la propriété WAS_DAEMON_ONLY_enable_adapter définie sur 1. | Ajoutez la variable WAS_DAEMON_ONLY_enable_adapter=1 avec la console d'administration de WebSphere Application Server. | |
34 | Un module de remplacement d'API 64 bits a été utilisé dans un environnement IMS. | Les API 64 bits ne sont pas prises en charge sous IMS. | |
38 | Un module de remplacement d'API 64 bits a été utilisé dans un environnement CICS. | Les API 64 bits ne sont pas prises en charge sous CICS. | |
68 | Une tentative de connexion à la mémoire partagée a échoué. | Si vous avez besoin d'aide, prenez contact avec le service d'assistance IBM. | |
86 | L'élément BGVT principal de WebSphere Application Server for z/OS n'a pas été trouvé | WebSphere n'a pas encore été démarré sur l'image du système z/OS en cours. Vérifiez que le démon et qu'un noeud/serveur sont démarrés avant de démarrer des processus client des adaptateurs locaux optimisés WebSphere Application Server. | |
88 | La table de modules de remplacement du client principal WebSphere Application Server for z/OS n'a pas été trouvée. | Un serveur WebSphere Application Server a été démarré sur l'image système z/OS en cours mais il n'est pas en cours d'exécution au niveau où la table de modules de remplacement client des adaptateurs locaux optimisés est prise en charge. Il est possible que vous utilisiez une interface de module de remplacement d'adaptateurs locaux optimisés WebSphere Application Server Version 8.0.0.1 qui n'est pas compatible avec le niveau de maintenance du serveur d'applications. Pour utiliser les modules de remplacement des adaptateurs locaux optimisés V8.0.0.1, le serveur d'applications doit également être en cours d'exécution au niveau WebSphere Application Server Version 8.0.0 . Vérifiez que votre application est en cours d'exécution au niveau des modules de remplacement des adaptateurs locaux optimisés compatibles avec WebSphere Application Server sur ce système z/OS. | |
90 | L'emplacement de la table principale de modules de remplacement client des adaptateurs locaux optimisés WebSphere Application Server for z/OS n'a pas été trouvé. | Un serveur WebSphere Application Server a été démarré sur l'image système z/OS en cours mais il n'est pas en cours d'exécution au niveau où la table de modules de remplacement client des adaptateurs locaux optimisés est prise en charge. Il est possible que vous utilisiez une interface de module de remplacement d'adaptateurs locaux optimisés WebSphere Application Server Version 8.0.0.1 qui n'est pas compatible avec le niveau de maintenance du serveur d'applications. Pour utiliser les modules de remplacement des adaptateurs locaux optimisés V8.0.0.1, le serveur d'applications doit également être en cours d'exécution au niveau WebSphere Application Server Version 8.0.0 . Vérifiez que votre application est en cours d'exécution au niveau des modules de remplacement des adaptateurs locaux optimisés compatibles avec WebSphere Application Server sur ce système z/OS. |
Unregister
Vous devez utiliser les API BBOA1URG (pour les appelants 31 bits) et BBGA1URG (pour les appelants 64 bits) pour vous désenregistrer sur le serveur et le groupe de démons de l'instance locale de WebSphere Application Server for z/OS.API | Syntaxe |
---|---|
BBOA1URG ou BBGA1URG | BBOA1URG (registername, unregflags, rc, rsn) BBGA1URG (registername, unregflags, rc, rsn) |
Paramètres :
registername (entrée)Variable ou constante qui contient le nom utilisé pour désenregistrer le groupe de connexions locales. Cette chaîne doit obligatoirement compter 12 caractères de remplissage et être identique à celle utilisée dans l'API BBOA1REG.
unregisterflags (entrée)- Reserved - bit 0-30
- Force (0|1) - 31 bits ou 64 bits
Contient 1 si la requête de désenregistrement doit être forcée. Par défaut, une requête de désenregistrement s'exécute quand toutes les connexions sont revenues dans leur pool de connexions d'origine. Si toutes les connexions ne sont pas revenues dans le pool, un avertissement est envoyé à l'appelant. Le processus d'annulation d'enregistrement est terminé lorsque la dernière connexion a été replacée dans le pool. Une seconde demande d'annulation d'enregistrement peut être effectuée avec le bit de forcement affecté de la valeur 1 qui force le processus d'annulation d'enregistrement à se terminer. Dans ce cas, tous les descripteurs de connexions restants de l'enregistrement sont invalidés.
Code retour représenté par un entier qui indique la réussite ou l'échec de cet appel.
rsn (sortie)Code raison représenté par un entier qui indique la raison de l'échec de cet appel.
- Vérifiez que le serveur et le groupe de démons WebSphere Application Server for z/OS spécifiés dans cet appel sont démarrés et que la prise en charge des adaptateurs locaux est activée.
- Si vous n'appelez pas l'API Unregister et que l'espace d'adressage à l'origine de l'appel d'enregistrement prend fin, un appel de désenregistrement s'exécute automatiquement et les connexions sont libérées.
- Tous les descripteurs de connexion liés à cet enregistrement et qui sont actifs quand l'appel de désenregistrement survient peuvent rester valides jusqu'à ce que les connexions soient renvoyées au pool de connexions par l'API BBOA1CNR. Pour forcer le nettoyage des descripteurs de connexion, un deuxième appel de désenregistrement assorti de l'indicateur force est nécessaire. Cet appel invalide tous les descripteurs de connexion restants.
Code retour | Code motif | Description | Action |
---|---|---|---|
0 | - | Réussi | |
4 | - | Avertissement - voir le code raison | |
66 | L'appel de désenregistrement est différé jusqu'à ce que toutes les connexions reviennent au pool. | Le désenregistrement a lieu quand la dernière connexion revient au pool de connexions. | |
8 | - | Erreur - voir le code raison | |
8 | Le nom du jeton d'enregistrement spécifié n'existe pas. | Vous devez enregistrer ce nom avant d'appeler l'API Unregister. | |
64 | Vous ne pouvez pas spécifier l'option force avant d'exécuter un désenregistrement normal. | Appelez l'API Unregister sans indiquer l'option force. | |
76 | Une tentative de connexion au serveur a échoué car ce serveur n'est plus actif. | Démarrez le serveur et tentez à nouveau d'établir la communication. | |
82 | Une tentative de désenregistrement de cet enregistrement a déjà été effectuée. | Attendez la fin de l'exécution de la demande de désenregistrement précédente ou réexécutez ce désenregistrement avec l'option force . | |
96 | Cette API ne peut pas être gérée lors de l'initialisation du système IMS (Information Management System) ou lors d'un exit de préinitialisation IMS. | Appelez cette API une fois l'initialisation d'IMS terminée. | |
12 | 34 | Un module de remplacement d'API 64 bits a été utilisé dans un environnement IMS. | Les API 64 bits ne sont pas prises en charge sous IMS. |
38 | Un module de remplacement d'API 64 bits a été utilisé dans un environnement CICS. | Les API 64 bits ne sont pas prises en charge sous CICS. | |
86 | L'élément BGVT principal de WebSphere Application Server for z/OS n'a pas été trouvé | WebSphere n'a pas encore été démarré sur l'image du système z/OS en cours. Vérifiez que le démon et qu'un noeud/serveur sont démarrés avant de démarrer des processus client des adaptateurs locaux optimisés WebSphere Application Server. | |
88 | La table de modules de remplacement du client principal WebSphere Application Server for z/OS n'a pas été trouvée. | Un serveur WebSphere Application Server a été démarré sur l'image système z/OS en cours mais il n'est pas en cours d'exécution au niveau où la table de modules de remplacement client des adaptateurs locaux optimisés est prise en charge. Il est possible que vous utilisiez une interface de module de remplacement d'adaptateurs locaux optimisés WebSphere Application Server Version 8.0.0.1 qui n'est pas compatible avec le niveau de maintenance du serveur d'applications. Pour utiliser les modules de remplacement des adaptateurs locaux optimisés V8.0.0.1, le serveur d'applications doit également être en cours d'exécution au niveau WebSphere Application Server Version 8.0.0 . Vérifiez que votre application est en cours d'exécution au niveau des modules de remplacement des adaptateurs locaux optimisés compatibles avec WebSphere Application Server sur ce système z/OS. | |
90 | L'emplacement de la table principale de modules de remplacement client des adaptateurs locaux optimisés WebSphere Application Server for z/OS n'a pas été trouvé. | Un serveur WebSphere Application Server a été démarré sur l'image système z/OS en cours mais il n'est pas en cours d'exécution au niveau où la table de modules de remplacement client des adaptateurs locaux optimisés est prise en charge. Il est possible que vous utilisiez une interface de module de remplacement d'adaptateurs locaux optimisés WebSphere Application Server Version 8.0.0.1 qui n'est pas compatible avec le niveau de maintenance du serveur d'applications. Pour utiliser les modules de remplacement des adaptateurs locaux optimisés V8.0.0.1, le serveur d'applications doit également être en cours d'exécution au niveau WebSphere Application Server Version 8.0.0 . Vérifiez que votre application est en cours d'exécution au niveau des modules de remplacement des adaptateurs locaux optimisés compatibles avec WebSphere Application Server sur ce système z/OS. |
Connection Get
Cette API demande de fournir une connexion disponible depuis le pool de connexions créé avec le nom d'enregistrement sélectionné.API | Syntaxe |
---|---|
BBOA1CNG ou BBGA1CNG | BBOA1CNG ( registername, connectionhandle, waittime, rc, rsn ) BBGA1CNG ( registername, connectionhandle, waittime, rc, rsn ) |
Paramètres :
registername (entrée)Variable ou constante qui contient le nom à utiliser pour rechercher le pool de connexions dont vous voulez extraire une connexion. Il s'agit obligatoirement d'une chaîne de remplissage de 12 caractères.
connectionhandle (sortie)Descripteur de connexion de 12 octets qui doit être envoyé sur les demandes suivantes pour les actions sur cette connexion.
waittime (entrée)Entier qui indique le délai d'attente (en secondes) d'une connexion avant l'envoi d'un code raison indiquant l'indisponibilité de la connexion demandée. La valeur 0 implique qu'il n'existe pas de délai d'attente et que l'API attend indéfiniment.
rc (sortie)Code retour représenté par un entier qui indique la réussite ou l'échec de cet appel.
rsn (sortie)Code raison représenté par un entier qui indique la raison de l'échec de cet appel.
- Vérifiez que le serveur et le groupe de démons WebSphere Application Server for z/OS spécifiés dans cet appel sont démarrés et que la prise en charge des adaptateurs locaux est activée.
- Vérifiez qu'un appel d'enregistrement (BBOA1REG) a réussi dans l'espace d'adressage actif avec un nom correspondant avant d'utiliser l'API Connection Get.
Code retour | Code motif | Description | Action |
---|---|---|---|
0 | - | Réussi | |
4 | - | Avertissement - voir le code raison | |
8 | - | Erreur - voir le code raison | |
8 | Le jeton du nom d'enregistrement n'existe pas. | Vérifiez que vous avez enregistré ce nom avant de l'appeler avec l'API Connection Get. | |
10 | La connexion demandée est indisponible. Le délai d'attente est arrivé à expiration avant l'établissement de la connexion demandée. | Le mode opératoire de l'application varie selon les cas. Attendez puis recommencez, ou abandonnez cette connexion. Vous pouvez également augmenter le nombre maximum de connexions dans l'appel de l'API Register. | |
24 | Après un appel d'enregistrement réussi, une erreur s'est produite pendant l'obtention d'une connexion à partir du pool de connexions. | Assurez-vous que le serveur est démarré. S'il ne fonctionne pas, redémarrez le serveur puis exécutez à nouveau la requête de l'API. | |
28 | L'enregistrement a été trouvé mais il est inactif. | ||
96 | Cette API ne peut pas être gérée lors de l'initialisation d'IMS ou lors d'un exit de préinitialisation IMS. | Appelez cette API une fois l'initialisation d'IMS terminée. | |
12 | 10 | Impossible de localiser le groupe de démons ou le serveur WebSphere Application Server. | Vérifiez que le serveur et le démon WebSphere Application Server sont démarrés et que la prise en charge des connexions locales est activée, puis recommencez. |
34 | Un module de remplacement d'API 64 bits a été utilisé dans un environnement IMS. | Les API 64 bits ne sont pas prises en charge sous IMS. | |
38 | Un module de remplacement d'API 64 bits a été utilisé dans un environnement CICS. | Les API 64 bits ne sont pas prises en charge sous CICS. | |
86 | L'élément BGVT principal de WebSphere Application Server for z/OS n'a pas été trouvé | WebSphere n'a pas encore été démarré sur l'image du système z/OS en cours. Vérifiez que le démon et qu'un noeud/serveur sont démarrés avant de démarrer des processus client des adaptateurs locaux optimisés WebSphere Application Server. | |
88 | La table de modules de remplacement du client principal WebSphere Application Server for z/OS n'a pas été trouvée. | Un serveur WebSphere Application Server a été démarré sur l'image système z/OS en cours mais il n'est pas en cours d'exécution au niveau où la table de modules de remplacement client des adaptateurs locaux optimisés est prise en charge. Il est possible que vous utilisiez une interface de module de remplacement d'adaptateurs locaux optimisés WebSphere Application Server Version 8.0.0.1 qui n'est pas compatible avec le niveau de maintenance du serveur d'applications. Pour utiliser les modules de remplacement des adaptateurs locaux optimisés V8.0.0.1, le serveur d'applications doit également être en cours d'exécution au niveau WebSphere Application Server Version 8.0.0 . Vérifiez que votre application est en cours d'exécution au niveau des modules de remplacement des adaptateurs locaux optimisés compatibles avec WebSphere Application Server sur ce système z/OS. | |
90 | L'emplacement de la table principale de modules de remplacement client des adaptateurs locaux optimisés WebSphere Application Server for z/OS n'a pas été trouvé. | Un serveur WebSphere Application Server a été démarré sur l'image système z/OS en cours mais il n'est pas en cours d'exécution au niveau où la table de modules de remplacement client des adaptateurs locaux optimisés est prise en charge. Il est possible que vous utilisiez une interface de module de remplacement d'adaptateurs locaux optimisés WebSphere Application Server Version 8.0.0.1 qui n'est pas compatible avec le niveau de maintenance du serveur d'applications. Pour utiliser les modules de remplacement des adaptateurs locaux optimisés V8.0.0.1, le serveur d'applications doit également être en cours d'exécution au niveau WebSphere Application Server Version 8.0.0 . Vérifiez que votre application est en cours d'exécution au niveau des modules de remplacement des adaptateurs locaux optimisés compatibles avec WebSphere Application Server sur ce système z/OS. |
Connection Release
L'API Connection Release demande de renvoyer une connexion à son pool d'origine afin d'être disponible pour une autre requête.API | Syntaxe |
---|---|
BBOA1CNR ou BBGA1CNR | BBOA1CNR ( connectionhandle, rc, rsn ) BBGA1CNR ( connectionhandle, rc, rsn ) |
Paramètres :
connectionhandle (entrée)Descripteur de connexion de 12 octets indiquant la connexion obtenue précédemment à replacer dans le pool de connexions.
rc (sortie)Code retour représenté par un entier qui indique la réussite ou l'échec de cet appel.
rsn (sortie)Code retour représenté par un entier qui indique la cause de l'échec de cet appel.
- Vérifiez que le serveur et le groupe de démons WebSphere Application Server for z/OS sont spécifiés dans cet appel et démarrés, et que la prise en charge des adaptateurs locaux est activée.
- Avant d'utiliser l'API Connection Release, vérifiez qu'un appel d'enregistrement (API BBOA1REG ou BBGA1REG) a réussi dans l'espace adresse actif avec un nom correspondant et qu'un appel Connection Get (BBOA1CNG ou BBGA1CNG) a permis d'obtenir la connexion que vous voulez maintenant libérer.
Code retour | Code motif | Description | Action |
---|---|---|---|
0 | - | Réussi | |
4 | - | Impossible de localiser le groupe de démons et le serveur WebSphere Application Server. Toutes les ressources associées à cette connexion ont été supprimées. | Aucun |
8 | - | Erreur - voir le code raison | |
36 | L'état de la connexion est incorrect. | Le descripteur de connexion utilisé pour cette requête a un état incorrect. Pour plus d'informations sur les états des connexions, reportez-vous à la documentation de l'API. | |
38 | Le descripteur de la connexion client est incorrect. | Le descripteur de connexion client utilisé pour cette requête est incorrect. Pour plus d'informations sur les descripteurs de connexion client, reportez-vous à la documentation de l'API. | |
96 | Cette API ne peut pas être gérée lors de l'initialisation d'IMS ou lors d'un exit de préinitialisation IMS. | Appelez cette API une fois l'initialisation d'IMS terminée. | |
12 | 14 | Impossible de localiser ou contrôler le vecteur d'appel de l'API utilisant le descripteur de connexion fourni. | Le descripteur de connexion est incorrect ou un appel de désenregistrement (API BBOA1URG) a invalidé le pool de connexions. |
34 | Un module de remplacement d'API 64 bits a été utilisé dans un environnement IMS. | Les API 64 bits ne sont pas prises en charge sous IMS. | |
38 | Un module de remplacement d'API 64 bits a été utilisé dans un environnement CICS. | Les API 64 bits ne sont pas prises en charge sous CICS. | |
86 | L'élément BGVT principal de WebSphere Application Server for z/OS n'a pas été trouvé | WebSphere n'a pas encore été démarré sur l'image du système z/OS en cours. Vérifiez que le démon et qu'un noeud/serveur sont démarrés avant de démarrer des processus client des adaptateurs locaux optimisés WebSphere Application Server. | |
88 | La table de modules de remplacement du client principal WebSphere Application Server for z/OS n'a pas été trouvée. | Un serveur WebSphere Application Server a été démarré sur l'image système z/OS en cours mais il n'est pas en cours d'exécution au niveau où la table de modules de remplacement client des adaptateurs locaux optimisés est prise en charge. Il est possible que vous utilisiez une interface de module de remplacement d'adaptateurs locaux optimisés WebSphere Application Server Version 8.0.0.1 qui n'est pas compatible avec le niveau de maintenance du serveur d'applications. Pour utiliser les modules de remplacement des adaptateurs locaux optimisés V8.0.0.1, le serveur d'applications doit également être en cours d'exécution au niveau WebSphere Application Server Version 8.0.0 . Vérifiez que votre application est en cours d'exécution au niveau des modules de remplacement des adaptateurs locaux optimisés compatibles avec WebSphere Application Server sur ce système z/OS. | |
90 | L'emplacement de la table principale de modules de remplacement client des adaptateurs locaux optimisés WebSphere Application Server for z/OS n'a pas été trouvé. | Un serveur WebSphere Application Server a été démarré sur l'image système z/OS en cours mais il n'est pas en cours d'exécution au niveau où la table de modules de remplacement client des adaptateurs locaux optimisés est prise en charge. Il est possible que vous utilisiez une interface de module de remplacement d'adaptateurs locaux optimisés WebSphere Application Server Version 8.0.0.1 qui n'est pas compatible avec le niveau de maintenance du serveur d'applications. Pour utiliser les modules de remplacement des adaptateurs locaux optimisés V8.0.0.1, le serveur d'applications doit également être en cours d'exécution au niveau WebSphere Application Server Version 8.0.0 . Vérifiez que votre application est en cours d'exécution au niveau des modules de remplacement des adaptateurs locaux optimisés compatibles avec WebSphere Application Server sur ce système z/OS. |
Send Request
Ces API permettent d'envoyer une requête à l'instance locale de WebSphere Application Server pour traitement.API | Syntaxe |
---|---|
BBOA1SRQ ou BBGA1SRQ | BBOA1SRQ ( connectionhandle, requesttype, requestservicename, requestservicenamel, requestdata, requestdatalen, async(0|1), responsedatalen, rc, rsn ) BBGA1SRQ ( connectionhandle, requesttype, requestservicename, requestservicenamel, requestdata, requestdatalen, async(0|1), responsedatalen, rc, rsn ) |
Paramètres :
connectionhandle (entrée)Descripteur de connexion de 12 octets qui doit être utilisé pour la demande.
requesttype (entrée)Entier contenant le type de demande qui indique le type de demande de travail à traiter. Les valeurs de type prises en charge sont les suivantes : 1 = demandes de travail EJB locales, 2 = demandes de travail EJB distantes.
requestservicename (entrée)Chaîne de caractères EBCDIC de 256 octets maximum qui indique le nom du service à appeler. Pour Type=1, EJB et Type 2, EJB distant, il s'agit du nom de l'interface Home JNDI de la cible.
requestservicenamel (entrée)Entier contenant la longueur du nom de service à démarrer ou 0 (zéro) si le nom de service se termine par null.
requestdata (entrée)Pointeur de 31 bits ou de 64 bits désignant l'adresse de départ des données de requête à envoyer.
requestdatalen (entrée)Valeur non signée de 32 bits en mode 31 bits ou valeur non signée de 64 bits en mode 64 bits qui indique la longueur des données à envoyer.
async(0|1) (entrée)Entier. La valeur 1 indique que l'appelant demande un retour de contrôle immédiat, même si la longueur de la réponse peut être encore inconnue. Pour async(0), l'unité en cours doit attendre la réponse de WebSphere Application Server et la longueur de la réponse est retournée dans l'argument de sortie responsedatalen.
responsedatalen (sortie)Valeur non signée 32 bits en mode 31 bits ou valeur non signée 64 bits en mode 64 bits qui contient la longueur de la réponse. Cette valeur peut ensuite être utilisée par l'appelant pour obtenir de la mémoire avant d'appeler l'API Get Data. Si l'indicateur async a la valeur 1, cela signifie que l'appelant désire reprendre le contrôle immédiatement. Cette valeur est définie pour toutes les connexions 0xFF si la réponse n'est pas encore reçue.
rc (sortie)Code retour représenté par un entier qui indique la réussite ou l'échec de cet appel.
rsn (sortie)Code raison représenté par un entier qui indique la raison de l'échec de cet appel.
- Vérifiez que le serveur et le groupe de démons WebSphere Application Server for z/OS spécifiés dans cet appel sont démarrés et que la prise en charge des adaptateurs locaux est activée.
- Vérifiez qu'un appel d'enregistrement (BBOA1REG) a réussi dans l'espace d'adressage actif avec un nom correspondant avant d'utiliser l'API Send Request.
Code retour | Code motif | Description | Action |
---|---|---|---|
0 | - | Réussi | |
4 | - | Avertissement - voir le code raison | |
8 | - | Erreur - voir le code raison | |
8 | Le jeton du nom d'enregistrement existe déjà. | Assurez-vous que le nom d'enregistrement communiqué est valide. | |
14 | Une insuffisance de mémoire s'est produite pendant la sauvegarde du message. | La mémoire disponible est insuffisante pour que l'API Send Request puisse traiter le message. L'espace d'adressage actif n'a plus de mémoire privée. | |
16 | La longueur du nom de service de la requête est incorrect. | Corrigez les données saisies et recommencez. | |
18 | La longueur de la requête dépasse les limites du système. | La taille du message dépasse les capacités de prise en charge des messages de WebSphere Application Server. Assurez-vous que la taille est valide. Si la taille est valide, vérifiez que le paramètre de taille de WebSphere Application Server autorise les messages de cette taille. | |
26 | Impossible de commencer le traitement de la transaction globale. | ||
32 | Le type de requête utilisé pour l'appel d'API est incorrect. | Le type de requête utilisé est incorrect. Corrigez les données saisies et recommencez l'appel. | |
34 | Le service cible est introuvable. | Vérifiez que l'application qui contient le bean enterprise cible est installée et démarrée sur le serveur cible pour WebSphere Application Server. | |
36 | L'état de la connexion est incorrect. | Le descripteur de connexion utilisé pour la requête a un état incorrect. Pour plus d'informations sur les états des connexions, reportez-vous à la documentation de l'API. | |
38 | Le descripteur de la connexion client est incorrect. | Le descripteur de connexion client utilisé pour la requête est incorrect. Pour plus d'informations sur les descripteurs de connexion client, reportez-vous à la documentation de l'API. | |
40 | Une erreur de transmission locale s'est produite. | Consultez le journal du serveur WebSphere Application Server pour rechercher les messages liés à une erreur de transmission locale. | |
44 | Une exception ou une condition inattendue s'est produite dans le bean enterprise cible. | Consultez les journaux de WebSphere Application Server pour rechercher les données liées à cette exception. | |
46 | Une erreur de communication locale s'est produite pendant l'appel de la requête. | Consultez les journaux de WebSphere Application Server pour rechercher la cause de cette erreur. | |
96 | Cette API ne peut pas être gérée lors de l'initialisation d'IMS ou lors d'un exit de préinitialisation IMS. | Appelez cette API une fois l'initialisation d'IMS terminée. | |
98 | Impossible d'accéder au début de la mémoire tampon de requête fournie. | Vérifiez que l'adresse et la longueur de la mémoire tampon de requête sont correctes. | |
100 | Impossible d'accéder à la fin de la mémoire tampon de requête fournie. | Vérifiez que l'adresse et la longueur de la mémoire tampon de requête sont correctes. | |
12 | 10 | Impossible de localiser le groupe de démons ou le serveur WebSphere Application Server. | Vérifiez que le serveur et le démon WebSphere Application Server sont démarrés et que la prise en charge des connexions locales est activée. Réessayez de localiser le groupe de démons et le serveur WebSphere Application Server. |
14 | Impossible de localiser ou contrôler le vecteur d'appel de l'API utilisant le descripteur de connexion fourni. | Le descripteur de connexion est incorrect ou un appel de désenregistrement (API BBOA1URG) a invalidé le pool de connexions. | |
34 | Un module de remplacement d'API 64 bits a été utilisé dans un environnement IMS. | Les API 64 bits ne sont pas prises en charge sous IMS. | |
38 | Un module de remplacement d'API 64 bits a été utilisé dans un environnement CICS. | Les API 64 bits ne sont pas prises en charge sous CICS. | |
86 | L'élément BGVT principal de WebSphere Application Server for z/OS n'a pas été trouvé | WebSphere n'a pas encore été démarré sur l'image du système z/OS en cours. Vérifiez que le démon et qu'un noeud/serveur sont démarrés avant de démarrer des processus client des adaptateurs locaux optimisés WebSphere Application Server. | |
88 | La table de modules de remplacement du client principal WebSphere Application Server for z/OS n'a pas été trouvée. | Un serveur WebSphere Application Server a été démarré sur l'image système z/OS en cours mais il n'est pas en cours d'exécution au niveau où la table de modules de remplacement client des adaptateurs locaux optimisés est prise en charge. Il est possible que vous utilisiez une interface de module de remplacement d'adaptateurs locaux optimisés WebSphere Application Server Version 8.0.0.1 qui n'est pas compatible avec le niveau de maintenance du serveur d'applications. Pour utiliser les modules de remplacement des adaptateurs locaux optimisés V8.0.0.1, le serveur d'applications doit également être en cours d'exécution au niveau WebSphere Application Server Version 8.0.0 . Vérifiez que votre application est en cours d'exécution au niveau des modules de remplacement des adaptateurs locaux optimisés compatibles avec WebSphere Application Server sur ce système z/OS. | |
90 | L'emplacement de la table principale de modules de remplacement client des adaptateurs locaux optimisés WebSphere Application Server for z/OS n'a pas été trouvé. | Un serveur WebSphere Application Server a été démarré sur l'image système z/OS en cours mais il n'est pas en cours d'exécution au niveau où la table de modules de remplacement client des adaptateurs locaux optimisés est prise en charge. Il est possible que vous utilisiez une interface de module de remplacement d'adaptateurs locaux optimisés WebSphere Application Server Version 8.0.0.1 qui n'est pas compatible avec le niveau de maintenance du serveur d'applications. Pour utiliser les modules de remplacement des adaptateurs locaux optimisés V8.0.0.1, le serveur d'applications doit également être en cours d'exécution au niveau WebSphere Application Server Version 8.0.0 . Vérifiez que votre application est en cours d'exécution au niveau des modules de remplacement des adaptateurs locaux optimisés compatibles avec WebSphere Application Server sur ce système z/OS. |
Send Response
Cette API renvoie une réponse à l'instance locale de WebSphere Application Server.API | Syntaxe |
---|---|
BBOA1SRP ou BBGA1SRP | BBOA1SRP ( connectionhandle, responsedata, responsedatalen, rc, rsn ) BBGA1SRP ( connectionhandle, responsedata, responsedatalen, rc, rsn ) |
Paramètres :
connectionhandle (entrée)Descripteur de connexion de 12 octets qui doit être utilisé pour la réponse.
responsedata (entrée)Pointeur de 31 bits ou de 64 bits désignant l'adresse de départ des données de réponse à envoyer.
responsedatalen (entrée)Valeur non signée de 32 bits en mode 31 bits ou valeur non signée de 64 bits en mode 64 bits qui indique la longueur des données à envoyer.
rc (sortie)Code retour représenté par un entier qui indique la réussite ou l'échec de cet appel.
rsn (sortie)Code raison représenté par un entier qui indique la raison de l'échec de cet appel.
- Vérifiez que le serveur et le groupe de démons WebSphere Application Server for z/OS spécifiés dans cet appel sont démarrés et que la prise en charge des adaptateurs locaux est activée.
- Vérifiez qu'un appel d'enregistrement (API BBOA1REG ou BBGA1REG) a réussi dans l'espace adresse actif avec un nom correspondant avant d'utiliser l'API Send Response.
- Vérifiez qu'un appel Connection Get (BBOA1CNG ou BBGA1CNG) a réussi et qu'un descripteur a été fourni en entrée pour cet appel.
- Vérifiez qu'un appel de l'API Receive Request Any, Receive Request Specific ou Host a été émis et renvoyé avec des données de requête pour le descripteur de connexion. L'état de la connexion doit permettre l'utilisation de l'API Send Response.
Code retour | Code motif | Description | Action |
---|---|---|---|
0 | - | Réussi | |
4 | - | Avertissement - voir le code raison | |
8 | - | Erreur - voir le code raison | |
8 | Le jeton du nom d'enregistrement existe déjà. | Assurez-vous que le nom d'enregistrement communiqué est valide. | |
14 | Une insuffisance de mémoire s'est produite pendant la sauvegarde du message. | La mémoire disponible est insuffisante pour que l'API Send Response puisse traiter le message. L'espace d'adressage actif n'a plus de mémoire privée. | |
18 | La longueur de la réponse dépasse les limites du système. | La taille du message dépasse les capacités de prise en charge des messages de WebSphere Application Server. Assurez-vous que la taille est valide. Si la taille est valide, vérifiez que le paramètre de taille de WebSphere Application Server autorise les messages de cette taille. | |
34 | Le service cible est introuvable. | Vérifiez que l'application qui contient le bean EJB cible est installée et démarrée sur l'instance cible de WebSphere Application Server. | |
36 | L'état de la connexion est incorrect. | Le descripteur de connexion utilisé pour cette requête a un état incorrect. Pour plus d'informations sur les états des connexions, reportez-vous à la documentation de l'API. | |
38 | Le descripteur de la connexion client est incorrect. | Le descripteur de connexion client utilisé pour cette requête est incorrect. Pour plus d'informations sur les descripteurs de connexion client, reportez-vous à la documentation de l'API. | |
40 | Une erreur de transmission locale s'est produite. | Consultez le journal du serveur WebSphere Application Server pour rechercher les messages liés à une erreur de transmission locale. | |
46 | Une erreur de communication locale s'est produite pendant l'appel de la requête. | Consultez les journaux de WebSphere Application Server pour rechercher la cause de cette erreur. | |
96 | Cette API ne peut pas être gérée lors de l'initialisation d'IMS ou lors d'un exit de préinitialisation IMS. | Appelez cette API une fois l'initialisation d'IMS terminée. | |
102 | Impossible d'accéder au début de la mémoire tampon de réponse fournie. | Vérifiez que l'adresse et la longueur de la mémoire tampon de réponse sont correctes. | |
104 | Impossible d'accéder à la fin de la mémoire tampon de réponse fournie. | Vérifiez que l'adresse et la longueur de la mémoire tampon de réponse sont correctes. | |
12 | 10 | Impossible de localiser le groupe de démons ou le serveur WebSphere Application Server. | Vérifiez que le serveur et le démon WebSphere Application Server sont démarrés et que la prise en charge des connexions locales est activée puis recommencez. |
14 | Impossible de localiser ou contrôler le vecteur d'appel de l'API utilisant le descripteur de connexion fourni. | Le descripteur de connexion est incorrect ou un appel de désenregistrement (BBOA1URG) a invalidé le pool de connexions. | |
34 | Un module de remplacement d'API 64 bits a été utilisé dans un environnement IMS. | Les API 64 bits ne sont pas prises en charge sous IMS. | |
38 | Un module de remplacement d'API 64 bits a été utilisé dans un environnement CICS. | Les API 64 bits ne sont pas prises en charge sous CICS. | |
86 | L'élément BGVT principal de WebSphere Application Server for z/OS n'a pas été trouvé | WebSphere n'a pas encore été démarré sur l'image du système z/OS en cours. Vérifiez que le démon et qu'un noeud/serveur sont démarrés avant de démarrer des processus client des adaptateurs locaux optimisés WebSphere Application Server. | |
88 | La table de modules de remplacement du client principal WebSphere Application Server for z/OS n'a pas été trouvée. | Un serveur WebSphere Application Server a été démarré sur l'image système z/OS en cours mais il n'est pas en cours d'exécution au niveau où la table de modules de remplacement client des adaptateurs locaux optimisés est prise en charge. Il est possible que vous utilisiez une interface de module de remplacement d'adaptateurs locaux optimisés WebSphere Application Server Version 8.0.0.1 qui n'est pas compatible avec le niveau de maintenance du serveur d'applications. Pour utiliser les modules de remplacement des adaptateurs locaux optimisés V8.0.0.1, le serveur d'applications doit également être en cours d'exécution au niveau WebSphere Application Server Version 8.0.0 . Vérifiez que votre application est en cours d'exécution au niveau des modules de remplacement des adaptateurs locaux optimisés compatibles avec WebSphere Application Server sur ce système z/OS. | |
90 | L'emplacement de la table principale de modules de remplacement client des adaptateurs locaux optimisés WebSphere Application Server for z/OS n'a pas été trouvé. | Un serveur WebSphere Application Server a été démarré sur l'image système z/OS en cours mais il n'est pas en cours d'exécution au niveau où la table de modules de remplacement client des adaptateurs locaux optimisés est prise en charge. Il est possible que vous utilisiez une interface de module de remplacement d'adaptateurs locaux optimisés WebSphere Application Server Version 8.0.0.1 qui n'est pas compatible avec le niveau de maintenance du serveur d'applications. Pour utiliser les modules de remplacement des adaptateurs locaux optimisés V8.0.0.1, le serveur d'applications doit également être en cours d'exécution au niveau WebSphere Application Server Version 8.0.0 . Vérifiez que votre application est en cours d'exécution au niveau des modules de remplacement des adaptateurs locaux optimisés compatibles avec WebSphere Application Server sur ce système z/OS. |
Send Response Exception
Cette API renvoie des données de réponse négative à l'appelant JCA dans l'instance locale de WebSphere Application Server. La réponse est une exception de type ResourceAdapterException accompagnée des données de réponse négative spécifiées.
API | Syntaxe |
---|---|
BBOA1SRX ou BBGA1SRX | BBOA1SRX ( connectionhandle, excresponsedata, exresponsedatalen, rc, rsn ) BBGA1SRX ( connectionhandle, excresponsedata, exresponsedatalen, rc, rsn ) |
Paramètres :
connectionhandle (entrée)Descripteur de connexion de 12 octets qui doit être utilisé pour la réponse.
excresponsedata (entrée)Pointeur de 31 bits ou de 64 bits désignant l'adresse de départ des données de réponse négative à envoyer.
excresponsedatalen (entrée)Spécifie une valeur non signée 32 bits en mode 31 bits ou une valeur non signée 64 bits en mode 64 bits indiquant la longueur des données de réponse de l'exception à envoyer. Les données de réponse négative sont une chaîne de caractères EBCDIC qui décrit l'erreur.
rc (sortie)Code retour représenté par un entier qui indique la réussite ou l'échec de cet appel.
rsn (sortie)Code raison représenté par un entier qui indique la raison de l'échec de cet appel.
- Vérifiez que le serveur et le groupe de démons WebSphere Application Server for z/OS sont spécifiés dans cet appel et démarrés, et que la prise en charge des adaptateurs locaux est activée.
- Vérifiez qu'un appel d'enregistrement (API BBOA1REG ou BBGAREG) a réussi dans l'espace adresse actif avec un nom correspondant avant d'utiliser l'appel d'envoi de réponse.
- Vérifiez qu'un appel Connection Get (API BBOA1CNG ou BBGA1CNG) a réussi et qu'un descripteur a été fourni en entrée pour cet appel.
- Vérifiez qu'un appel de l'API Receive Request Any, Receive Request Specific ou Host a été émis et renvoyé avec des données de requête pour le descripteur de connexion. L'état de la connexion doit permettre l'utilisation des API Send Response et Send Response Exception.
Code retour | Code motif | Description | Action |
---|---|---|---|
0 | - | Réussi | |
4 | - | Avertissement - voir le code raison | |
8 | - | Erreur - voir le code raison | |
8 | Le jeton du nom d'enregistrement existe déjà. | Assurez-vous que le nom d'enregistrement communiqué est valide. | |
10 | Le descripteur de connexion est libéré ou a un état incorrect. | Vérifiez qu'un descripteur de connexion valide a été envoyé. | |
14 | Une insuffisance de mémoire s'est produite pendant la sauvegarde du message. | La mémoire disponible est insuffisante pour que l'API Send Response Exception puisse traiter le message. L'espace d'adressage actif n'a plus de mémoire privée. | |
16 | Un ou plusieurs paramètres sont incorrects. | Vérifiez que tous les paramètres sont valides puis recommencez l'appel. | |
18 | La longueur de la réponse dépasse les limites du système. | La taille du message dépasse les capacités de prise en charge des messages de WebSphere Application Server. Assurez-vous que la taille est valide. Si la taille est valide, vérifiez que le paramètre de taille de WebSphere Application Server autorise les messages de cette taille. | |
20 | Un ou plusieurs paramètres sont incorrects. | Vérifiez que tous les paramètres sont valides puis recommencez l'appel. | |
28 | L'enregistrement auquel le descripteur de connexion est associé n'est plus actif. | Exécutez un nouvel appel Register avec le même nom d'enregistrement avant d'exécuter les appels Connection Get et Send Request. | |
36 | L'état de la connexion est incorrect. | Le descripteur de connexion utilisé pour cette requête a un état incorrect. Pour plus d'informations sur les états des connexions, reportez-vous à la documentation de l'API. | |
38 | Le descripteur de la connexion client est incorrect. | Le descripteur de connexion client utilisé pour cette requête est incorrect. Pour plus d'informations sur les descripteurs de connexion client, reportez-vous à la documentation de l'API. | |
40 | Une erreur de transmission locale s'est produite. | Consultez le journal du serveur WebSphere Application Server pour rechercher les messages liés à une erreur de transmission locale. | |
46 | Une erreur de communication locale s'est produite pendant l'appel de la requête. | Consultez les journaux de WebSphere Application Server pour rechercher la cause de cette erreur. | |
96 | Cette API ne peut pas être gérée lors de l'initialisation d'IMS ou lors d'un exit de préinitialisation IMS. | Appelez cette API une fois l'initialisation d'IMS terminée. | |
102 | Impossible d'accéder au début de la mémoire tampon de réponse fournie. | Vérifiez que l'adresse et la longueur de la mémoire tampon de réponse sont correctes. | |
104 | Impossible d'accéder à la fin de la mémoire tampon de réponse fournie. | Vérifiez que l'adresse et la longueur de la mémoire tampon de réponse sont correctes. | |
12 | 10 | Impossible de localiser le groupe de démons ou le serveur WebSphere Application Server. | Vérifiez que le serveur et le démon WebSphere Application Server sont démarrés et que la prise en charge des connexions locales est activée puis recommencez. |
14 | Impossible de localiser ou contrôler le vecteur d'appel de l'API utilisant le descripteur de connexion fourni. | Le descripteur de connexion est incorrect ou un appel de désenregistrement (API BBOA1URG) a invalidé le pool de connexions. | |
34 | Un module de remplacement d'API 64 bits a été utilisé dans un environnement IMS. | Les API 64 bits ne sont pas prises en charge sous IMS. | |
38 | Un module de remplacement d'API 64 bits a été utilisé dans un environnement CICS. | Les API 64 bits ne sont pas prises en charge sous CICS. | |
86 | L'élément BGVT principal de WebSphere Application Server for z/OS n'a pas été trouvé | WebSphere n'a pas encore été démarré sur l'image du système z/OS en cours. Vérifiez que le démon et qu'un noeud/serveur sont démarrés avant de démarrer des processus client des adaptateurs locaux optimisés WebSphere Application Server. | |
88 | La table de modules de remplacement du client principal WebSphere Application Server for z/OS n'a pas été trouvée. | Un serveur WebSphere Application Server a été démarré sur l'image système z/OS en cours mais il n'est pas en cours d'exécution au niveau où la table de modules de remplacement client des adaptateurs locaux optimisés est prise en charge. Il est possible que vous utilisiez une interface de module de remplacement d'adaptateurs locaux optimisés WebSphere Application Server Version 8.0.0.1 qui n'est pas compatible avec le niveau de maintenance du serveur d'applications. Pour utiliser les modules de remplacement des adaptateurs locaux optimisés V8.0.0.1, le serveur d'applications doit également être en cours d'exécution au niveau WebSphere Application Server Version 8.0.0 . Vérifiez que votre application est en cours d'exécution au niveau des modules de remplacement des adaptateurs locaux optimisés compatibles avec WebSphere Application Server sur ce système z/OS. | |
90 | L'emplacement de la table principale de modules de remplacement client des adaptateurs locaux optimisés WebSphere Application Server for z/OS n'a pas été trouvé. | Un serveur WebSphere Application Server a été démarré sur l'image système z/OS en cours mais il n'est pas en cours d'exécution au niveau où la table de modules de remplacement client des adaptateurs locaux optimisés est prise en charge. Il est possible que vous utilisiez une interface de module de remplacement d'adaptateurs locaux optimisés WebSphere Application Server Version 8.0.0.1 qui n'est pas compatible avec le niveau de maintenance du serveur d'applications. Pour utiliser les modules de remplacement des adaptateurs locaux optimisés V8.0.0.1, le serveur d'applications doit également être en cours d'exécution au niveau WebSphere Application Server Version 8.0.0 . Vérifiez que votre application est en cours d'exécution au niveau des modules de remplacement des adaptateurs locaux optimisés compatibles avec WebSphere Application Server sur ce système z/OS. |
Receive Request Any
Cette API permet de recevoir une requête d'une instance locale de WebSphere Application Server sur n'importe quelle connexion. Vous recevez une requête et les données associées sur n'importe quelle connexion du pool de connexions avec le nom d'enregistrement communiqué. La longueur des données de la requête est renvoyée comme paramètre de sortie. Un descripteur de connexion est également renvoyé à l'appelant comme paramètre de sortie. Un appel de l'API Get Data renvoie les données du message reçu avec le descripteur de connexion renvoyé.
API | Syntaxe |
---|---|
BBOA1RCA ou BBGA1RCA | BBOA1RCA ( registername, connectionhandle, requestservicename, requestservicenamel, requestdatalen, waittime, rc, rsn ) BBGA1RCA ( registername, connectionhandle, requestservicename, requestservicenamel, requestdatalen, waittime, rc, rsn ) |
Paramètres :
registername (entrée)Variable ou constante qui contient le nom à utiliser pour rechercher le pool de connexions dont vous voulez extraire une connexion. Il s'agit obligatoirement d'une chaîne de remplissage de 12 caractères.
connectionhandle (sortie)Descripteur de connexion de 12 octets qui doit être retourné et envoyé sur les demandes suivantes pour les actions sur cette connexion.
requestservicename (entrée/sortie)Chaîne de caractères EBCDIC de 256 octets maximum qui indique le nom du service demandé. Il s'agit du nom du service cible spécifié dans InteractionSpec par l'application WebSphere Application Server. La valeur * indique une demande de réception pour tous les noms de service qui arrivent sous le nom de registre en cours.
requestservicenamel (entrée/sortie)Entier contenant la longueur du nom de service à démarrer ou 0 (zéro) si le nom de service se termine par null.
requestdatalen (sortie)Une valeur non signée 32 bits en mode 31 bits ou valeur non signée 64 bits en mode 64 bits est renvoyée contenant la longueur des données à recevoir.
waittime (entrée)Entier qui indique le délai d'attente (en secondes) d'une connexion avant l'envoi d'un code raison indiquant l'indisponibilité de la connexion demandée. La valeur 0 implique qu'il n'existe pas de délai d'attente et que l'API attend indéfiniment.
rc (sortie)Code retour représenté par un entier qui indique la réussite ou l'échec de cet appel.
rsn (sortie)Code raison représenté par un entier qui indique la raison de l'échec de cet appel.
- Vérifiez que le serveur et le groupe de démons WebSphere Application Server for z/OS spécifiés dans cet appel sont démarrés et que la prise en charge des adaptateurs locaux est activée.
- Vérifiez qu'un appel d'enregistrement (API BBOA1REG ou BBGA1REG) a réussi dans l'espace adresse actif avec un nom correspondant avant d'utiliser cette API.
Code retour | Code motif | Description | Action |
---|---|---|---|
0 | - | Réussi | |
4 | - | Avertissement - voir le code raison | |
8 | - | Erreur - voir le code raison | |
8 | Le jeton du nom d'enregistrement existe déjà. | Assurez-vous que le nom d'enregistrement communiqué est valide. | |
11 | WebSphere Application Server a envoyé des données incorrectes. | ||
16 | La longueur du nom de service de la requête est incorrect. | Corrigez le programme et recommencez l'appel. | |
19 | Un échec s'est produit en raison de données de communication locale incorrectes. | ||
21 | Un échec s'est produit en raison de données de prévisualisation de la communication locale incorrectes. | ||
38 | Le descripteur de la connexion client est incorrect. | Le descripteur de connexion client utilisé pour cette requête est incorrect. Pour plus d'informations sur les descripteurs de connexion client, reportez-vous à la documentation de l'API. | |
40 | Une erreur de transmission locale s'est produite. | Consultez le journal du serveur WebSphere Application Server pour rechercher les messages liés à une erreur de transmission locale. | |
46 | Une erreur de communication locale s'est produite pendant l'appel de la requête. | Consultez les journaux de WebSphere Application Server pour rechercher la cause de cette erreur. | |
76 | Une tentative de connexion au serveur a échoué car ce serveur n'est plus actif. | Démarrez le serveur et tentez à nouveau d'établir la communication. | |
96 | Cette API ne peut pas être gérée lors de l'initialisation d'IMS ou lors d'un exit de préinitialisation IMS. | Appelez cette API une fois l'initialisation d'IMS terminée. | |
12 | 10 | Impossible de localiser le serveur ou le groupe de démons WebSphere Application Server. | Vérifiez que le serveur et le démon WebSphere Application Server sont démarrés et que la prise en charge des connexions locales est activée puis recommencez. |
24 | Après un appel d'enregistrement réussi, une erreur s'est produite pendant l'obtention d'une connexion à partir du pool de connexions. | Assurez-vous que le serveur est démarré. S'il ne fonctionne pas, redémarrez le serveur puis exécutez à nouveau la requête de l'API. | |
34 | Un module de remplacement d'API 64 bits a été utilisé dans un environnement IMS. | Les API 64 bits ne sont pas prises en charge sous IMS. | |
38 | Un module de remplacement d'API 64 bits a été utilisé dans un environnement CICS. | Les API 64 bits ne sont pas prises en charge sous CICS. | |
44 | CP build incorrect pour l'appel de service. | ||
46 | CP get incorrect pour la cellule de service. | ||
48 | CP free incorrect pour la cellule de service. | ||
60 | Impossible d'obtenir un verrou SRVQ | ||
62 | Impossible de déverrouiller un verrou SRVQ | ||
86 | L'élément BGVT principal de WebSphere Application Server for z/OS n'a pas été trouvé | WebSphere n'a pas encore été démarré sur l'image du système z/OS en cours. Vérifiez que le démon et qu'un noeud/serveur sont démarrés avant de démarrer des processus client des adaptateurs locaux optimisés WebSphere Application Server. | |
88 | La table de modules de remplacement du client principal WebSphere Application Server for z/OS n'a pas été trouvée. | Un serveur WebSphere Application Server a été démarré sur l'image système z/OS en cours mais il n'est pas en cours d'exécution au niveau où la table de modules de remplacement client des adaptateurs locaux optimisés est prise en charge. Il est possible que vous utilisiez une interface de module de remplacement d'adaptateurs locaux optimisés WebSphere Application Server Version 8.0.0.1 qui n'est pas compatible avec le niveau de maintenance du serveur d'applications. Pour utiliser les modules de remplacement des adaptateurs locaux optimisés V8.0.0.1, le serveur d'applications doit également être en cours d'exécution au niveau WebSphere Application Server Version 8.0.0 . Vérifiez que votre application est en cours d'exécution au niveau des modules de remplacement des adaptateurs locaux optimisés compatibles avec WebSphere Application Server sur ce système z/OS. | |
90 | L'emplacement de la table principale de modules de remplacement client des adaptateurs locaux optimisés WebSphere Application Server for z/OS n'a pas été trouvé. | Un serveur WebSphere Application Server a été démarré sur l'image système z/OS en cours mais il n'est pas en cours d'exécution au niveau où la table de modules de remplacement client des adaptateurs locaux optimisés est prise en charge. Il est possible que vous utilisiez une interface de module de remplacement d'adaptateurs locaux optimisés WebSphere Application Server Version 8.0.0.1 qui n'est pas compatible avec le niveau de maintenance du serveur d'applications. Pour utiliser les modules de remplacement des adaptateurs locaux optimisés V8.0.0.1, le serveur d'applications doit également être en cours d'exécution au niveau WebSphere Application Server Version 8.0.0 . Vérifiez que votre application est en cours d'exécution au niveau des modules de remplacement des adaptateurs locaux optimisés compatibles avec WebSphere Application Server sur ce système z/OS. |
Receive Request Specific
Cette API permet de recevoir une requête d'une instance locale de WebSphere Application Server sur une connexion spécifique. Vous recevez une requête et les données associées pour le descripteur de connexion fourni en entrée. La longueur des données de la requête est renvoyée. Un appel de l'API Get Data renvoie les données du message reçu avec le descripteur de connexion renvoyé.API | Syntaxe |
---|---|
BBOA1RCS ou BBGA1RCS | BBOA1RCS ( connectionhandle, requestservicename, requestservicenamel, requestdatalen, async(0|1), rc, rsn ) BBGA1RCS ( connectionhandle, requestservicename, requestservicenamel, requestdatalen, async(0|1), rc, rsn ) |
Paramètres :
connectionhandle (entrée)Descripteur de connexion de 12 octets à utiliser pour la demande de réception.
requestservicename (entrée/sortie)Chaîne de caractères EBCDIC de 256 octets maximum qui indique le nom du service demandé. Il s'agit du nom du service cible spécifié dans InteractionSpec par l'application WebSphere Application Server. La valeur * indique cette configuration comme serveur pour tous les noms de service qui arrivent sous le nom d'enregistrement en cours.
requestservicenamel (entrée/sortie)Entier contenant la longueur du nom de service à démarrer ou 0 (zéro) si le nom de service se termine par null.
requestdatalen (sortie)Une valeur non signée 32 bits en mode 31 bits ou une valeur non signée 64 bits en mode 64 bits est renvoyée qui contient la longueur des données de requête. Cette valeur peut ensuite être utilisée par l'appelant pour obtenir de la mémoire avant d'appeler l'API Get Data. Si l'indicateur async a la valeur 1, cela signifie que l'appelant désire reprendre le contrôle immédiatement. La valeur est 0xFF si les données de la demande ne sont pas encore reçues. Dans ce cas, vous devez rappeler l'API pour récupérer une requête entrante.
async(0|1) (entrée)Entier. La valeur 1 indique que l'appelant demande un retour de contrôle immédiat, même si la longueur de la demande peut être encore inconnue. Lorsque async a la valeur 0, l'appel attend une demande de WebSphere Application Server à recevoir.
rc (sortie)Code retour représenté par un entier qui indique la réussite ou l'échec de cet appel.
rsn (sortie)Code raison représenté par un entier qui indique la raison de l'échec de cet appel.
- Vérifiez que le serveur et le groupe de démons WebSphere Application Server for z/OS spécifiés dans cet appel sont démarrés et que la prise en charge des adaptateurs locaux est activée.
- Vérifiez qu'un appel d'enregistrement (BBOA1REG) a réussi dans l'espace d'adressage actif avec un nom correspondant avant d'utiliser cette API.
Code retour | Code motif | Description | Action |
---|---|---|---|
0 | - | Réussi | |
4 | - | Avertissement - voir le code raison | |
8 | - | Erreur - voir le code raison | |
8 | Le jeton du nom d'enregistrement existe déjà. | Assurez-vous que le nom d'enregistrement communiqué est valide. | |
10 | Le descripteur de connexion est libéré ou a un état incorrect. | Vérifiez qu'un descripteur de connexion valide a été envoyé. | |
11 | WebSphere Application Server a envoyé des données incorrectes. | ||
16 | La longueur du nom de service de la requête est incorrect. | Corrigez le programme et recommencez l'appel. | |
19 | Un échec s'est produit en raison de données de communication locale incorrectes. | ||
21 | Un échec s'est produit en raison de données de prévisualisation de la communication locale incorrectes. | ||
28 | L'enregistrement auquel le descripteur de connexion est associé n'est plus actif. | Rappelez le nom d'enregistrement avant d'appeler les API Connection Get et Receive Request Specific. | |
36 | L'état de la connexion est incorrect. | Le descripteur de connexion utilisé pour cette requête a un état incorrect. Pour plus d'informations sur les états des connexions, reportez-vous à la documentation de l'API. | |
38 | Le descripteur de la connexion client est incorrect. | Le descripteur de connexion client utilisé pour cette requête est incorrect. Pour plus d'informations sur les descripteurs de connexion client, reportez-vous à la documentation de l'API. | |
40 | Une erreur de transmission locale s'est produite. | Consultez le journal du serveur WebSphere Application Server pour rechercher les messages liés à une erreur de transmission locale. | |
46 | Une erreur de communication locale s'est produite pendant l'appel de la requête. | Consultez les journaux de WebSphere Application Server pour rechercher la cause de cette erreur. | |
76 | Une tentative de connexion au serveur a échoué car ce serveur n'est plus actif. | Démarrez le serveur et tentez à nouveau d'établir la communication. | |
78 | Une erreur interne entraînant la sélection par la connexion d'une requête ne faisant pas partie de la transaction en cours de traitement s'est produite. | Renvoyez la connexion au pool de connexions. Si l'erreur persiste, contactez le support IBM. | |
80 | Le délai d'attente de la transaction active sur cette connexion est arrivé à expiration et l'état de la connexion n'a pas pu être réinitialisé pour le traitement d'une autre requête. | Renvoyez la connexion au pool de connexions. Si l'erreur persiste, contactez le support IBM. | |
96 | Cette API ne peut pas être gérée lors de l'initialisation d'IMS ou lors d'un exit de préinitialisation IMS. | Appelez cette API une fois l'initialisation d'IMS terminée. | |
12 | 10 | Impossible de localiser le serveur ou le groupe de démons WebSphere Application Server. | Vérifiez que le serveur et le démon WebSphere Application Server sont démarrés et que la prise en charge des connexions locales est activée puis recommencez. |
14 | Impossible de localiser ou contrôler le vecteur d'appel de l'API utilisant le descripteur de connexion fourni. | Le descripteur de connexion est incorrect ou un appel de désenregistrement (API BBOA1URG) a invalidé le pool de connexions. | |
34 | Un module de remplacement d'API 64 bits a été utilisé dans un environnement IMS. | Les API 64 bits ne sont pas prises en charge sous IMS. | |
38 | Un module de remplacement d'API 64 bits a été utilisé dans un environnement CICS. | Les API 64 bits ne sont pas prises en charge sous CICS. | |
44 | CP build incorrect pour la cellule de service. | ||
46 | CP get incorrect pour l'appel de service. | ||
48 | CP free incorrect pour la cellule de service. | ||
60 | Impossible d'obtenir un verrou SRVQ | ||
62 | Impossible de déverrouiller un verrou SRVQ | ||
86 | L'élément BGVT principal de WebSphere Application Server for z/OS n'a pas été trouvé | WebSphere n'a pas encore été démarré sur l'image du système z/OS en cours. Vérifiez que le démon et qu'un noeud/serveur sont démarrés avant de démarrer des processus client des adaptateurs locaux optimisés WebSphere Application Server. | |
88 | La table de modules de remplacement du client principal WebSphere Application Server for z/OS n'a pas été trouvée. | Un serveur WebSphere Application Server a été démarré sur l'image système z/OS en cours mais il n'est pas en cours d'exécution au niveau où la table de modules de remplacement client des adaptateurs locaux optimisés est prise en charge. Il est possible que vous utilisiez une interface de module de remplacement d'adaptateurs locaux optimisés WebSphere Application Server Version 8.0.0.1 qui n'est pas compatible avec le niveau de maintenance du serveur d'applications. Pour utiliser les modules de remplacement des adaptateurs locaux optimisés V8.0.0.1, le serveur d'applications doit également être en cours d'exécution au niveau WebSphere Application Server Version 8.0.0 . Vérifiez que votre application est en cours d'exécution au niveau des modules de remplacement des adaptateurs locaux optimisés compatibles avec WebSphere Application Server sur ce système z/OS. | |
90 | L'emplacement de la table principale de modules de remplacement client des adaptateurs locaux optimisés WebSphere Application Server for z/OS n'a pas été trouvé. | Un serveur WebSphere Application Server a été démarré sur l'image système z/OS en cours mais il n'est pas en cours d'exécution au niveau où la table de modules de remplacement client des adaptateurs locaux optimisés est prise en charge. Il est possible que vous utilisiez une interface de module de remplacement d'adaptateurs locaux optimisés WebSphere Application Server Version 8.0.0.1 qui n'est pas compatible avec le niveau de maintenance du serveur d'applications. Pour utiliser les modules de remplacement des adaptateurs locaux optimisés V8.0.0.1, le serveur d'applications doit également être en cours d'exécution au niveau WebSphere Application Server Version 8.0.0 . Vérifiez que votre application est en cours d'exécution au niveau des modules de remplacement des adaptateurs locaux optimisés compatibles avec WebSphere Application Server sur ce système z/OS. |
Receive Response Length
L'API Receive Response Length permet de récupérer la longueur des données de la réponse à un appel Send Request antérieur.API | Syntaxe |
---|---|
BBOA1RCL ou BBGA1RCL | BBOA1RCL ( connectionhandle, async(0|1), responsedatalen, rc, rsn ) BBGA1RCL ( connectionhandle, async(0|1), responsedatalen, rc, rsn ) |
Paramètres :
connectionhandle (entrée)Descripteur de connexion de 12 octets qui doit être utilisé pour la demande.
async (entrée)Entier. La valeur 1 indique que l'appelant demande un retour de contrôle immédiat, même si la longueur de la demande peut être encore inconnue. Lorsque async a la valeur 0, cet appel attend la réponse à retourner depuis WebSphere Application Server et fournit la longuer de réponse dans la valeur du paramètre responsedatalen.
responsedatalen (sortie)Une valeur non signée 32 bits en mode 31 bits et une valeur non signée 64 bits en mode 64 bits contenant la longueur des données reçues est renvoyée. Cette valeur peut ensuite être utilisée par l'appelant pour obtenir de la mémoire avant d'appeler l'API Get Data. Si async a la valeur 1, la valeur être retournée comme FF si les données de réponse ne sont pas encore reçues.
rc (sortie)Code retour représenté par un entier qui indique la réussite ou l'échec de cet appel.
rsn (sortie)Code raison représenté par un entier qui indique la raison de l'échec de cet appel.
- Vérifiez que le serveur et le groupe de démons WebSphere Application Server for z/OS spécifiés dans cet appel sont démarrés et que la prise en charge des adaptateurs locaux est activée.
- Vérifiez qu'un appel d'enregistrement (API BBOA1REG ou BBGA1REG) a réussi dans l'espace adresse actif avec un nom correspondant avant d'utiliser cette API.
- Vérifiez qu'un appel Connection Get (API BBOA1CNG ou BBGA1CNG) a abouti et qu'un descripteur a été fourni en entrée pour cet appel.
- Vérifiez qu'un appel Send Request (API BBOA1SRQ ou BBGA1SRQ) a abouti avant d'exécuter cet appel.
Code retour | Code motif | Description | Action |
---|---|---|---|
0 | - | Réussi | |
4 | - | Avertissement - voir le code raison | |
8 | - | Erreur - voir le code raison | |
8 | Le jeton du nom d'enregistrement existe déjà. | Assurez-vous que le nom d'enregistrement communiqué est valide. | |
11 | WebSphere Application Server a envoyé des données incorrectes. | ||
19 | Un échec s'est produit en raison de données de communication locale incorrectes. | ||
21 | Un échec s'est produit en raison de données de prévisualisation de la communication locale incorrectes. | ||
34 | Le service cible est introuvable. | Vérifiez que l'application qui contient le bean enterprise cible est installée et démarrée sur l'instance cible de WebSphere Application Server. | |
36 | L'état de la connexion est incorrect. | Le descripteur de connexion utilisé pour cette requête a un état incorrect. Pour plus d'informations sur les états des connexions, reportez-vous à la documentation de l'API. | |
38 | Le descripteur de la connexion client est incorrect. | Le descripteur de connexion client utilisé pour cette requête est incorrect. Pour plus d'informations sur les descripteurs de connexion client, reportez-vous à la documentation de l'API. | |
40 | Une erreur de transmission locale s'est produite. | Consultez le journal du serveur WebSphere Application Server pour rechercher les messages liés à une erreur de transmission locale. | |
96 | Cette API ne peut pas être gérée lors de l'initialisation d'IMS ou lors d'un exit de préinitialisation IMS. | Appelez cette API une fois l'initialisation d'IMS terminée. | |
12 | 10 | Impossible de localiser le serveur ou le groupe de démons WebSphere Application Server. | Vérifiez que le serveur et le démon WebSphere Application Server sont démarrés et que la prise en charge des connexions locales est activée puis recommencez. |
14 | Impossible de localiser ou contrôler le vecteur d'appel de l'API utilisant le descripteur de connexion fourni. | Le descripteur de connexion est incorrect ou un appel de désenregistrement (API BBOA1URG) a invalidé le pool de connexions. | |
34 | Un module de remplacement d'API 64 bits a été utilisé dans un environnement IMS. | Les API 64 bits ne sont pas prises en charge sous IMS. | |
38 | Un module de remplacement d'API 64 bits a été utilisé dans un environnement CICS. | Les API 64 bits ne sont pas prises en charge sous CICS. | |
86 | L'élément BGVT principal de WebSphere Application Server for z/OS n'a pas été trouvé | WebSphere n'a pas encore été démarré sur l'image du système z/OS en cours. Vérifiez que le démon et qu'un noeud/serveur sont démarrés avant de démarrer des processus client des adaptateurs locaux optimisés WebSphere Application Server. | |
88 | La table de modules de remplacement du client principal WebSphere Application Server for z/OS n'a pas été trouvée. | Un serveur WebSphere Application Server a été démarré sur l'image système z/OS en cours mais il n'est pas en cours d'exécution au niveau où la table de modules de remplacement client des adaptateurs locaux optimisés est prise en charge. Il est possible que vous utilisiez une interface de module de remplacement d'adaptateurs locaux optimisés WebSphere Application Server Version 8.0.0.1 qui n'est pas compatible avec le niveau de maintenance du serveur d'applications. Pour utiliser les modules de remplacement des adaptateurs locaux optimisés V8.0.0.1, le serveur d'applications doit également être en cours d'exécution au niveau WebSphere Application Server Version 8.0.0 . Vérifiez que votre application est en cours d'exécution au niveau des modules de remplacement des adaptateurs locaux optimisés compatibles avec WebSphere Application Server sur ce système z/OS. | |
90 | L'emplacement de la table principale de modules de remplacement client des adaptateurs locaux optimisés WebSphere Application Server for z/OS n'a pas été trouvé. | Un serveur WebSphere Application Server a été démarré sur l'image système z/OS en cours mais il n'est pas en cours d'exécution au niveau où la table de modules de remplacement client des adaptateurs locaux optimisés est prise en charge. Il est possible que vous utilisiez une interface de module de remplacement d'adaptateurs locaux optimisés WebSphere Application Server Version 8.0.0.1 qui n'est pas compatible avec le niveau de maintenance du serveur d'applications. Pour utiliser les modules de remplacement des adaptateurs locaux optimisés V8.0.0.1, le serveur d'applications doit également être en cours d'exécution au niveau WebSphere Application Server Version 8.0.0 . Vérifiez que votre application est en cours d'exécution au niveau des modules de remplacement des adaptateurs locaux optimisés compatibles avec WebSphere Application Server sur ce système z/OS. |
Get Message Data
Cette API permet de copier les données d'un message reçu. A la suite de cet appel, le message est supprimé de la mémoire cache des messages de l'adaptateur.API | Syntaxe |
---|---|
BBOA1GET ou BBGA1GET | BBOA1GET ( connectionhandle, msgdata, msgdatalen, rc, rsn, rv ) BBGA1GET ( connectionhandle, msgdata, msgdatalen, rc, rsn, rv ) |
Paramètres :
connectionhandle (entrée)Descripteur de connexion de 12 octets qui doit être utilisé pour la demande.
msgdata (entrée)Pointeur de 31 bits ou de 64 bits désignant l'adresse de la zone de données cible de la copie. L'espace mémoire désigné par ce pointeur doit correspondre à une clé inscriptible par l'appelant.
msgdatalen (entrée)Valeur non signée de 32 bits en mode 31 bits ou valeur non signée de 64 bits en mode 64 bits qui indique la longueur des données à copier.
rc (sortie)Code retour représenté par un entier qui indique la réussite ou l'échec de cet appel.
rsn (sortie)Code raison représenté par un entier qui indique la raison de l'échec de cet appel.
rv (sortie)Entier de 32 bits retourné contenant la taille de la mémoire tampon de contexte de la demande.
- Vérifiez que le serveur et le groupe de démons WebSphere Application Server for z/OS spécifiés dans cet appel sont démarrés et que la prise en charge des adaptateurs locaux est activée.
- Vérifiez qu'un appel d'enregistrement (API BBOA1REG ou BBGA1REG) a abouti dans l'espace adresse actif avec un nom correspondant avant d'utiliser l'API Send Request.
- Vérifiez qu'un appel Connection Get (API BBOA1CNG ou BBGA1CNG) a abouti et qu'un descripteur a été fourni en entrée pour cet appel.
- Si la valeur du paramètre msgdatalen de l'entrée de l'appelant API est supérieure à la réponse du message, le code de retour contient 0 et la longueur de message est fournie dans la valeur de retour.
- Important : Quand l'appel Get Message Data revient à l'appelant, les données du message sont abandonnées et la connexion revient à un état où elle peut être utilisée pour un autre appel Send Request ou Receive Request. Tout appel suivant Get Message Data ou Receive Response Length aboutit à une erreur.
Code retour | Code motif | Description | Action |
---|---|---|---|
0 | - | Réussi | |
4 | - | Avertissement - voir le code raison | |
8 | - | Erreur - voir le code raison | |
8 | Le jeton du nom d'enregistrement existe déjà. | Assurez-vous que le nom d'enregistrement communiqué est valide. | |
36 | L'état de la connexion est incorrect. | Le descripteur de connexion utilisé pour cette requête a un état incorrect. Pour plus d'informations sur les états des connexions, reportez-vous à la documentation de l'API. | |
38 | Le descripteur de la connexion client est incorrect. | Le descripteur de connexion client utilisé pour cette requête est incorrect. Pour plus d'informations sur les descripteurs de connexion client, reportez-vous à la documentation de l'API. | |
40 | Une erreur de transmission locale s'est produite. | Consultez le journal du serveur WebSphere Application Server pour rechercher les messages liés à une erreur de transmission locale. | |
48 | Une erreur de communication locale s'est produite pendant la requête de lecture. | Consultez les journaux de WebSphere Application Server pour rechercher la cause de cette erreur. | |
50 | La connexion avec WebSphere Application Server a été fermée. | Consultez les journaux de WebSphere Application Server pour rechercher la cause de cette erreur. | |
72 | La valeur du paramètre d'entrée de la longueur de réponse est insuffisante pour le message de réponse. | Seule une partie du message est renvoyée. Le reste du message est ignoré. Reportez-vous à la valeur de retour pour connaître la taille du message de réponse. | |
96 | Cette API ne peut pas être gérée lors de l'initialisation d'IMS ou lors d'un exit de préinitialisation IMS. | Appelez cette API une fois l'initialisation d'IMS terminée. | |
98 | Impossible d'accéder au début de la mémoire tampon de requête fournie. | Vérifiez que l'adresse et la longueur de la mémoire tampon de requête sont correctes. | |
100 | Impossible d'accéder à la fin de la mémoire tampon de requête fournie. | Vérifiez que l'adresse et la longueur de la mémoire tampon de requête sont correctes. | |
102 | Impossible d'accéder au début de la mémoire tampon de réponse fournie. | Vérifiez que l'adresse et la longueur de la mémoire tampon de réponse sont correctes. | |
104 | Impossible d'accéder à la fin de la mémoire tampon de réponse fournie. | Vérifiez que l'adresse et la longueur de la mémoire tampon de réponse sont correctes. | |
12 | 10 | Impossible de localiser le serveur ou le groupe de démons WebSphere Application Server. | Vérifiez que le serveur et le démon WebSphere Application Server sont démarrés et que la prise en charge des connexions locales est activée, puis recommencez. |
12 | 10 | Impossible de localiser le serveur ou le groupe de démons WebSphere Application Server. | Vérifiez que le serveur et le démon WebSphere Application Server sont démarrés et que la prise en charge des connexions locales est activée puis recommencez. |
14 | Impossible de localiser ou contrôler le vecteur d'appel de l'API utilisant le descripteur de connexion fourni. | Le descripteur de connexion est incorrect ou un appel de désenregistrement (API BBOA1URG) a invalidé le pool de connexions. | |
34 | Un module de remplacement d'API 64 bits a été utilisé dans un environnement IMS. | Les API 64 bits ne sont pas prises en charge sous IMS. | |
38 | Un module de remplacement d'API 64 bits a été utilisé dans un environnement CICS. | Les API 64 bits ne sont pas prises en charge sous CICS. | |
86 | L'élément BGVT principal de WebSphere Application Server for z/OS n'a pas été trouvé | WebSphere n'a pas encore été démarré sur l'image du système z/OS en cours. Vérifiez que le démon et qu'un noeud/serveur sont démarrés avant de démarrer des processus client des adaptateurs locaux optimisés WebSphere Application Server. | |
88 | La table de modules de remplacement du client principal WebSphere Application Server for z/OS n'a pas été trouvée. | Un serveur WebSphere Application Server a été démarré sur l'image système z/OS en cours mais il n'est pas en cours d'exécution au niveau où la table de modules de remplacement client des adaptateurs locaux optimisés est prise en charge. Il est possible que vous utilisiez une interface de module de remplacement d'adaptateurs locaux optimisés WebSphere Application Server Version 8.0.0.1 qui n'est pas compatible avec le niveau de maintenance du serveur d'applications. Pour utiliser les modules de remplacement des adaptateurs locaux optimisés V8.0.0.1, le serveur d'applications doit également être en cours d'exécution au niveau WebSphere Application Server Version 8.0.0 . Vérifiez que votre application est en cours d'exécution au niveau des modules de remplacement des adaptateurs locaux optimisés compatibles avec WebSphere Application Server sur ce système z/OS. | |
90 | L'emplacement de la table principale de modules de remplacement client des adaptateurs locaux optimisés WebSphere Application Server for z/OS n'a pas été trouvé. | Un serveur WebSphere Application Server a été démarré sur l'image système z/OS en cours mais il n'est pas en cours d'exécution au niveau où la table de modules de remplacement client des adaptateurs locaux optimisés est prise en charge. Il est possible que vous utilisiez une interface de module de remplacement d'adaptateurs locaux optimisés WebSphere Application Server Version 8.0.0.1 qui n'est pas compatible avec le niveau de maintenance du serveur d'applications. Pour utiliser les modules de remplacement des adaptateurs locaux optimisés V8.0.0.1, le serveur d'applications doit également être en cours d'exécution au niveau WebSphere Application Server Version 8.0.0 . Vérifiez que votre application est en cours d'exécution au niveau des modules de remplacement des adaptateurs locaux optimisés compatibles avec WebSphere Application Server sur ce système z/OS. |
Appel
Cette API utilise d'autres fonctions d'API primitives sous-jacentes pour appeler une méthode dans une instance locale de WebSphere Application Server. Elle s'utilise quand la taille maximum de la zone de sortie des réponses est déjà connue.API | Syntaxe |
---|---|
BBOA1INV ou BBGA1INV | BBOA1INV ( registername, requesttype, requestservicename, requestservicenamel, requestdata, requestdatalen, responsedata, responsedatalen, waittime, rc, rsn, rv ) BBGA1INV ( registername, requesttype, requestservicename, requestservicenamel, requestdata, requestdatalen, responsedata, responsedatalen, waittime, rc, rsn, rv ) |
Paramètres :
registername (entrée)Variable ou constante qui contient le nom à utiliser pour rechercher le pool de connexions dont vous voulez extraire une connexion. Il s'agit obligatoirement d'une chaîne de remplissage de 12 caractères.
requesttype (entrée)Entier contenant le type de demande qui indique le type de demande de travail à traiter. Les valeurs de type prises en charge sont les suivantes : 1 = demandes de travail EJB locales, 2 = demandes de travail EJB distantes.
requestservicename (entrée)Chaîne de caractères EBCDIC de 256 octets maximum qui indique le nom du service à appeler. Pour Type=1, EJB, il s'agit du nom de l'interface Home JNDI de la cible.
requestservicenamel (entrée)Entier contenant la longueur du nom de service à démarrer ou 0 (zéro) si le nom de service se termine par null.
requestdata (entrée)Pointeur de 31 bits ou de 64 bits désignant l'adresse de départ des données de requête à envoyer.
requestdatalen (entrée)Valeur non signée de 32 bits en mode 31 bits ou valeur non signée de 64 bits en mode 64 bits qui indique la longueur des données à envoyer.
responsedata (entrée)Pointeur de 31 bits ou de 64 bits désignant l'adresse de la zone de données de réponse de la copie. L'espace mémoire désigné par ce pointeur doit correspondre à une clé inscriptible par l'appelant.
responsedatalen (entrée)Valeur non signée de 32 bits en mode 31 bits ou valeur non signée de 64 bits en mode 64 bits qui indique la longueur des données à envoyer.
waittime (entrée)Entier qui indique le délai d'attente (en secondes) d'une connexion avant l'envoi d'un code raison indiquant l'indisponibilité de la connexion demandée. La valeur 0 implique qu'il n'existe pas de délai d'attente et que l'API attend indéfiniment.
rc (sortie)Code retour représenté par un entier qui indique la réussite ou l'échec de cet appel.
rsn (sortie)Code raison représenté par un entier qui indique la raison de l'échec de cet appel.
rv (sortie)Entier de 32 bits retourné contenant la taille des données de message reçues et copiées vers la zone de réponse de l'appelant.
- Vérifiez que le serveur et le groupe de démons WebSphere Application Server for z/OS spécifiés dans cet appel sont démarrés et que la prise en charge des adaptateurs locaux est activée.
- Vérifiez qu'un appel d'enregistrement (API BBOA1REG ou BBGA1REG) a abouti dans l'espace adresse actif avec un nom correspondant avant d'utiliser l'API Send Request.
- Si la valeur du paramètre responsedatalen de l'entrée de l'appelant API est supérieure à la réponse du message, le code retour contient 0 et la longueur de message est fournie dans la valeur de retour.
Code retour | Code motif | Description | Action |
---|---|---|---|
0 | - | Réussi | |
4 | - | Avertissement - voir le code raison | |
8 | - | Erreur - voir le code raison | |
8 | Le jeton du nom d'enregistrement existe déjà. | Assurez-vous que le nom d'enregistrement communiqué est valide. | |
10 | La connexion demandée est indisponible. Le délai d'attente est arrivé à expiration avant l'établissement de la connexion demandée. | Le mode opératoire de l'application varie selon les cas. Attendez puis recommencez, ou acceptez l'échec de cet appel d'API. Vous pouvez également augmenter le nombre maximum de connexions dans l'appel de l'API Register. | |
11 | WebSphere Application Server a envoyé des données incorrectes. | ||
14 | Une insuffisance de mémoire s'est produite pendant la sauvegarde du message. | La mémoire disponible est insuffisante pour que l'appel puisse traiter le message. L'espace d'adressage actif n'a plus de mémoire privée. | |
16 | La longueur du nom de service de la requête est incorrect. | Corrigez le programme et recommencez l'appel. | |
18 | La longueur de la réponse dépasse les limites du système. | La taille du message dépasse les capacités de prise en charge des messages de WebSphere Application Server. Assurez-vous que la taille est valide. Si la taille est valide, vérifiez que le paramètre de taille de WebSphere Application Server autorise les messages de cette taille. | |
19 | Un échec s'est produit en raison de données de communication locale incorrectes. | ||
21 | Un échec s'est produit en raison de données de prévisualisation de la communication locale incorrectes. | ||
24 | Après un appel d'enregistrement réussi, une erreur s'est produite pendant l'obtention d'une connexion à partir du pool de connexions. | Assurez-vous que le serveur est démarré. S'il ne fonctionne pas, redémarrez le serveur puis exécutez à nouveau la requête de l'API. | |
26 | Impossible de commencer le traitement de la transaction globale. | ||
28 | L'enregistrement a été trouvé mais il est inactif. | ||
32 | Le type de requête utilisé dans l'appel d'API est incorrect. | Le paramètre de type de requête indiqué est incorrect. Corrigez le programme et recommencez l'appel. | |
34 | Le service cible est introuvable. | Vérifiez que l'application qui contient le bean enterprise cible est installée et démarrée sur l'instance cible de WebSphere Application Server. | |
36 | L'état de la connexion est incorrect. | Le descripteur de connexion utilisé pour cette requête a un état incorrect. Pour plus d'informations sur les états des connexions, reportez-vous à la documentation de l'API. | |
38 | Le descripteur de la connexion client est incorrect. | Le descripteur de connexion client utilisé pour cette requête est incorrect. Pour plus d'informations sur les descripteurs de connexion client, reportez-vous à la documentation de l'API. | |
40 | Une erreur de transmission locale s'est produite. | Consultez le journal du serveur WebSphere Application Server pour rechercher les messages liés à une erreur de transmission locale. | |
44 | Une exception ou une condition inattendue s'est produite dans le bean enterprise cible. | Consultez les journaux de WebSphere Application Server pour rechercher les données liées à cette exception. | |
46 | Une erreur de communication locale s'est produite pendant le traitement de la requête d'envoi. | Consultez les journaux de WebSphere Application Server pour rechercher la cause de cette erreur. | |
48 | Une erreur de communication locale s'est produite pendant la requête de lecture. | Consultez les journaux de WebSphere Application Server pour rechercher la cause de cette erreur. | |
50 | La connexion avec WebSphere Application Server a été fermée. | Consultez les journaux de WebSphere Application Server pour rechercher la cause de cette erreur. | |
72 | La valeur du paramètre d'entrée de la longueur de réponse est insuffisante pour le message de réponse. | Seule une partie du message est renvoyée. Le reste du message est ignoré. Reportez-vous à la valeur de retour pour connaître la taille du message de réponse. | |
96 | Cette API ne peut pas être gérée lors de l'initialisation d'IMS ou lors d'un exit de préinitialisation IMS. | Appelez cette API une fois l'initialisation d'IMS terminée. | |
98 | Impossible d'accéder au début de la mémoire tampon de requête fournie. | Vérifiez que l'adresse et la longueur de la mémoire tampon de requête sont correctes. | |
100 | Impossible d'accéder à la fin de la mémoire tampon de requête fournie. | Vérifiez que l'adresse et la longueur de la mémoire tampon de requête sont correctes. | |
102 | Impossible d'accéder au début de la mémoire tampon de réponse fournie. | Vérifiez que l'adresse et la longueur de la mémoire tampon de réponse sont correctes. | |
104 | Impossible d'accéder à la fin de la mémoire tampon de réponse fournie. | Vérifiez que l'adresse et la longueur de la mémoire tampon de réponse sont correctes. | |
12 | 10 | Impossible de localiser le serveur ou le groupe de démons WebSphere Application Server. | Vérifiez que le serveur et le démon WebSphere Application Server sont démarrés et que la prise en charge des connexions locales est activée puis recommencez. |
14 | Impossible de localiser ou contrôler le vecteur d'appel de l'API utilisant le descripteur de connexion fourni. | Le descripteur de connexion est incorrect ou un appel de désenregistrement (API BBOA1URG) a invalidé le pool de connexions. | |
24 | Après un appel d'enregistrement réussi, une erreur s'est produite pendant l'obtention d'une connexion à partir du pool de connexions. | Assurez-vous que le serveur est démarré. S'il n'est pas démarré, redémarrez le serveur puis exécutez à nouveau la requête de l'API. | |
34 | Un module de remplacement d'API 64 bits a été utilisé dans un environnement IMS. | Les API 64 bits ne sont pas prises en charge sous IMS. | |
38 | Un module de remplacement d'API 64 bits a été utilisé dans un environnement CICS. | Les API 64 bits ne sont pas prises en charge sous CICS. | |
86 | L'élément BGVT principal de WebSphere Application Server for z/OS n'a pas été trouvé | WebSphere n'a pas encore été démarré sur l'image du système z/OS en cours. Vérifiez que le démon et qu'un noeud/serveur sont démarrés avant de démarrer des processus client des adaptateurs locaux optimisés WebSphere Application Server. | |
88 | La table de modules de remplacement du client principal WebSphere Application Server for z/OS n'a pas été trouvée. | Un serveur WebSphere Application Server a été démarré sur l'image système z/OS en cours mais il n'est pas en cours d'exécution au niveau où la table de modules de remplacement client des adaptateurs locaux optimisés est prise en charge. Il est possible que vous utilisiez une interface de module de remplacement d'adaptateurs locaux optimisés WebSphere Application Server Version 8.0.0.1 qui n'est pas compatible avec le niveau de maintenance du serveur d'applications. Pour utiliser les modules de remplacement des adaptateurs locaux optimisés V8.0.0.1, le serveur d'applications doit également être en cours d'exécution au niveau WebSphere Application Server Version 8.0.0 . Vérifiez que votre application est en cours d'exécution au niveau des modules de remplacement des adaptateurs locaux optimisés compatibles avec WebSphere Application Server sur ce système z/OS. | |
90 | L'emplacement de la table principale de modules de remplacement client des adaptateurs locaux optimisés WebSphere Application Server for z/OS n'a pas été trouvé. | Un serveur WebSphere Application Server a été démarré sur l'image système z/OS en cours mais il n'est pas en cours d'exécution au niveau où la table de modules de remplacement client des adaptateurs locaux optimisés est prise en charge. Il est possible que vous utilisiez une interface de module de remplacement d'adaptateurs locaux optimisés WebSphere Application Server Version 8.0.0.1 qui n'est pas compatible avec le niveau de maintenance du serveur d'applications. Pour utiliser les modules de remplacement des adaptateurs locaux optimisés V8.0.0.1, le serveur d'applications doit également être en cours d'exécution au niveau WebSphere Application Server Version 8.0.0 . Vérifiez que votre application est en cours d'exécution au niveau des modules de remplacement des adaptateurs locaux optimisés compatibles avec WebSphere Application Server sur ce système z/OS. |
Host Service
Service hôte de WebSphere Application Server local. Cette API utilise d'autres fonctions d'API primitives sous-jacentes pour configurer un programme z/OS en langage natif en tant que serveur et cible pour les appels des adaptateurs locaux optimisés émis depuis une instance locale de WebSphere Application Server. Elle s'utilise quand la taille maximum de la zone des requêtes est déjà connue.API | Syntaxe |
---|---|
BBOA1SRV ou BBGA1SRV | BBOA1SRV ( registername, requestservicename, requestservicenamel, requestdata, requestdatalen, connectionhandle, waittime, rc, rsn, rv ) BBGA1SRV ( registername, requestservicename, requestservicenamel, requestdata, requestdatalen, connectionhandle, waittime, rc, rsn, rv ) |
Paramètres :
registername (entrée)Variable ou constante qui contient le nom à utiliser pour rechercher le pool de connexions dont vous voulez extraire une connexion pour cet appel. Il s'agit obligatoirement d'une chaîne de remplissage de 12 caractères.
requestservicename (entrée/sortie)Chaîne de caractères EBCDIC de 256 octets maximum qui indique le nom du service demandé. Il s'agit du nom du service cible spécifié dans InteractionSpec par l'application WebSphere Application Server. La valeur * indique cette configuration comme serveur pour tous les noms de service qui arrivent sous le nom d'enregistrement en cours.
requestservicenamel (entrée/sortie)Entier contenant la longueur du nom de service à démarrer ou 0 (zéro) si le nom de service se termine par null.
requestdata (entrée)Pointeur de 31 bits désignant l'adresse de départ des données de requête reçues. L'espace mémoire désigné par ce pointeur doit correspondre à une clé inscriptible par l'appelant.
requestdatalen (entrée)Valeur non signée de 32 bits en mode 31 bits ou valeur non signée de 64 bits en mode 64 bits contenant la longueur de la zone de données dans laquelle recevoir le message.
connectionhandle (sortie)Descripteur de connexion de 12 octets renvoyé à l'appelant et utilisé pour envoyer une réponse à cette requête.
waittime (entrée)Entier qui indique le délai d'attente (en secondes) d'une connexion avant l'envoi d'un code raison indiquant l'indisponibilité de la connexion demandée. La valeur 0 implique qu'il n'existe pas de délai d'attente et que l'API attend indéfiniment.
rc (sortie)Code retour représenté par un entier qui indique la réussite ou l'échec de cet appel.
rsn (sortie)Code raison représenté par un entier qui indique la raison de l'échec de cet appel.
rv (sortie)Valeur de retour contenant un entier de 32 bits qui indique la taille des données de requête de message reçues et copiées dans la zone de l'appelant.
Remarques relatives à l'utilisation
- Vérifiez que le serveur et le groupe de démons WebSphere Application Server for z/OS spécifiés dans cet appel sont démarrés et que la prise en charge des adaptateurs locaux est activée.
- Vérifiez qu'un appel d'enregistrement (API BBOA1REG ou BBGA1REG) a réussi dans l'espace adresse actif avec un nom correspondant avant d'utiliser cette API.
- Si la valeur du paramètre requestdatalen d'entrée d'appelant API est supérieure à la réponse du message, le code de retour contient 0 et la longueur de message est fournie dans la valeur de retour.
- Le descripteur de connexion renvoyé doit être fourni dans toute réponse à cet appel à l'aide de l'API BBOA1SRP ou BBGA1SRP. Tout nouvel appel de l'API BBOA1SRV ou BBGA1SRVAPI réutilise le même descripteur de connexion. Dans ce cas, l'API suppose qu'il n'existe pas de réponse pour la demande antérieure.
- Important : Quand l'appel Host Service revient à l'appelant, les données du message sont abandonnées et la connexion revient à un état où elle peut être utilisée pour une autre requête d'API.
Code retour | Code motif | Description | Action |
---|---|---|---|
0 | - | Réussi | |
4 | - | Avertissement - voir le code raison | |
8 | - | Erreur - voir le code raison | |
8 | Le jeton du nom d'enregistrement existe déjà. | Assurez-vous que le nom d'enregistrement communiqué est valide. | |
10 | Le descripteur de connexion est libéré. | Assurez-vous que le descripteur de connexion communiqué est valide. | |
12 | Le descripteur de connexion ne figure pas dans la connexion indiquée par le nom d'enregistrement. | Corrigez le programme et recommencez l'appel. | |
16 | La longueur du nom de service de la requête est incorrect. | Corrigez le programme et recommencez l'appel. | |
18 | La longueur de la réponse dépasse les limites du système. | La taille du message dépasse les capacités de prise en charge des messages de WebSphere Application Server. Assurez-vous que la taille est valide. Si la taille est valide, vérifiez que le paramètre de taille de WebSphere Application Server autorise les messages de cette taille. | |
40 | Une erreur de transmission locale s'est produite. | Consultez le journal du serveur WebSphere Application Server pour rechercher les messages liés à une erreur de transmission locale. | |
46 | Une erreur de communication locale s'est produite pendant l'appel de la requête. | Consultez les journaux de WebSphere Application Server pour rechercher la cause de cette erreur. | |
48 | Une erreur de communication locale s'est produite pendant la requête de lecture. | Consultez les journaux de WebSphere Application Server pour rechercher la cause de cette erreur. | |
50 | La connexion avec WebSphere Application Server a été fermée. | Consultez les journaux de WebSphere Application Server pour rechercher la cause de cette erreur. | |
72 | La valeur du paramètre d'entrée de la longueur de réponse est insuffisante pour le message de réponse. | Seule une partie du message est renvoyée. Le reste du message est ignoré. Reportez-vous à la valeur de retour pour connaître la taille du message de réponse. | |
76 | Une tentative de connexion au serveur a échoué car ce serveur n'est plus actif. | Démarrez le serveur et tentez à nouveau d'établir la communication. | |
96 | Cette API ne peut pas être gérée lors de l'initialisation d'IMS ou lors d'un exit de préinitialisation IMS. | Appelez cette API une fois l'initialisation d'IMS terminée. | |
98 | Impossible d'accéder au début de la mémoire tampon de requête fournie. | Vérifiez que l'adresse et la longueur de la mémoire tampon de requête sont correctes. | |
100 | Impossible d'accéder à la fin de la mémoire tampon de requête fournie. | Vérifiez que l'adresse et la longueur de la mémoire tampon de requête sont correctes. | |
12 | 10 | Impossible de localiser le serveur ou le groupe de démons WebSphere Application Server. | Vérifiez que le serveur et le démon WebSphere Application Server sont démarrés et que la prise en charge des connexions locales est activée, puis recommencez. |
14 | Impossible de localiser ou contrôler le vecteur d'appel de l'API utilisant le descripteur de connexion fourni. | Le descripteur de connexion est incorrect ou un appel de désenregistrement (API BBOA1URG ou BBGA1URG) a invalidé le pool de connexions. | |
34 | Un module de remplacement d'API 64 bits a été utilisé dans un environnement IMS. | Les API 64 bits ne sont pas prises en charge sous IMS. | |
38 | Un module de remplacement d'API 64 bits a été utilisé dans un environnement CICS. | Les API 64 bits ne sont pas prises en charge sous CICS. | |
44 | CP build incorrect pour la cellule de service. | ||
46 | CP get incorrect pour la cellule de service. | ||
48 | CP free incorrect pour la cellule de service. | ||
60 | Impossible d'obtenir un verrou SRVQ | ||
62 | Impossible de déverrouiller un verrou SRVQ | ||
86 | L'élément BGVT principal de WebSphere Application Server for z/OS n'a pas été trouvé | WebSphere n'a pas encore été démarré sur l'image du système z/OS en cours. Vérifiez que le démon et qu'un noeud/serveur sont démarrés avant de démarrer des processus client des adaptateurs locaux optimisés WebSphere Application Server. | |
88 | La table de modules de remplacement du client principal WebSphere Application Server for z/OS n'a pas été trouvée. | Un serveur WebSphere Application Server a été démarré sur l'image système z/OS en cours mais il n'est pas en cours d'exécution au niveau où la table de modules de remplacement client des adaptateurs locaux optimisés est prise en charge. Il est possible que vous utilisiez une interface de module de remplacement d'adaptateurs locaux optimisés WebSphere Application Server Version 8.0.0.1 qui n'est pas compatible avec le niveau de maintenance du serveur d'applications. Pour utiliser les modules de remplacement des adaptateurs locaux optimisés V8.0.0.1, le serveur d'applications doit également être en cours d'exécution au niveau WebSphere Application Server Version 8.0.0 . Vérifiez que votre application est en cours d'exécution au niveau des modules de remplacement des adaptateurs locaux optimisés compatibles avec WebSphere Application Server sur ce système z/OS. | |
90 | L'emplacement de la table principale de modules de remplacement client des adaptateurs locaux optimisés WebSphere Application Server for z/OS n'a pas été trouvé. | Un serveur WebSphere Application Server a été démarré sur l'image système z/OS en cours mais il n'est pas en cours d'exécution au niveau où la table de modules de remplacement client des adaptateurs locaux optimisés est prise en charge. Il est possible que vous utilisiez une interface de module de remplacement d'adaptateurs locaux optimisés WebSphere Application Server Version 8.0.0.1 qui n'est pas compatible avec le niveau de maintenance du serveur d'applications. Pour utiliser les modules de remplacement des adaptateurs locaux optimisés V8.0.0.1, le serveur d'applications doit également être en cours d'exécution au niveau WebSphere Application Server Version 8.0.0 . Vérifiez que votre application est en cours d'exécution au niveau des modules de remplacement des adaptateurs locaux optimisés compatibles avec WebSphere Application Server sur ce système z/OS. |
API des adaptateurs JCA
- ConnectionSpec
- InteractionSpec
- Record I/O
L'objet ConnectionSpec indique le nom d'enregistrement avec lequel vous devez communiquer. Le nom d'enregistrement est créé par l'API Register. Il indique également le sous-système auquel vous devez vous connecter. Un sous-système peut avoir plusieurs noms d'enregistrement.
Le nom de l'ID de transaction Program Link peut être communiqué par WebSphere Application Server au service CICS et il est utilisé pour exécuter la tâche d'appel de Program Link. Ce nom doit comporter quatre caractères et être défini dans la région CICS. Vous devez le définir avec les mêmes attributs et le même nom de programme que la transaction BBO# (programme : BBOACLNK). Quand cet ID de transaction est communiqué avec la méthode setLinkTaskTranid, il remplace l'API BBO# et tout ID de transaction spécifié via BBOC avec le paramètre LTX=xxx.
Vous pouvez utiliser la méthode setUseCICSContainer ou l'interface JCA MappedRecord pour envoyer des applications à CICS à l'aide de canaux et de conteneurs.
- La méthode setUseCICSContainer est fournie dans ConnectionSpecImpl.
Quand la valeur est 1, le nom et le type d'un conteneur CICS de requête de message peuvent être communiqués à CICS à l'aide des méthodes setLinkTaskReqContid() et setLinkTaskReqContType(0|1), où 0=CHAR et 1=BIT. Lorsque ce conteneur de requête de message CICS est transmis à
CICS, les données d'entrée du programme cible sont transmises dans le conteneur désigné, qui est créé avec le type sélectionné, BIT ou CHAR.
Le nom et le type d'un conteneur CICS de réponse de message peuvent être communiqués à CICS à l'aide des méthodes setLinkTaskRspContid() et setLinkTaskRspContType(bit|char). Dans ce cas, la réponse du programme cible est attendue du conteneur désigné, avec le type sélectionné, BIT ou CHAR.
- L'interface JCA MappedRecord permet de transmettre un ou plusieurs conteneurs à CICS. Lorsque vous utilisez l'interface JCA MappedRecord, le canal nommé est utilisé pour communiquer avec le programme cible. Si vous utilisez l'interface MappedRecord, vous devez définir UseCICSContainer sur 1, et nom et le type d'un canal CICS doit être
transmis à CICS à l'aide des méthodes setLinkTaskChanID() et setLinkTaskChanType(bit|char).
Eviter les incidents: L'interface JCA MappedRecord utilisée pour transmettre des conteneurs à CICS est obtenue en appelant la méthode recordFactory.createMappedRecord(), à l'aide de l'élement recordFactory extrait de l'objet connexion WOLA. N'utilisez pas la méthode setLinkTaskReqContId(), setLinkTaskReqContType(), setLinkTaskRspContId() ou SetLinkTaskRspContType() avec l'interface JCA MappedRecord.gotcha
Pour les transactions d'application IMS, utilisez la méthode setOTMAMaxRecvSize(nnn) dans la spécification de connexion pour définir la taille maximale de réception des messages. Pour définir le niveau de connexion de Segments maximum, utilisez la méthode setOTMAMaxSegments(nnn) dans la spécification de connexion. Pour plus d'informations sur l'utilisation des adaptateurs locaux optimisés avec IMS sur OTMA, voir la rubrique Appels de transactions IMS existantes avec des adaptateurs locaux optimisés sur OTMA.
InteractionSpec
L'API InteractionSpec permet de spécifier le service à démarrer par la cible. Cela dépend du sous-système ou du processus par lot démarré. Le processus peut choisir de recevoir les requêtes d'un seul service ou de n'importe quel service. Pour CICS, le nom de service est le nom du programme à démarrer dans CICS.
Record I/O
Les applications peuvent transmettre et recevoir des données vers et à partir de l'adaptateur à l'aide de l'interface d'enregistrement JCA. Cette API d'adaptateur permet à l'appelant d'utiliser l'interface d'enregistrement indexée pour transmettre une ou plusieurs structures de données à l'espace d'adressage externe, par exemple des structures C et des fichiers de stockage COBOL. Chaque index de la liste est traité comme un fichier de stockage séparé et transmis au système cible dans l'ordre correspondant.
Quand vous l'utilisez pour accepter des paramètres renvoyés par un appel de fonction, l'objet IndexedRecordImpl peut être prédéfini pour accepter un nombre précis de paramètres et les noms de classe générés par les outils d'assemblage pour chaque fichier de stockage et chaque structure peuvent être fournis. L'objet IndexedRecordImpl remplit les structures et les fichiers de stockage sérialisés et les définit de manière qu'ils puissent être extraits et utilisés sans devoir gérer leurs représentations binaires sérialisées.
Pour donner une idée générale du fonctionnement de cette API, quelques méthodes seulement ont été sélectionnées ici. Toutefois, toutes les méthodes disponibles dans l'interface sont implémentées.