An assembler language version

The sample job in Figure 1 shows the link-edit statements you need for an assembler language version of a DFHCSDUP user program.
Figure 1. Link-edit control statements for a DFHCSDUP user program (assembler language)
//DFHCRFA  JOB (accounting information),CLASS=A,MSGCLASS=A,NOTIFY=userid
//* .
//* Assembler job step here
//*  .
//LINK EXEC PGM=IEWL,PARM='XREF,LIST,LET'
//OBJLIB   DD DSN=object.module.library,DISP=SHR
//SYSLIB   DD DSN=CICSTS54.CICS.SDFHLOAD,DISP=SHR
//SYSLMOD  DD DSN=user.library,DISP=SHR
//SYSUT1   DD UNIT=SYSDA,SPACE=(1024,(100,10))
//SYSPRINT DD SYSOUT=A
//SYSLIN   DD *
 ENTRY     DFHEXTRA                                               1
 CHANGE    EXITEP(csectname)                                      2
 INCLUDE   SYSLIB(DFHEXAI)                                        3
 INCLUDE   OBJLIB(obj-name)                                       4
 NAME      progname(R)                                            5

Notes for the assembler job:

1 Specify the entry name as DFHEXTRA, which is the entry name in the CICS-supplied stub, DFHEXAI. (See 3.)

2 The CICS-supplied stub, DFHEXAI, is generated with a link to the user program using a dummy CSECT name (EXITEP). Use the link-edit CHANGE statement to change the CSECT name from EXITEP to the name of the CSECT in the user program. In the two CICS-supplied assembler language sample programs, these names are:
CREFCSD
The CSECT name in DFH$CRFA, the cross-reference listing user program.
FORMCSD
The CSECT name in DFH$FORA, the DB2-formatting user program.

3 Include DFHEXAI in any assembler language user program that you write for use with the DFHCSDUP EXTRACT command. DFHEXAI is the interface stub between DFHCULIS, a module in DFHCSDUP, and the user program.

4 obj-name is the name of the library member that contains the assembled object module.

5 progname is the name you want to call the load module; this is the name that you specify on the USERPROGRAM parameter of the EXTRACT command.



dfha3c00348.html | Timestamp icon Last updated: Sunday, 4 June 2017