IBM SC34-6814-04 - Manual (Page 458)

Assembling and link-editing user-replaceable programs
The source for the CICS-supplied user-replaceable programs is installed in the
CICSTS32.CICS.SDFHSAMP library. If you intend changing any of these programs,
take a copy of the CICSTS32.CICS.SDFHSAMP library and update the copy only. If
the original SDFHSAMP is serviced, and a user-replaceable program is modified,
you may like to reflect the changes in your own version of the code.
To replace one of these CICS-supplied programs, assemble and link-edit your
version of the program. Except for DFHJVMRO and DFHAPXPO, all programs are
supplied as command-level programs, and must be translated before assembly and
link-edit. Note that the translator options NOPROLOG and NOEPILOG should be
coded with your versions of DFHZNEP, DFHTEP, and DFHXCURM.
If you have user-written versions of DFHZNEP, DFHPEP, or DFHTEP from an
earlier release of CICS, and they use macros, recode the programs to use EXEC
CICS commands.
To translate, assemble, and link-edit user-replaceable programs, you can use the
CICS-supplied procedure DFHEITAL. For information about using DFHEITAL, see
Using the CICS-supplied procedures to install application programs, in the CICS
Application Programming Guide. If you use SMP/E, you can give the object-deck
output after translation and assembly to SMP/E for link-editing.
With the exception of DFHJVMRO and DFHAPXPO, when link-editing a
user-replaceable program you must link-edit it with the EXEC interface module
(stub). This stub enables the program to communicate with the EXEC interface
program (DFHEIP). If you use the DFHEITAL procedure, it link-edits programs with
the EXEC interface stub by default.
DFHJVMRO and DFHAPXPO should not be translated and do not need to be
link-edited with the EXEC interface module. You can use the DFHASMVS
procedure to compile these programs.
The job stream in Figure 16 is an example of the assembly and link-edit of a
user-replaceable program. The figure is followed by some explanatory notes.
Notes:
1 High-level qualifier of the CICS libraries.
//ASSEMBLE EXEC DFHEITAL,
//
ASMBLR=ASMA90,
// INDEX=’CICSTS31.CICS’, 1
// PROGLIB=’your_loadlib’, 2
// DSCTLIB=’your_copylib’, 3
// PARM.TRN=’NOPROLOG,NOEPILOG’, 4
// PARM.ASM=’DECK,NOOBJECT,LIST,XREF(SHORT),RENT,ALIGN’,
// LNKPARM=’LIST,XREF,RENT,MAP,AMODE(31),RMODE(ANY)’
//TRN.SYSIN DD DSN=your_sourcelib(program_name),DISP=SHR 5 6
//LKED.SYSIN DD *
ENTRY program_name 7
NAME program_name(R)
//*
Figure 16. Job stream to assemble and link-edit a user-replaceable program
436 Customization Guide