Running the EXCI sample applications

To use the COBOL, PL/I, or C version of the EXCI client program, you must translate, compile, and link-edit the program into a suitable library.

You can use the following sample JCL as a basis for creating your own batch job to run the client program.

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
//STEPLIB   DD    DSN=CICSTS53.CICS.EXCI.LOADLIB,DISP=SHR
//          DD    DSN=CICSTS53.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 use the pregenerated assembler version, specify the APPLID of your target CICS® server region as a parameter on the EXEC statement for the client program:

//*===============================================================*
//ASM       EXEC  PGM=DFH$AXCC,PARM='applid,userid'

applid is the applid of the CICS server region. userid is the user ID for the DPL_request call. If you omit applid, you must keep the comma that precedes the user ID.

Change PGM=DFH$AXCC to PGM=DFH$ATXC to run the other client sample program.