Définir les ressources et démarrer leCICS Agent du serveur de transactions

Pour compléter leCICS® Lors de l'installation de l'Agent Transaction Server, vous devez définir un certain nombre de ressources dans leCICS région.

ConfigurerCICS Agent DPL (Distributed Program Link) pour utiliser HTTPS. Pour plus de détails, voir Configuration de l'agent CICS® Distributed Program Link (DPL) pour utiliser HTTPS.
Note:
Pour plus d’informations, consultez le membre README inclus dans l’ensemble de données RIT.CICS.PROC.
LeCICS L'agent Transaction Server comporte deux parties.
  • PlusieursCICS programmes et ressources qui doivent être définis dans leCICS région à intercepter.
  • Le service batch RITAGENT. Le service batch doit être exécuté sur le même z/OS® système comme l'interceptéCICS région ou dans un environnement z/OS système au sein du SYSPLEX qui exécute le message interceptéCICS région.
Notes:
  • Un seul RITAGENT peut être exécuté pour unCICS région. N'essayez pas d'exécuter plusieurs tâches RITAGENT pour un seulCICS région. Autrement dit, n'exécutez pas le deuxième RITAGENT sur le mêmeCICS région même dans un z/OS différent système dans un environnement SYSPLEX.
  • SiCICS est redémarré, vous devez redémarrer leCICS Agent afin qu'il se reconnecte à la nouvelle instance deCICS.

Un RITAGENT ne peut fonctionner que pour un seulCICS région. Vous pouvez exécuter plusieurs tâches RITAGENT si vous devez intercepter plusieursCICS Régions. Au sein d'un système, chaque nom de travail RITAGENT doit être unique.

Le IBM DevOps Test Integrations and APIs (Test Integrations and APIs)CICS Besoins des agentsEnvironnement linguistique® prise en charge, TCP/IP, EXCI et l'ensemble de données intrapartition à configurer.

Pour plus d'informations sur l'installationEnvironnement linguistique soutien, voir InstallationEnvironnement linguistique Soutien.

Pour plus d'informations sur l'installation et la configurationCICS TCP/IP, voir Installation et configurationCICS TCP/IP.

Pour plus d'informations sur l'utilisation du tableau d'options EXCI, voir À l'aide de la table d'options EXCI, DFHXCOPT.

Pour plus d'informations sur la définition de l'ensemble de données intrapartition, voir Définition de l'ensemble de données intrapartition..

The RIT.CICS.PROC dataset contains sample JCL to configure TCP/IP, EXCI, and the intrapartition data set in the CICS region. It is also contains JCL to start the Test Integrations and APIs CICS Agent. In the following steps, member names such as DINTRA#T and EZAPLT#T refer to members of the RIT.CICS.PROC dataset.

