[z/OS]

Transactions BBOC, BBO$ et BBO# de WebSphere Application Server

Cette rubrique explique comment les adaptateurs locaux optimisés sont pris en charge dans le produit CICS (Customer Information Control System), notamment avec les nouvelles transactions pour WebSphere Application Server, BBOC, BBO$ et BBO#.

L'adaptateur est conçu pour s'exécuter dans une région CICS en tant que gestionnaire de ressources. Dans CICS, l'exit utilisateur associé à une tâche (Task Related User Exit - TRUE) est le principal programme pour les fournisseurs de ressources. La prise en charge de TRUE définit la limite entre les unités d'exécution de l'application CICS et celles du gestionnaire de ressources externe. Actuellement, les sockets DB2, WebSphere MQ et TCP/IP sont utilisés dans CICS avec la prise en charge de TRUE. Les adaptateurs locaux optimisés prennent en charge le programme TRUE.

Les applications qui s'exécutent dans CICS exploitent les API des adaptateurs locaux optimisés en appelant les routines de raccord fournies. Ces routines de raccord démarrent le module de l'interface du gestionnaire de ressources CICS et lui transmettent le nom de la routine TRUE de l'adaptateur local optimisé ainsi que les paramètres spécifiques à chaque API. CICS affecte la routine TRUE à l'un des TCB OPENAPI gérés par CICS et s'exécute jusqu'à la fin de l'appel d'API. Ensuite l'appel revient dans CICS avec les paramètres de sortie. La prise en charge de TRUE par CICS autorise également les notifications au delà des limites des transactions, par exemple quand une application s'arrête de manière anormale ou envoie un appel SYNCPOINT explicite à CICS. Pour plus d'informations sur l'utilisation de cette prise en charge pour la propagation du contexte des transactions vers WebSphere Application Server et sur la validation en deux phases, voir la section "Propagation des transactions" dans cette rubrique. De plus, pour CICS, il existe un programme PLTPI (Program List Table Post-Initialization) qui permet de démarrer automatiquement le programme TRUE en même temps que CICS. Si vous n'utilisez pas ce programme PLTPI, vous pouvez utiliser la transaction CICS nommée BBOC à la place. Cette transaction permet de démarrer, arrêter, activer et désactiver la trace pour le module TRUE.

Transaction de contrôle BBOC de WebSphere Application Server pour CICS

La transaction BBOC est l'outil de contrôle WebSphere (transaction d'opération) lié à la prise en charge des adaptateurs dans CICS. Cette transaction permet de démarrer et d'activer la routine TRUE de WebSphere Application Server et de définir les niveaux de trace appliqués au débogage des API et du code interfacé par WebSphere Application Server. BBOC définit également des enregistrements et des désenregistrements, et démarre et arrête les tâches du serveur WebSphere Application Server Link dans CICS. Ces tâches de serveur permettent de démarrer les programmes CICS existants et de transmettre des données dans des zones de communication (COMMAREA) ou des conteneurs avec des paramètres d'entrée via les adaptateurs. Il s'agit d'une transaction CICS basée sur terminal qui peut être exécutée sur un terminal 3270 ou sur un terminal séquentiel de type SDSCI. La syntaxe de la transaction BBOC est la suivante :

BBOC<nom_opération><paramètres séparés par un ou plusieurs espaces>.

