Setting up the CICS Transaction Server for z/OS Connectivity sample

Configure the IBM Integration Bus connection to CICS Transaction Server for z/OS by using the CICSConnection configurable service, and set up FILEA on your target CICS region to set up the CICS Transaction Server for z/OS Connectivity sample.

Before you import and deploy the CICS Transaction Server for z/OS Connectivity sample, you must configure the IBM Integration Bus connection to CICS by using the CICSConnection configurable service:

• Configure IBM Integration Bus to connect to your CICS region

Before you run the CICS Transaction Server for z/OS Connectivity sample, you must set up FILEA on your target CICS region:

• Set up FILEA on your CICS region

Configure IBM Integration Bus to connect to your CICS region

The following steps describe the minimum configuration that is required to import and deploy the sample:

1. If you need a login to connect to your CICS region, set up a security identity by using the mqsisetdbparms command; for example:

   mqsisetdbparms IB9NODE -n cics::<ID name> -u <username> -p <password> 

2. Create a CICSConnection configurable service called CICSSampleConnectionService by using the mqsicreateconfigurableservice command or by using the IBM Integration Explorer:

   • Creating a CICSConnection configurable service by using the mqsicreateconfigurableservice command:

     1. Use the following example to create a CICSConnection configurable service for the CICS instance that is running at mycicsregion.com port 12345. The integration node is identified by APPLID BRKApp and qualifier BRKQual.

        If you do not need a login to connect to your CICS region, run this command:

        mqsicreateconfigurableservice IB9NODE -c CICSConnection -o 
                    CICSSampleConnectionService -n cicsServer,clientApplid,clientQualifier 
                    -v tcp://mycicsregion.com:12345,BRKApp,BRKQual

        If you do need a login to connect to your CICS region, run the following command, replacing <ID name> with your login.

        mqsicreateconfigurableservice IB9NODE -c CICSConnection -o 
                    CICSSampleConnectionService -n cicsServer,clientApplid,clientQualifier,securityIdentity  
                    -v tcp://mycicsregion.com:12345,BRKApp,BRKQual,<ID name>

     2. Restart the integration node in the IBM Integration Explorer or by using the mqsistop and mqsistart commands; for example:

        mqsistop IB9NODE

        mqsistart IB9NODE

     To find out more about creating a configurable service that the CICSRequest node or message flow refers to at run time for connection information, and to view the available CICSConnection configurable service properties, see Changing connection information for the CICSRequest node and Configurable services properties in the IBM Integration Bus documentation.

   • Creating a CICSConnection configurable service by using the IBM Integration Explorer:

     1. In the Navigator view, expand the integration node on which you want to add a new configurable service.
     2. Right-click the Configurable Services folder and click New > Configurable Service. The Configurable Service window opens.
     3. In the Name field, enter CICSSampleConnectionService as the name for your configurable service.
     4. In the Type field, select CICSConnection as the type of configurable service to create.
     5. In the Template field, select CICSConnectionTemplate as the type of template to create.
     6. Enter the value for the configurable service cicsServer property in the format tcp://mycicsregion.com, where mycicsregion is your CICS region.
     7. Enter the values for the configurable service clientApplid and clientQualifier properties, where the values are your own unique values of eight characters or less.
     8. If you need a login to connect to your CICS region, enter the login name in the securityIdentity field.
     9. Click Finish to create the new configurable service.
     10. Restart the integration node in the IBM Integration Explorer or by using the mqsistop and mqsistart commands; for example:

         mqsistop IB9NODE

         mqsistart IB9NODE

     To find out more about using the IBM Integration Explorer to create a configurable service that the CICSRequest node or message flow refers to at run time, see Creating a new configurable service in the IBM Integration Bus documentation. To view the available CICSConnection configurable service properties, see Configurable services properties in the IBM Integration Bus documentation.

You can now import and deploy the sample. For more information, see CICS Transaction Server for z/OS Connectivity sample.

When you have imported the sample, you might see the following warning messages on the CICS Connectivity Message Flows project and CICSConnectivity.esql file:

Unresolvable message field reference "InputBody.data.file"

Unresolvable message field reference "InputBody.data.record"

You can ignore these messages because the data folder is not contained in the XML Schema.

Set up FILEA on your CICS region

Complete the following steps to set up FILEA on your target CICS region:

1. Create the FILEA Key Sequenced Dataset (KSDS) file.

   When a CICS region is initially defined, the FILEA sample datasets are created as part of the installation process and can be found at mydsindex.myCICSregion.FILEA. If this dataset is unavailable, use the following Job Control Language (JCL) script to re-create the dataset:

   //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. Create a FILE resource definition that references the FILEA KSDS file.

   Define a FILE resource by using the CICS supplied CEDA transaction. The resource can be based on the CSD command sample FILEA definition in group DFH£FILA, and must reference the dataset that is defined in the previous step.

3. Install the CICS program, DFH$AXCS.

   The CICS supplied sample program, DFH$AXCS, can be installed by using the following command:

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

You can now run the CICS Transaction for z/OS Connectivity sample, see Running the CICS Transaction for z/OS Connectivity sample.

Back to sample home