Running the sample client programs

After you set up the NACT transaction, the Link3270 environment, and the clients, you can run the sample client programs.

Before you begin

Ensure that you complete the setup procedures:

Procedure

  • Running the samples from a CICS-based client
    1. At a CICS terminal, enter the transaction name BRCO (for the COBOL sample) or BRCH (for the C sample).
  • Running the samples from a z/OS-based client
    1. To run the samples, you can use the following sample JCL supplied in file DFH$BRXJ in SDFHINST. You must edit this JCL as follows:
      hlq
      Specify your own prefix, which is assigned during CICS installation.
      application library
      Specify the name of the library that contains the load modules.
      Note: Run this job in the z/OS batch environment.
      Figure 1. 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=*                                                  
      //                                                                      
    Result: The output from the NACT sample is returned in the output from this job.
  • Running the samples from a workstation client