Les paramètres sont les suivants :
  • Nom d'enregistrement (RGN)

    Nom d'enregistrement à 12 caractères.

  • Nom du groupe de démons (DGN)

    Nom de groupe de démons à huit caractères utilisé pour s'enregistrer.

  • Link Sync-on-return - LSYNC

    LSYNC détermine si l'option SYNCONRETURN est utilisée lors de la liaison au programme cible sous le serveur de liaison. Lorsque LSYNC=Y, l'option SYNCONRETURN est envoyée à CICS lorsque le programme cible est lié, et utilise EXEC CICS LINK. Cette option peut être nécessaire lorsque le programme cible se trouve dans une autre région CICS. La valeur par défaut est LSYNC=N.

  • Nom abrégé du noeud (NDN)

    Nom abrégé du noeud à huit caractères utilisé pour s'enregistrer.

  • Nom abrégé du serveur (SVN)

    Nom abrégé du serveur cible à huit caractères.

  • Nom du service (SVC)

    Nom du service comportant au plus 8 caractères. Ce nom peut être masqué par le caractère "*" (astérisque). Les valeurs admises sont par exemple *, abc*, *abc, abc*xyz, abc*xy*z, etc.

  • Connexions minimales (MNC)

    Indique le nombre minimum de connexions. La valeur minimum est 0. La valeur par défaut est 1 si vous n'indiquez pas d'autre valeur.

  • Connexions maximales (MXC)

    Indique le nombre maximum de connexions. La valeur maximale est 99999. La valeur par défaut est 10 si vous n'indiquez pas d'autre valeur.

  • Propagation de la sécurité (SEC)

    Active ou désactive la propagation des paramètres de sécurité. La valeur est Y ou N pour oui ou non. La valeur par défaut est SEC=N. Si SEC=N, dans le cas d'un appel de CICS versWebSphere Application Server, l'ID utilisateur de la région CICS est propagé. Si SEC=N, dans le cas d'un appel de WebSphere Application Server vers CICS exécuté avec le serveur Link (tâche BBO$), la tâche Link s'exécute avec l'ID utilisateur soumis pour démarrer le serveur Link. Si SEC=Y, dans le cas d'un appel de CICS vers WebSphere Application Server, l'ID utilisateur du niveau tâche est propagé vers WebSphere Application Server. Si SEC=Y, dans le cas d'un appel de WebSphere Application Server vers CICS, le serveur Link essaie de démarrer la tâche BBO# avec l'ID utilisateur propagé depuis WebSphere Application Server. Cela fonctionne uniquement si SURROGAT SAF a été configuré de telle manière que l'ID utilisateur utilisé par le serveur Link lui permette d'exécuter la commande EXEC CICS START TRAN('BBO#') USERID(<ID propagé>).

  • TXN

    TXN décrit le comportement transactionnel de l'enregistrement généré par la transaction BBOC.

    Lorsque BBOC crée un enregistrement à l'aide de l'opération REGISTER, TXN=Y signifie que les applications Java Platform, Enterprise Edition démarrées dans WebSphere Application Server à l'aide de cet enregistrement doivent être associées à l'unité de travail CICS actuelle. Cela crée une transaction globale entre CICS et WebSphere Application Server, qui s'achève en utilisant le protocole de validation en deux phases lorsque l'application CICS lance une commande EXEC CICS SYNCPOINT ou lorsqu'un point de synchronisation est impliqué, par exemple à la fin de l'exécution de la tâche CICS.

    Lorsque BBOC est utilisé pour créer un serveur Link à l'aide de la fonction START_SRVR, TXN=Y signifie que la tâche du serveur CICS Link doit être associée à la transaction WebSphere Application Server en cours en cas d'appel d'un service. Par exemple, si une application Java Platform, Enterprise Edition démarre une transaction locale du gestionnaire de ressources (RMLT) et appelle un programme CICS à l'aide du connecteur JCA des adaptateurs locaux optimisés, la tâche de liaison est associée à la transaction locale et appelle le programme CICS cible. Les mises à jour apportées au programme CICS ne sont pas validées ou annulées jusqu'à ce que l'application Java Platform, Enterprise Edition complète la transaction locale du gestionnaire de ressources à l'aide de l'API de validation ou d'annulation.

  • ID de transaction CICS du serveur Link - STX

    Nom de quatre caractères correspondant à l'ID de transaction CICS du serveur Link que vous devez utiliser. La valeur par défaut de STX est BBO$.

  • ID de transaction de tâche Link (LTX)

    Nom de quatre caractères correspondant à l'ID de transaction CICS du programme Link que vous devez utiliser. La valeur par défaut de LTX est BBO#. Si ces noms de transaction sont remplacés par des noms fournis par l'utilisateur, ils doivent être définis avec les mêmes attributs et les mêmes noms de programme que BBO$ (pour STX) et BBO# (pour LTX).

  • Trace (TRC)
    La trace est activée et définie pendant le traitement de toutes les commandes répertoriées dans le tableau. Il existe trois niveaux de trace possibles :
    • 0 = aucune trace, messages d'erreur uniquement
    • 1 = trace de base
    • 2 = trace détaillée
  • File d'attente de données transitoires (TDQ)

    Les données de trace de CICS sont enregistrées dans une file d'attente de données transitoires demandée et installée dans une partition supplémentaire. Le paramètre TDQ indique le nom à quatre caractères de la file d'attente de données transitoires CICS dans laquelle les messages des adaptateurs doivent être enregistrés. Si vous n'indiquez pas de valeur, les valeurs par défaut sont BBOQ et DD BBOOUT. En cas d'incident lors d'une écriture dans la file d'attente de données transitoires sélectionnée, les messages sont alors envoyés vers la sortie standard de la région CICS (tdq CESO dd CEEOUT).

  • Reuse - REU
    S'il est établi que le serveur Link peut s'exécuter avec le paramètre SEC=N, vous optimiserez les performances en l'exécutant également avec le paramètre REU=Y BBOC START_SRVR. Avec REU=Y, le serveur Link peut réutiliser les tâches d'appel Program Link (transactions BBO#) entre deux requêtes d'appel de programme.
    Important : Si vous exécutez le serveur Link dans cette configuration, la prise en charge JCA des adaptateurs locaux optimisés, qui permet de communiquer un ID de transaction LINK pour chaque requête, est désactivée. Si une application émet une telle requête, une exception de type ResourceException lui sera renvoyée. De plus, si vous tentez de sélectionner REU=Y et SEC=Y, l'option de réutilisation prend la valeur Non car le serveur Link doit démarrer une nouvelle tâche Program Link pour chaque requête avec l'identité propagée et appliquée.
  • Reuse count - REUC
    Entrez le nombre de demandes pendant lesquelles la tâche CICS Link (BBO#) reste active et est réutilisée. Lorsque ce nombre est atteint, la tâche Link s'arrête. La valeur maximale est 2147483648.
    Important : Pour un scénario transactionnel, la tâche Link s'arrête une fois que ce nombre est atteint et que la prochaine validation est reçue du serveur d'applications.
  • Reuse time - REUT
    Entrez le nombre de secondes pendant lesquelles la tâche CICS Link (BBO#) reste active et est réutilisée. Lorsque ce délai est arrivé à expiration, une fois que la prochaine demande est reçue et traitée, la tâche Link s'arrête. La valeur maximale est 2147483648.
    Important : Pour un scénario transactionnel, la tâche Link s'arrête une fois que le délai demandé est atteint et que la prochaine validation est reçue du serveur d'applications.
  • List Link Servers Temporary Storage queue name - LTSQ

    LTSQ ne s'applique qu'à l'opération LIST_SRVR. LTSQ est le nom d'une file de stockage temporaire CICS dans laquelle la liste des serveurs Link et les informations relatives à chacun sont enregistrées. Il peut s'agir d'une chaîne d'une longueur maximale de huit caractères. Un fichier d'en-tête C indiquant le format des enregistrements en sortie est fourni dans /<racine_install>/AppServer/util/zos/OLASamples/bboaapic.h et décrit sous le struct tsq_record.

Tableau 1. BBOC. Le tableau suivant répertorie les noms, descriptions et paramètres des opérations BBOC.
Nom de l'opération Abréviation Abréviation,

Description

Paramètres
START_TRUE STR Démarre le programme TRUE de WebSphere Application Server TRC=0/1/2

TDQ=<nom_tdq

STOP_TRUE PTR Arrête le programme TRUE de WebSphere Application Server TRC=0/1/2

TDQ=<nom_tdq

REGISTER REG Exécute un enregistrement sur le serveur, le noeud et le groupe de démons des adaptateurs locaux optimisés de WebSphere Application Server RGN=<nom>

DGN=<nom>

NDN=<nom>

SVN=<nom>

MNC=<nombre_minimal_de_connexions>

MXC=<nombre_maximal_de_connexions>

SEC=<yes|no>

TXN=<yes|no>

TRC=0|1|2

TDQ=<nom_tdq

UNREGISTER   Exécute un désenregistrement sur les adaptateurs locaux optimisés de WebSphere Application Server RGN=<nom>
START_SRVR STA Démarre la tâche WebSphere Application Server demandée pour le nom d'enregistrement communiqué. RGN=<nom>

DGN=<nom>

NDN=<nom>

SVC=<nom>

SVN=<nom>

MNC=<nombre_minimal_de_connexions>

MXC=<nombre_maximal_de_connexions>

SEC=<yes|no>

STX=<ID_transaction_serveur_liaisons_CICS>

LTX=<ID_transaction_serveur_liaisons_CICS>

TRC=0|1|2

TDQ=<nom_tdq

REU=<yes|no>

REUC=<nombre_de_demandes>

REUT=<nombre_de_secondes>

STOP_SRVR STP Arrête la tâche WebSphere Application Server demandée pour le nom d'enregistrement communiqué. RGN=<nom>

TRC=0/1/2

TDQ=<nom_tdq

LIST_SRVR LST Répertorie tous les serveurs Link correspondant au nom d'enregistrement transmis. Ici, les paramètres sont tous facultatifs, y compris le nom d'enregistrement. Si cette opération est exécutée sans paramètre, elle renvoie une liste de tous les serveurs Link. Vous pouvez également transmettre le paramètre RGN avec des caractères génériques. Un astérisque (*) indique que tous les caractères qui suivent sont valides et un point d'interrogation (?), que tout caractère peut être utilisé. La sortie de l'opération LIST_SRVR est enregistrée dans la file BBOQ ou dans la file d'attente de données transitoires désignée par le paramètre TDQ. Si le paramètre LTSQ est transmis, la liste des serveurs Link actifs est enregistrée dans la file de stockage temporaire CICS désignée. RGN=<nom>

LTSQ=<nomtsq>

TRC=<0/1/2>

TDQ=<nom_tdq

Exécution automatique d'une commande BBOC au lancement et à l'arrêt de CICS

Vous pouvez démarrer automatiquement un serveur Link d'adaptateurs locaux optimisés au démarrage de CICS. Une tâche BBO$ de longue durée démarre et se maintient jusqu'à l'arrêt du serveur Link. Pour exécuter les commandes BBOC au démarrage de CICS, deux programmes PLTPI (Program List Table Post-Initialization) CICS sont fournis dans la bibliothèque de chargement créée par le script copyZOS.sh. Cette bibliothèque de chargement peut être utilisée pour exécuter les commandes BBOC au lancement de CICS. Ajoutez BBOACPLT à votre table PLT CICS comme entrée de phase 2 ou 3 si vous voulez activer l'exit utilisateur associé à une tâche (TRUE) des adaptateurs locaux optimisés au moment du lancement de CICS.

Le deuxième programme PLTPI s'appelle BBOACPL2. Quand vous l'ajoutez à votre table PLT (en phase 2 ou 3 également), il exécute une commande BBOC au lancement de CICS avec des données INITPARM. Vous pouvez insérer une chaîne de commandes (limitée à 60 caractères par CICS ) dans l'élément INITPARM. L'exemple de chaîne INITPARM suivant appelle la commande BBOACPL2 et transmet une requête pour démarrer un serveur Link sous le nom d'enregistrement 'PAYROLL', avec le nom de groupe de démons 'DAE1', le nom de noeud 'NODE1' et le nom de serveur 'SERVER1'. Ce serveur Link réceptionne les requêtes pour tous les noms de service (SVC=*) :
INITPARM=(BBOACPL2='STA RGN=PAYROLL DGN=DAE1 NDN=NODE1 SVN=SERVER1 SVC=*') 
The command string can be any BBOC command. If you want to set up a registration with the name WASAPP that consists of 10 minimum connections and 100 maximum during CICS startup, you specify the following:
INITPARM=(BBOACPL2='REG RGN=WASAPP DGN=DAE1 NDN=NODE1 SVN=SERVER1 MNC=10 MXC=100')
With this, you must not use the Register API in your applications and instead use the other APIs immediately, for example Invoke, Connection Get, and Send Request and so on.
Important : There is a CICS limitation in that there can only be one INITPARM per program (BBOACPL2). Therefore, you can do this once in the CICS startup parameters.

The source and JCL for the BBOACPLT and BBOACPL2 provided PLTPI programs is provided in /<install_root>/AppServer/util/zos/OLASamples as files bboacplt.jclsamp and bboacpl2.jclsamp. There is another sample PLTPI program also provided. /<install_root>/AppServer/util/zos/OLASamples/bboacpl3.jclsamp provides an example that shows how to issue multiple BBOC commands during CICS start-up.

There is also sample JCL showing how to assemble your PLT with these programs included in /<install_root>/AppServer/util/zos/OLASamples/DFHPLTOL.jclsamp.

Stopping Link Servers during CICS Shut-down

There is a need to unregister and stop any running Link Servers before CICS shutdown, otherwise normal shutdown may be unable to proceed. You can do one of the following to unregister and stop a Link Server before/during CICS shutdown:

  • Run BBOC STOP_SERVER for all CICS Link servers before CICS shutdown
  • Add the IBM® provided Program List Table shutdown (PLTSD) program BBOACPLS to your shutdown PLT. This PLTSD executes a BBOC LIST_SRVR to identify all running Link Servers in the region and it will then issue a STOP_SRVR operation for each of them. A sample JCL showing how to add this to your PLT shutdown list is provided in /<install_root>/AppServer/util/zos/OLASamples/DFHPLTO2.jclsamp
  • Purge the BBO$ tasks
  • Write your own PLT shutdown program that EXEC CICS LINKs to BBOACNTL for each Link server by passing the STOP_SERVER string
  • Issue CEMT P SHUT,IMMED

Running a BBOC command from a program by using EXEC CICS LINK PROGRAM('BBOACNTL')

You can drive BBOC operations from your programs by using EXEC CICS LINK PROGRAM('BBOACNTL') and passing the command string in the COMMAREA. If the length of the command string in the passed COMMAREA is fewer than 268 characters, you are returned a string that contains the result of the execution of the command only. If the length is equal or greater than 268 characters, BBOC/BBOACNTL provides an integer version, integer return code, and integer reason code in the bytes 256 - 268. Here is the structure of the Version 1 returned area:

/* Version 1 DFHCOMMAREA - for EXEC CICS LINK to BBOACNTL */

 struct inputCommarea {
   char command[256];
 };

 struct outputCommarea_v1 {
   char message[256];
   int version;
   int returnCode;
   int reasonCode;
 };

 struct BBOACNTL_Commarea {
   union {
     struct inputCommarea input;
     struct outputCommarea_v1 output;
   };
 };

Si une zone de communication (COMMAREA) supérieure ou égale à 268 octets est transmise en entrée à BBOACNTL, elle reçoit un message de réponse dans les premiers 256 octets, suivi de la zone indiquée précédemment avec la version, le code retour et le code motif de l'opération exécutée par BBOC/BBOACNTL. Les codes retour et codes motifs suivants sont pris en charge par la commande EXEC CICS LINK envoyée à BBOACNTL :

RC 0 RSN 0
	Request process successfully. Le message de réponse dans les 256 premiers octets fournit des informations
supplémentaires. Pour plus d'informations sur la réponse,
recherchez l'ID du message renvoyé dans le centre de documentation.
RC 4 RSN 0
   No Link Servers match the requested registration name or no Link Servers are running in this region. Le message de réponse dans les 256 premiers octets fournit des informations
supplémentaires. Search the Information Center with the returned message id for further information about the response.
RC 8 RSN 0 or higher
   An error occurred in processing the request. The response message in the first 256 bytes provides more information. Search the Information Center with the returned message id for further information about the response.
RC 12 RSN 0 or higher
   An severe error occurred in processing the request. The response message in the first 256 bytes provides more information. Search the Information Center with the returned message id for further information about the response.

Lorsque le paramètre LTSQ est transmis dans la chaîne de commande pour l'appel EXEC CICS LINK vers BBOACNTL, la liste des serveurs Link actifs correspondants est écrite dans la file de stockage temporaire CICS transmise via le paramètre LTSQ. Le format d'enregistrement de sortie de chaque serveur Link de la liste est indiqué dans l'en-tête du fichier /<racine_installation>/AppServer/util/zos/OLASamples/bboaapic.h et décrit sous le struct tsq_record.

Tâche BB0$ du serveur Link de WebSphere Application Server pour CICS

La transaction CICS nommée BBO$ permet de prendre en charge les appels sortants de WebSphere Application Server à CICS. Elle s'exécute en arrière-plan comme une transaction hors terminal et représente une instance d'une tâche de serveur démarrée par la commande BBOC START_SRVR sous un nom de service et un nom d'enregistrement spécifiés par l'utilisateur. Cette tâche de serveur peut exécuter des appels LINK à des programmes ou démarrer un programme CICS depuisWebSphere Application Server via les API des adaptateurs locaux optimisés. Le nom de cette transaction peut être remplacé par un nom fourni par l'utilisateur dans la commande BBOC START_SRVR (STX=xxxx). Dans ce cas, le nom de transaction fourni doit être défini dans CICS avec le même nom de programme et les mêmes attributs que la transaction BBO$.

Tâche d'appel LINK de programme BBO# de WebSphere Application Server pour CICS

La transaction CICS nommée BBO# permet de prendre en charge les appels sortants de WebSphere Application Server à CICS. Il s'agit d'une transaction hors terminal qui représente une instance d'une tâche démarrée par la tâche de serveur des adaptateurs de WebSphere Application Server BBO$ en vue d'exécuter un appel LINK de programme. La transaction BBO$ initialise une transaction BBO# pour chaque requête de liaison de programme CICS émanant d'une application déployée dans WebSphere Application Server.

Le nom de cette transaction peut être remplacé par un nom fourni par l'utilisateur dans la commande BBOC START_SRVR, par exemple LTX=xxxx. Dans ce cas, le nom de transaction fourni doit être défini dans CICS avec le même nom de programme et les mêmes attributs que la transaction BBO#. Alternativement, le nom à 4 caractères de la transaction de liaison peut être transmis à partir de WebSphere Application Server par l'application qui utilise le JCA. Dans ce cas, l'application qui utilise l'adaptateur doit utiliser la méthode setLinkTaskTransid pour ce faire.

Assertion de l'identité de l'utilisateur à partir de WebSphere Application Server versCICS

Cette tâche de serveur permet de propager l'identité d'un utilisateur à partir d'un appel de WebSphere Application Server vers CICS et de vérifier cette identité. L'assertion n'est possible que si la tâche Register a été exécutée avec le paramètre de sécurité SEC=Y. Elle s'implémente via la commande EXEC CICS START TRANSACTION(‘BBO#') USERID(<ID_utilisateur>).

Vous devez créer une définition de classe SAF SURROGAT pour vous assurer que l'ID utilisateur sous lequel s'exécute la transaction BBO$ a les droits requis pour lancer une transaction pour le compte de l'ID utilisateur communiqué.

Si vous exécutez BBOC STRT_SRVR avec SEC=N, l'ID utilisateur associé aux demandes entrantes vers CICS est celui qui a exécuté la transaction BBOC.

Exemples d'appel BBOC

Voici quelques exemples d'appel de commande BBOC qui illustrent comment accomplir différentes tâches et configurations avec les liaisons de programme des adaptateurs CICS.
  • Démarrez le programme TRUE de CICS TRUE des adaptateurs.

    bboc start_true

  • Arrêtez le programme TRUE de CICS des adaptateurs.

    bboc stop_true

  • Exécutez un enregistrement sous le nom CICS-HR1, dans le groupe de démons SY1, avec le noeud SY1, le serveur BBOS001, pour un maximum de 10 connexions et un minimum de 5 connexions. Affectez au paramètre TXN la valeur no et indiquez yes pour la propagation des paramètres de sécurité (SEC).

    bboc register rgn=CICS-HR1 svn=bbos001 dgn=sy1 ndn=sy1 mnc=5 mxc=10 txn=n sec=y

  • Exécutez un désenregistrement sous le nom CICS-HR1.

    bboc unregister rgn=CICS-HR1

  • Démarrez une transaction de serveur BBO$ pour tous les noms de programme et de service, sous le nom d'enregistrement CICSPAYR, avec un groupe de démons, un noeud et un serveur, et avec 10 connexions maximales et 5 connexions minimales. Affectez au paramètre TXN la valeur no et indiquez yes pour la propagation des paramètres de sécurité (SEC).

    bboc start_srvr rgn=CICSPAYR svn=bbos001 dgn=sy1 ndn=sy1 mnc=5 mxc=10 sec=y

  • Arrêtez la transaction de serveur BBO$ exécutée sous le nom d'enregistrement CICSPAYR.

    bboc stop_srvr rgn=CICSPAYR

  • Démarrez une transaction de serveur BBO$ pour tous les noms de programme et de service commençant par PAYR, sous le nom d'enregistrement CICSPAY1, avec un groupe de démons, un noeud et un serveur, et avec 10 connexions maximales et 5 connexions minimales. Affectez au paramètre TXN la valeur no et indiquez yes pour la propagation des paramètres de sécurité (SEC).

    bboc start_srvr rgn=CICSPAY1 svn=bbos001 dgn=sy1 ndn=sy1 mnc=5 mxc=10 sec=y svc=PAYR*

  • Démarrez une transaction de serveur sous l'ID de transaction PAY2 et exécutez un enregistrement sous le nom PAYROLL2, pour tous les noms de programme et de service, dans un groupe de démons, un noeud et un serveur, et avec 10 connexions maximales et 5 connexions minimales. Affectez au paramètre TXN la valeur yes, indiquez yes pour la propagation des paramètres de sécurité et réglez le niveau de trace sur 1.

    bboc start_srvr rgn=PAYROLL2 svn=bbos001 dgn=sy1 ndn=sy1 mnc=5 mxc=10 sec=y stx=PAY2 trc=1

  • Démarrez une transaction de serveur sous l'ID de transaction PAY3 et l'ID de transaction de liaison PY3L. Exécutez un enregistrement sous le nom PAYROLL3, pour tous les noms de programme et de service commençant par PAYRL3, dans un groupe de démons, un noeud et un serveur, avec 10 connexions maximales et 5 connexions minimales. Affectez au paramètre TXN la valeur yes, indiquez yes pour la propagation des paramètres de sécurité et réglez le niveau de trace sur 1.

    bboc start_srvr rgn=PAYROLL3 svn=bbos001 dgn=sy1 ndn=sy1 mnc=5 mxc=10 sec=y svc=PAYRL3* stx=PAY3 ltx=PY3L trc=1

  • Répertoriez tous les serveurs Link en cours d'exécution dans cette région CICS

    bboc list_srvr

  • Répertoriez tous les serveurs Link en cours d'exécution dans cette région CICS, avec le nom d'enregistrement CICSPAY1

    bboc list_srvr rgn=CICSPAY1

  • Répertoriez tous les serveurs Link en cours d'exécution dans cette région CICS, dont le nom d'enregistrement commence par CICS, et copiez la liste dans une file de stockage temporaire appelée MYSRVRS

    bboc list_srvr rgn=CICS* ltsq=MYSRVRS

  • Répertoriez tous les serveurs Link en cours d'exécution dans cette région CICS, dont le nom d'enregistrement commence par 'CICS', suivi de tout caractère, puis de 'ZZZ' et enfin de tous autres caractères

    bboc list_srvr rgn=CICS?ZZZ*

Prise en charge des objets de conteneur et des canaux de CICS

Pour les messages supérieurs à 32 ko, les applications CICS démarrées à partir de WebSphere Application Server doivent être en mesure de recevoir des données et d'y répondre au moyen des conteneurs et des canaux de CICS. Les applications déployées dans WebSphere Application Server peuvent utiliser l'interface de programmation JCA fournie pour indiquer le nom et le type (BIT|CHAR) du conteneur CICS qui transmet les données au programme cible, ainsi que le nom et le type du conteneur qui reçoit la réponse de l'application.

Vous pouvez transmettre des canaux et des conteneurs à CICS de deux manières. Dans les deux cas, la méthode setUseCICSContainer() dans ConnectionSpecImpl doit être définie sur '1'.
  • Lorsque vous transmettez et recevez un seul conteneur, les méthodes setLinkTaskReqContid, setLinkTaskRspContid, setLinkTaskReqContType(bit|char) et setLinkTaskRspContType(bit|char) peuvent être utilisées. Pour la requête et la réponse, le nom de canal utilisé est IBM-WAS-ADAPTER. Ce nom de canal est fixe.
  • Vous pouvez également utiliser l'interface JCA MappedRecord pour envoyer ou recevoir un ou plusieurs conteneurs vers ou depuis un programme cible CICS. Lorsque vous utilisez MappedRecord, servez-vous des méthodes setLinkTaskChanID() et setLinkTaskChanType() de ConnectionSpecImpl pour définir le nom de canal qui permettra de stocker les conteneurs de demande et de réponse, ainsi que le type de ces conteneurs (BIT ou CHAR).

    Les noms des différents conteneurs de demande sont définis en ajoutant des données à MappedRecord, à l'aide de la méthode put().

    Les clés de MappedRecord représentent les noms de conteneur CICS et les valeurs correspondantes sont utilisées pour remplir le conteneur dans CICS. La clé doit être un objet de type chaîne (String) d'une longueur de 1 à 16 caractères. La valeur peut être un objet byte[] ou RecordBytes généré à l'aide d'outils tels que Rational Application Developer.

    Les noms de conteneur de réponse sont extraits du canal une fois la demande CICS terminée, et remplis dans un nouveau MappedRecord qui est renvoyé au client.


Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rdat_cics
Nom du fichier : rdat_cics.html