Running the EXCI channel and containers sample applications

You can create a batch job to run the client program. You can also run the client program by using the pregenerated assembler version.

Before you begin

To use the COBOL version of the EXCI client program, you must translate, compile, and link-edit the program into a suitable library by using the DFHZXTCL ot DFHYXTVL procedure.
The resource definitions for the EXCI sample programs are included in the CSD but they are not included in the IBM®-defined group list DFHLIST. If CICS® is initialized with GRPLIST=DFHLIST, you must install the EXCI resource definition groups before using the samples. Alternatively, you can add the sample groups to your startup group list, so that they are installed automatically at system initialization.

Procedure

Create a batch job to run the client program, based on the following sample JCL:

Figure 1. Sample job for starting an EXCI client program

//EXCI    JOB (accounting_information),CLASS=A,TIME=1440,
//        USER=userid,PASSWORD=pswd,REGION=100M
//*===============================================================*
//*    JCL to execute an external CICS interface client program   *
//*===============================================================*
//          EXEC  PGM=pgmname,REGION=nnM,MEMLIMIT=nnG
//STEPLIB   DD    DSN=CICSTS54.CICS.EXCI.LOADLIB,DISP=SHR
//          DD    DSN=CICSTS54.CICS.SDFHEXCI,DISP=SHR
//SYSPRINT  DD    SYSOUT=A
//SYSMDUMP  DD    DSN=SYS1.SYSMDP00,VOL=SER=volid,SPACE=(CYL,(1,1)),
//                DISP=OLD,UNIT=3390

If you want to use the pregenerated assembler version of the client program, issue the following EXEC statement for the client program:
```
//*===============================================================*
//ASM       EXEC  PGM=client_program_name,PARM='applid,userid',REGION=0M,MEMLIMIT=1G 
```
where:

client_program_name

Specify the name of the client program, for example, DFH$AXNC.

applid

Specify the APPLID of your target CICS server region.
Note: If you omit applid, you must keep the comma that precedes the user ID.

userid

Specify the user ID for the DPL_request call.

Results

Figure 2 shows an example of the output from DFH$AXNC if the pregenerated assembler version of the client program DFH$AXNC is executed successfully.

Figure 2. Example output from successful execution of DFH$AXNC

*===================== EXCI Sample Batch Client Program =======================*
*                                                                              *
*     Parameters: APPLID=IYK2Z2G1 .......... .......                           *
*                                                                              *
*  EXEC Level Processor.                                                       *
*    Setting up the EXEC level call.                                           *
*    The Link Request with channel FIRST_CHANNEL has completed successfully.   *
*    Checking response container sent by server.                               *
*    Response OK, continue processing.                                         *
*    Query channel command completed successfully.                             *
*    Correct number of containers returned.                                    *
*    Browse of channel names completed successfully.                           *
*    The Link Request with channel SECOND_CHANNEL has completed successfully.  *
*    Checking response container sent by server.                               *
*    Response OK, continue processing.                                         *
*                                                                              *
*  CALL Level Processor.                                                       *
*    Initialise_User call complete.                                            *
*    Allocate_Pipe call complete.                                              *
*    Open_Pipe call complete.                                                  *
*    The connection has been successful.                                       *
*    Container EBCDIC_DATA was received correctly in channel FIRST_CHANNEL.    *
*    Container ASCII_DATA was received correctly in channel SECOND_CHANNEL.    *
*    Channels have been deleted.                                               *
*    Close_Pipe call complete.                                                 *
*    Deallocate_Pipe call complete.                                            *
*                                                                              *
*=================== End of EXCI Sample Batch Client Program ==================*