Effectuez les étapes suivantes en consultation avec votreCICS administrateur:

  1. Créez l'ensemble de données intrapartition à l'aide de l'outilDINTRA#T membre et mettez à jour le nom DFHINTRA DD dans leCICS procédure de démarrage de région.

    Si vous disposez déjà d'un ensemble de données DFHINTRA et que vous ne souhaitez pas le recréer, vous devez vous assurer que votre ensemble de données actuel a été créé avec les paramètres RECORDSIZE correspondant aux paramètres du travail.DINTRA#T.

  2. Créer leCICS Module de chargement d'option EXCI nommé DFHXCOPT en utilisant leEXCIOP#T membre.
  3. Si l'interface TCP/IP dans leCICS La région n'est pas déjà configurée, configurez-la comme suit:
    1. Modifier leEZACAC#T membre et soumettez-le pour créer le cache utilisateur.
    2. Modifier leEZACFG#T et soumettez-le pour créer la configuration TCP/IP.
    3. Modifiez le membre EZACIC#T en fonction des commentaires contenus dans ce membre.
    4. Modifier leEZADEF#T membre et soumettez-le pour créer les ressources pour les sockets.
    5. Modifier leEZAPLT#T membre et soumettez-le pour créer le programme PLTPI.
  4. Définir la Test Integrations and APIs Agent ressources:
    1. Modifier leRITUSD#T membre.
    2. Modifier leRITDEF#T membre et soumettez-le.
  5. Modifier leCICS la procédure de démarrage de la région et les paramètres d'initialisation du système et redémarrez leCICS région:
    1. Ajouter leTCPIP.SEZATCP et@CICHLQ@.@REGNAM@.PLTLOAD ensembles de données à l'instruction DFHRPL DD.
    2. Ajoutez les instructions DD suivantes auCICS procédure de démarrage: 
      //TCPDATA DD SYSOUT=*,DCB=(DSORG=PS,RECFM=V,BLKSIZE=136) //SYSTCPT DD SYSOUT=*,DCB=(DSORG=PS,RECFM=V,BLKSIZE=136) //* The system TCP/IP configuration //SYSTCPD DD DSN=@SYS1@.TCPPARMS(TCPDATA),DISP=SHR //RITLOG DD SYSOUT=*
    3. Mettez à jour l'instruction DFHINTRA DD que vous avez définie à l'étape 1.
    4. Ajouter PLTPI=XX et PLTSD=YY au paramètre d'initialisation du système, où XX est le suffixe (@SUFFIX@) que vous avez défini dansEZAPLT#T et AA est le suffixe (@SUFFI2@) que vous avez défini dansEZAPLT#T.
    5. Assurez-vous que les paramètres d'initialisation du système contiennent les chaînes ISC=YES, TCPIP=YES, et IRCSTRT=YES.
    6. Si vous utilisez plusieursCICS versions et multiplesCICS numéros SVC, assurez-vous que leCICS Le numéro SVC est le numéro duCICS le plus récent version installée dans lez/OS système. Revoir leCICS Numéro SVC dans leCICS paramètres d'initialisation du système et le numéro CICSSVC dans le DFHXCOPT, qui est défini dans SYSUT1 DD deEXCIOP#T.
    7. Redémarrez leCICS région avec le DEMARRAGE=FROID option pour formater le nouvel ensemble de données intrapartition que vous avez créé à l'étape 1.
  6. Créez un JOB RITAGENT unique, basé sur @RITHLQ@.CICS.PROC(RITAGENT). Modifiez le contenu en fonction des instructions du JCL.
    Note:
    Le travail RITAGENT s'arrête automatiquement lorsqu'il ne peut plus communiquer avec CICS Transaction Server ou Test Virtualization Control Panel. Une fois qu'il détecte un problème avec l'une ou l'autre des connexions, il tente périodiquement de rétablir la connexion. Si les tentatives de reconnexion échouent, l'agent s'arrête. Vous pouvez définir des variables d'environnement dans le travail RITAGENT pour contrôler le nombre de fois que l'agent tente de se reconnecter à CICS ou Test Virtualization Control Panel. Pour plus d'informations sur la définition de ces variables d'environnement, consultez les commentaires dans le travail RITAGENT.

    Avant la version 10.0.0, l'agent ne pouvait se reconnecter qu'à la même instance de CICS. À partir de la version 10.0.0, l'agent peut se reconnecter à CICS, même si CICS a été redémarré. Si vous souhaitez que l'agent reste actif pendant les redémarrages de CICS, vous devrez peut-être augmenter la valeur de la variable d'environnement EXCI_MAX_ERRNUM pour garantir que l'agent ne s'arrête pas automatiquement avant le démarrage de la nouvelle instance de CICS.

Une fois toutes les ressources configurées, vous pouvez démarrer l'agent en soumettant le JCL suivant. (Dans ces exemples, RITAGT1 est le nom du travail RITAGENT unique créé à l'étape précédente):@RITHLQ@.CICS.PROC(RITAGT1)

Pour arrêter l'agent, exécutez la commande SDSF suivante/F RITAGT1,STOP
Note:
Ne pas utiliser/C RITAGT1 pour l'annuler.

Vous pouvez également actualiser le contenu des ensembles de données RITLOGxx (soit RITLOG01, soit RITLOG02, selon celui actuellement utilisé) avec la commande SDSF suivante/F RITAGT1,REFR