II14447: USERS OF DOS/VS RPG II RELEASE 1.3.0 WISHING TO RUN APPLICATIONS IN CICS TS ON Z/VSE 4.1 AND Z/VSE 4.2

APAR status

• INTRAN

Error description

• DOS/VS RPG II RELEASE 1.3.0 online applications cannot run in
  CICS TS as language RPG is not supported.
  
  With ptf UK60655 for apar PM22788 against DOS/VS RPG II
  Release 1.3.0 compiler, online RPG II application programs
  can be compiled to run in CICS TS.
  Note: UK60655 supercedes UK58484.
  
  The following steps are required,
  
  o  compile with EXEC PARM option of CICSTS
     e.g. // EXEC RPGII,PARM='CICSTS'  (refer below for sample)
  
  o  link edit including new ILNERI object in place of DFHERI
  
  o  define the program to CICS TS as language type ASSEMBLER
  
  o  define the program to CICS TS as RELOAD=YES
  
  o  sample compile JCL to compile for CICS TS
  
  
     * $$ JOB JNM=DFHXRMNU,CLASS=0
     * $$ PUN DISP=I,PRI=6,CLASS=0
     // JOB DFHXAMNU
     // ASSGN SYSIPT,SYSRDR
     // EXEC IESINSRT
     // JOB DFHXAMNU
     // LIBDEF *,SEARCH=(testlib.sublib,prd2.rpg,PRD2.CICSOLDP)
     // LIBDEF PHASE,CATALOG=testlib.sublib
     // OPTION CATAL
        PHASE XDFHRMNU,*
        INCLUDE ILNERI
     // EXEC RPGII,PARM='CICSTS'
     * $$ END
     // LIBDEF *,SEARCH=(testlib.sublib,prd2.rpg,PRD2.CICSOLDP)
     // OPTION DECK
     // EXEC DFHERP1$
     * $$ SLI MEM=DFHXRMNU.R,S=PRD2.CICSOLDP
     /*
     // EXEC IESINSRT
     /*
     // EXEC LNKEDT
     /*
     #&
     $ $$ EOJ
     * $$ END
     /&
     * $$ EOJ
  
  With ptf for PM16528 applied, programs can still be compiled
  to run in CICS/VSE by not including the EXEC PARM and still
  using INCLUDE DFHERI in the link edit step. Note that
  programs compiled and linked for CICS TS cannot be used
  in CICS/VSE. So if migrating to CICS TS, the CICS TS phases
  must be kept in a separate sublibrary.
  
  Also batch applications compiled with UK60655 applied
  will function as before. Note that linkedit of batch
  compiles will now have UNRESOLVED EXTERNAL REFERENCES
  WXTRN DFHEI1 with LAST RETURN CODE WAS 0002.
  
  Note that the RPG II online application is restricted to CICS
  API calls as described in CICS/DOS/VSE Version 1 Release 6
  Application Programmer's Reference Manual (RPGII) that are
  supported in CICS TS.
  

Local fix

Problem summary

Problem conclusion

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

Applicable component levels