Running the sample client programs

The following setup is required to run the samples:

Setup the Link3270 environment

Set up the Link3270 environment as described in Managing the Link3270 bridge environment. Ensure that you have defined :

Setup for the CICS-based clients

  1. Install and setup the NACT transaction, as described in Setup for the NACT transaction
  2. Translate, compile and link the COBOL or C language programs DFH0CBRC, DFH0CBRL, DFH$BRCC, and DFH$BRLC, using a Language Environment® conforming compiler, ensuring the library containing the DFH$BRSH and DFH0CBRA copybooks is accessible. See the CICS® Application Programming Guide for guidance on translating and compiling CICS programs.

    Add the load library containing the load modules to the RPL concatenation of your CICS startup job.

  3. Install resource definitions for the following CICS resources:
    Table 13. Resource definitions for sample clients
    Resource Description
    DFH0CBRC COBOL sample business client
    DFH0CBRL COBOL sample bridge client
    DFH$BRCC C sample business client
    DFH$BRLC C sample bridge client
    BRCO Transaction to drive DFHC0BRC
    BRCH Transaction to drive DFH$BRCC

    Examples of these resource definitions are provided for you in group DFH$BRLK. Install this group, or add it to the grouplist installed during CICS startup.

  4. Run the samples by entering the transaction name BRCO (for the COBOL sample) or BRCH (for the C sample) at a CICS terminal.

Setup for OS/390 based client

  1. Install and setup the NACT transaction in CICS, as described in Setup for the NACT transaction.
  2. Edit the DFH0CBRX or DFH$BRXC sample to pass the netname of the CICS region where the bridge client program (DFH$BRLC or DFH0CBRL) is installed. Compile and link the COBOL or C language programs DFH0CBRX or DFH$BRXC, using a Language Environment conforming compile, ensuring the library containing the DFH$BRSH and DFH0CBRA copybooks is accessible. Ensure also that the CICS supplied SDFHEXCI dataset is concatenated to SYSLIB for your compile step. Place the output load modules in an appropriate OS/390® library.
  3. Translate, compile and link the COBOL or C language programs DFH0CBRL, and DFH$BRLC, using a Language Environment conforming compiler, ensuring the library containing the DFH$BRSH and DFH0CBRA copybooks is accessible. See the CICS Application Programming Guide for guidance on translating and compiling CICS programs.

    Add the load library containing the load modules to the RPL concatenation of your CICS startup job.

  4. Create and install a CONNECTION resource definition to define the interface between CICS and OS/390 that will be used by the EXCI request. See Defining connections to CICS, and Introduction to the external CICS interface for an introduction and guidance on how to use of the EXCI interface.
  5. To run the EXCI samples, you can use the following JCL supplied in file DFH$BRXJ in SDFHINST. You should edit this JCL to replace hlq with your own prefix, assigned during CICS installation, and to replace application library with the name of the library that contains the load modules created in step 1. Run this job in the OS/390 batch environment.
    Figure 14. EXCI sample JCL
     -----------------------------------------------------------------------
    //DFH$BRXJ JOB (accounting information)                                 
    //         CLASS=A,MSGCLASS=A,MSGLEVEL=(1,1),REGION=12M                 
    //LINK3270 EXEC PGM=DFH0CBRX                                            
    //********************************************************************* 
    //*                                                                   * 
    //* JCL NAME = DFH$BRXJ                                               * 
    //*                                                                   * 
    //* DESCRIPTIVE NAME = Link3270 bridge EXCI business client sample    * 
    //*                                                                   * 
    //* FUNCTION =                                                        * 
    //*                                                                   * 
    //*    Sample JCL for running the Link3270 bridge EXCI                * 
    //*    business client samples DFH0CBRX and DFH$BRXC.                 * 
    //*                                                                   * 
    //*    The file DSN qualifier hlq must be changed.                    * 
    //*    This JCL runs the COBOL sample DFH0CBRX                        * 
    //*    This must be compiled into application library                 * 
    //*    before the JCL is run.                                                * 
    //*    application library must be changed.                           * 
    //*    To run the C Sample change DFH0CBRX to DFH$BRXC.               * 
    //*                                                                   * 
    //*    The CICS External Interface Guide contains a detailed          * 
    //*    description of the Link3270 bridge.                            * 
    //*                                                                   * 
    //********************************************************************* 
    //STEPLIB  DD DSN=application library,DISP=SHR                      
    //         DD DSN= hlq.SDFHEXCI,DISP=SHR                                
    //SYSPRINT DD SYSOUT=*                                                  
    //SYSABEND DD SYSOUT=*                                                  
    //                                                                      
    Note:
    The output from the NACT sample is returned in the output from this job.

Setup for the workstation client

  1. Install the CICS Transaction Gateway on your workstation, as described in the relevant CICS Transaction Gateway administration manual for your workstation platform, ensuring that the developer kit is included.
  2. Download the following programs and header files:
    Table 14. Required files
    File Source library
    dfh$brec.c CICSTS31.CICS.SDFHSAMP
    dfh$brxc.h CICSTS31.CICS.SDFHSAMP
    dfh$brmh.h CICSTS31.CICS.SDFHSAMP
    dfhbrich.h CICSTS31.CICS.SDFHC370
    dfhbrihh.h CICSTS31.CICS.SDFHC370
    Compile dfh$brec, with these header files, and DFHAID.h in your path.
  3. Setup the ECI connection in CICS as described in the CICS Family: Communicating from CICS on System/390® manual.
  4. Setup the ECI connection in your workstation as described in the appropriate Client Administration manual.
  5. Install and setup the NACT transaction in CICS, as described in Setup for the NACT transaction

Related concepts
The Link3270 bridge mechanism
Related tasks
Using the Link3270 bridge
The NACT transaction
Setup for the NACT transaction
[[ Contents Previous Page | Next Page Index ]]