Chapter Contents |
Previous |
Next |
Preprocessing, Compiling, and Linking |
Consult the CICS/ESA External CICS Interface Manual for more information on the EXCI CALL interface.
The EXEC CICS Interface |
You invoke the EXEC CICS interface by using new options in the
EXEC CICS
LINK PROGRAM
command:
RETCODE(data-area)
,
and
APPLID(name)
. These options are valid
only when you specify the external call interface option.
When you specify the external call interface, the following
options for the
EXEC CICS LINK PROGRAM
command are not valid:
INPUTMSG(data-area)
| |
INPUTMSGLEN(data-value)
| |
SYSID(data-area)
|
Running your CICS Application with the External CICS Interface |
Translating, Compiling, and Linking under OS/390 |
Use the
EXCI
option to specify the external call interface
on OS/390. To resolve the external CICS interface stub when linking, you must
specify the CICS41.SDFHEXCI library. Ask your CICS system administrator for
the exact name of the SDFHEXCI data set at your site.
To translate the program, run the LCCCP CLIST:
LCCCP 'your.ccpinput.ccp(member)' OUTPUT('''ccp.output.c(member)''') EXCI
LC370 'ccp.output.c(member)' OBJECT('''ccp.output.load(member)''') RENT
COOL 'ccp.output.obj(member)' LOADLIB('''CICS41.SDFHEXCI''') LOAD('''ccp.output.load(member)''') LET
Method 1
ALLOC FILE(ISPLLIB) DATASET('CICS41.SDFHEXCI') SHR
To run the program using Method 1, type the following:
CALL 'ccp.output.load(member)'
Method 2
ALLOC FILE(CPLIB) DATASET('ccp.output.load' 'CICS41.SDFHEXCI') SHR
To run the program using Method 2, type the following:
member
For example, to translate and compile the program, run the LCCCPC procedure:
// EXEC LCCCPC,PARM.CCP='EXCI' //SYSPUNCH DD DISP=SHR,DSN=your.object.library(member) //SYSIN DD DISP=SHR,DSN=your.source.library(member)
Then link and execute the program:
//STEP1 EXEC LC370LRG //LKED.SYSLMOD DD DISP=SHR,DSN=your.load.lib(member) //LKED.SYSIN DD DISP=SHR,DSN=your.object.lib(member) //LKED.SYSLDLIB DD DISP=SHR,DSN=CICS41.SDFHEXCI //GO.STEPLIB DD // DD DISP=SHR,DSNAME=CICS41.SDFHEXCI
Translating, Compiling, and Linking under CMS |
Use the
EXCI
option
to specify the external call interface
on CMS. First, translate the program using the LCCCP EXEC:
LCCCP filename (filetype (filemode)) (EXCI
LC370 filename (filetype (filemode)) (RENT
Finally, the object must be moved to OS/390 to execute the link step. This step is illustrated in Translating, Compiling, and Linking under OS/390.
Chapter Contents |
Previous |
Next |
Top of Page |
Copyright © 2001 by SAS Institute Inc., Cary, NC, USA. All rights reserved.