IBM SC34-6814-04 Server User Manual


 
2 The library into which the load module will be link-edited.
3 Optionally, the name of a library containing your local Assembler macros and
copy members.
4 These options are required for DFHXCURM, and for the supplied sample versions
of DFHTEP and DFHZNEP.
5 your_sourcelib is the name of the library containing your modified version of the
program.
6 program_name is the source member name of the user-replaceable program being
assembled. The source member for the supplied DFHTEP sample is DFHXTEP.
The source member for the supplied DFHZNEP sample is DFHZNEP0. The
Assembler source member for the supplied DFHEJDNX sample is DFHEJDN1.
7 The input to the linkage-editor normally consists of the two statements shown
here, with program_name replaced by the name of the user-replaceable program
being compiled. There are some exceptions for some of the CICS-supplied sample
programs, and these are shown in Figure 17.
Link-edit statements for DFHTEP:
ENTRY DFHTEPNA
NAME DFHTEP(R)
Link-edit statements for DFHZNEP:
ENTRY DFHZNENA
NAME DFHZNEP(R)
.
User-replaceable programs and the storage protection facility
When you are running CICS with the storage protection facility, there are two points
you need to consider:
v The execution key in which your user-replaceable programs run
v The storage key of data storage obtained for your user-replaceable programs.
Execution key for user-replaceable programs
When you are running with storage protection active, CICS always gives control to
user-replaceable programs in CICS key. Even if you specify EXECKEY(USER) on
the program resource definition, CICS forces CICS key when it invokes the
program. However, if a user-replaceable program itself passes control to another
program, the program thus invoked executes according to the execution key
(EXECKEY) defined in its program resource definition.
Important
You are strongly recommended to specify EXECKEY(CICS) when defining both
user-replaceable programs and programs to which a user-replaceable program
passes control.
Figure 17. Link-edit statements for DFHTEP and DFHZNEP
Chapter 5. General notes about user-replaceable programs 437