IBM SC34-6814-04 User Manual
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.
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.
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.
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.
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.
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.
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.
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 *
//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