Mustercode 'CICS Transaction Server for z/OS Connectivity' konfigurieren

Konfigurieren Sie IBM WebSphere Message Broker so, dass mithilfe des konfigurierbaren CICSConnection-Service eine Verbindung zu CICS Transaction Server for z/OS hergestellt wird, und richten Sie FILEA in Ihrer CICS-Zielregion für den Mustercode 'CICS Transaction Server for z/OS' ein.

Bevor Sie den Mustercode 'CICS Transaction Server for z/OS Connectivity' importieren und implementieren, müssen Sie WebSphere Message Broker so konfigurieren, dass mittels des konfigurierbaren CICSConnection-Service eine Verbindung zu CICS hergestellt werden kann.

Bevor Sie den Mustercode 'CICS Transaction Server for z/OS Connectivity' ausführen, müssen Sie FILEA in Ihrer CICS-Zielregion einrichten:

WebSphere Message Broker für eine eine Verbindung zur CICS-Region konfigurieren

Mit den folgenden Schritten wird die Mindestkonfiguration vorgenommen, die für den Import und die Implementierung des Mustercodes erforderlich ist:

  1. Wenn Sie sich anmelden müssen, um eine Verbindung zu Ihrer CICS-Region herzustellen, richten Sie mit dem Befehl mqsisetdbparms eine Sicherheitsidentität ein, beispielsweise:
    mqsisetdbparms MB8BROKER -n cics::<ID-Name> -u <Benutzername> -p <Kennwort> 
  2. Erstellen Sie mit dem Befehl mqsicreateconfigurableservice oder mithilfe von WebSphere Message Broker Explorer den konfigurierbaren CICSConnection-Service CICSSampleConnectionService:

Sie können den Mustercode jetzt importieren und implementieren. Weitere Informationen finden Sie im Abschnitt Mustercode 'CICS Transaction Server for z/OS Connectivity'.

Nachdem Sie den Mustercode importiert haben, werden unter Umständen die folgenden Warnungen zum CICS Connectivity-Nachrichtenflussprojekt und zur Datei CICSConnectivity.esql angezeigt:

Unresolvable message field reference "InputBody.data.file" (Nicht auflösbare Nachrichtenfeldreferenz "InputBody.data.file")
Unresolvable message field reference "InputBody.data.file" (Nicht auflösbare Nachrichtenfeldreferenz "InputBody.data.record")

Diese Nachrichten können Sie ignorieren, da der Datenordner nicht im XML-Schema enthalten ist.

FILEA in der CICS-Region konfigurieren

Führen Sie folgende Schritte aus, um FILEA in der CICS-Zielregion zu konfigurieren:

  1. Erstellen Sie die Datei FILEA, eine Datei in Schlüsselfolge (KSDS-Datei).

    Bei der Definition einer CICS-Region werden während der Installation FILEA-Musterdatensätze erstellt, die sich in 'mydsindex.myCICSregion.FILEA' befinden. Ist dieser Datensatz nicht verfügbar, müssen Sie ihn mit dem JCL-Script (Job Control Language) erneut erstellen:

    //HCREFILA JOB … card details … 
    //CREFILEA EXEC PGM=IDCAMS,REGION=6144K                      
    //SYSPRINT DD SYSOUT=A                                       
    //AMSDUMP  DD SYSOUT=A                                       
    //SYSIN    DD *                                              
      DEFINE CLUSTER (                         -                 
                    NAME( hlq4filea.FILEA ) -         
                    CYL(2,1)                   -                 
                    VOLUME(SYSDAV)          -                    
                    KEYS( 6  1 )               -                 
                    INDEXED                    -                 
                    RECORDSIZE( 80  80 )     -                   
                    FREESPACE( 5 5 )           -                 
                    SHAREOPTIONS( 2 )          -                 
                    )                          -                 
      INDEX         (                          -                 
                    NAME( hlq4filea.FILEA.INDEX ) -   
                    )                          -                 
      DATA          (                          -                 
                    NAME( hlq4filea.FILEA.DATA ) -    
                    )                                            
    /*    
    //
    //HINIFILA JOB … card details …
    //* ====================                                        
    //* LOAD VSAM DATA FILE                                         
    //* ====================                                        
    //INIFILEA EXEC PGM=DFH£LDSP                                    
    //STEPLIB  DD DSN=hlq4cics.SDFHLOAD,DISP=SHR              
    //FILEA    DD DISP=SHR,DSN=hlq4filea.FILEA           
    //SYSOUT   DD SYSOUT=*                                          
    //SYSIN    DD DISP=SHR,DSN=hlq4cics.SDFHSAMP(DFH£FAIN)    
    //*      
    //          
    
  2. Erstellen Sie eine FILE-Ressourcendefinition, die auf die KSDS-Datei FILEA verweist.

    Definieren Sie mithilfe der in CICS bereitgestellten CEDA-Transaktion eine FILE-Ressource. Die Ressource kann auf der FILEA-Musterdefinition des CSD-Befehls in Gruppe DFH£FILA basieren und muss auf den Datensatz verweisen, der im vorherigen Schritt definiert wurde.

  3. Installieren Sie das CICS-Programm DFH$AXCS.

    Das in CICS bereitgestellte Musterprogramm DFH$AXCS kann mit dem folgenden Befehl installiert werden:

    CEDA INSTALL PROG(DFH$AXCS) GROUP(DFH$EXCI)

Der Mustercode 'CICS Transaction for z/OS Connectivity' kann jetzt ausgeführt werden (siehe den Abschnitt Mustercode 'CICS Transaction Server for z/OS Connectivity' ausführen).

Zurück zum Beginn des Mustercodes