A fix is available
APAR status
Closed as unreproducible.
Error description
C/C++ APAR PK48792 for z/OS R1.7 XL C/C++ added compiler support for the integrated CICS translator at the CICS TS R3.1 and R3.2 levels. CICS needs to document this, and supply the appropriate integrated CICS translator procedures.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All * **************************************************************** * PROBLEM DESCRIPTION: There is no sample JCL to invoke the C * * and C++ integrated CICS translator. * **************************************************************** * RECOMMENDATION: * **************************************************************** Although the C/C++ integrated CICS translator is available in CICS TS 3.1, there is no sample JCL nor any mention of it in the CICS publications.
Problem conclusion
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
DFHZITDL, DFHZITEL, DFHZITFL and DFHZITGL are now available. The CICS Transaction Server for z/OS Application Programming Guide Version 3 Release 1 SC34-6433-03 will be changed in Chapter 8 'Translation and compilation' in the section 'The integrated CICS translator' to add the following sentence after "The releases of the COBOL and PL/I compilers which support the CICS integrated translator are listed in the CICS Release Guide." "The integrated translator is supported in z/OS V1.7 XL C/C++ and later compilers." In the next section titled 'Using the integrated CICS translator' change the last sentence of the first paragraph to read: "They are documented in the Programming Guides for Enterprise COBOL for z/OS, for Enterprise PL/I for z/OS and for XL C/C++." After the fourth paragraph in the same section, add the following paragraph: "To use the integrated CICS translator for C and C++, use the CICS option." In the next section titled 'Specifying CICS translator options' add the following paragraph: "To specify CICS translator options when using the XL C/C++ compiler specify the compiler option, CICS, with the translator options inside parentheses. For example: CICS(opt1,opt2,optn ...)" In the section titled 'Using the EXEC interface modules' subsection 'C and C++' after "procedures such as DFHYITDL" add: ", DFHZITDL, DFHZITEL, DFHZITFL or DFHZITGL" In Chapter 9 'Using the CICS-supplied procedures to install application programs' table 6 'Procedures for installing application programs' should have DFHZITDL added to the integrated translator column for C, DFHZITEL added to the same column for C++, DFHZITFL added to the same column for C with XPLINK and DFHZITGL added to the same column for C++ with XPLINK. All these additions should be accompanied by "(See note 2)". In the section 'Sample JCL to install C application programs' add the following to the end of the section:- "To use the procedures to invoke the integrated translator for XL C, you can use the job control statements shown here: //jobname JOB accounting info,name,MSGLEVEL=1 // EXEC DFHZITxL,PROGLIB=dsnname 1 //C.SYSIN DD * . . C source statements . //LKED.SYSIN DD * NAME anyname(R) // where anyname is your load module name. 1 Translator name: Specify DFHZITDL for C programs without XPLINK or DFHZITFL for C programs with XPLINK. To use the procedures to invoke the integrated translator for XL C++, you can use the job control statements shown here: //jobname JOB accounting info,name,MSGLEVEL=1 // EXEC DFHZITxL,PROGLIB=dsnname 1 //CPP.SYSIN DD * . . C++ source statements . //LKED.SYSIN DD * NAME anyname(R) // where anyname is your load module name. 1 Translator name: Specify DFHZITEL for C++ programs without XPLINK, or DFHZITGL for C++ programs with XPLINK." The CICS Transaction Server for z/OS OS Migration from CICS TS for OS/390 1.3 Version 3 Release 1 GC34-6423-04 will be changed in Chapter 14 'Migration planning for application development' in the section 'Translator support for high-level languages' to add procedures DFHZITDL, DFHZITEL, DFHZITFL and DFHZITGL to the lists of JCL procs for C and C++. The same Migration from CICS TS for OS/390 1.3 manual will be changed in Chapter 20 'Migration planning for the integrated translator' so the first two paragraphs will read: "To install application programs into CICS libraries, you can use one of the new CICS-supplied procedures for use with the integrated translator. Note that the new procedures, DFHZITCL (for COBOL), DFHZITPL (for PL/I) and DFHZITDL, DFHZITEL, DFHZITFL and DFHZITGL (for XL C/C++), include the CICS load library SDFHLOAD in STEPLIB, which is necessary for the compilers to load the translation tables. Also, if you are using the PL/I procedure or XL C/C++ procedures, the SYSLMOD DD statement in the binder step must refer to a PDSE (not a PDS as for the older compilers). See 'Translator support for high-level languages' for a list of all the procedures supplied for assembling and compiling application programs. To use the new procedures DFHZITCL, DFHZITPL, DFHZITDL, DFHZITEL, DFHZITFL or DFHZITGL to invoke the integrated translator, add the required language options to indicate that you want the compiler to invoke the translator:" Add a third bullet item just before the notes in this section as follows: ". To invoke the XL C/C++ compiler and the integrated translator, specify CICS as a compiler option; for example, in the PARM string, as follows: PARM=('RENT SOURCE CICS(SP,DEBUG)')" The CICS Transaction Server for z/OS Migration from CICS TS for z/OS 2.2 Version 3 Release 1 GC34-6424-04 will be changed in Chapter 13 'Migration planning for application development' in the section 'Translator support for high-level languages' to add procedures DFHZITDL, DFHZITEL, DFHZITFL and DFHZITGL to the lists of JCL procs for C and C++. The same Migration from CICS TS for z/OS 2.2 manual will be changed in Chapter 19 'Migration planning for the integrated translator' so the first two paragraphs will read: "To install application programs into CICS libraries, you can use one of the new CICS-supplied procedures for use with the integrated translator. Note that the new procedures, DFHZITCL (for COBOL), DFHZITPL (for PL/I) and DFHZITDL, DFHZITEL, DFHZITFL and DFHZITGL (for XL C/C++), include the CICS load library SDFHLOAD in STEPLIB, which is necessary for the compilers to load the translation tables. Also, if you are using the PL/I procedure or XL C/C++ procedures, the SYSLMOD DD statement in the binder step must refer to a PDSE (not a PDS as for the older compilers). See 'Translator support for high-level languages' for a list of all the procedures supplied for assembling and compiling application programs. To use the new procedures DFHZITCL, DFHZITPL, DFHZITDL, DFHZITEL, DFHZITFL or DFHZITGL to invoke the integrated translator, add the required language options to indicate that you want the compiler to invoke the translator:" Add a third bullet item just before the notes in this section as follows: ". To invoke the XL C/C++ compiler and the integrated translator, specify CICS as a compiler option; for example, in the PARM string, as follows: PARM=('RENT SOURCE CICS(SP,DEBUG)')" The CICS Transaction Server for z/OS Installation Guide Version 3 Release 1 GC34-6426-04 will be changed in Chapter 3 'Installing CICS TS using DFHISTAR' in the section 'What next?' to add the following rows to the table 'CICS Transaction Server-supplied procedures' after the row for DFHZITPL: "DFHZITDL Translates, compiles, and link-edits XL C application programs using the external CICS Transaction Server interface under Language Environment. DFHZITEL Translates, compiles, and link-edits XL C++ application programs using the external CICS Transaction Server interface under Language Environment. DFHZITFL Translates, compiles, and link-edits XL C XPLINK application programs using the external CICS Transaction Server interface under Language Environment. DFHZITGL Translates, compiles, and link-edits XL C++ XPLINK application programs using the external CICS Transaction Server interface under Language Environment." The CICS Transaction Server for z/OS Release Guide Version 3 Release 1 GC34-6421-04 will be changed in Chapter 29 'High-level language support' in the section 'C and C++ Compilers' to add the following row at the end of the table: "z/OS V1.7 5694-A01 Yes Yes. The compiler Provided by XL C/C++ provides support Language for the CICS Environment integrated translator. "
APAR Information
APAR number
PK52520
Reported component name
CICSTS V3 Z/OS
Reported component ID
5655M1500
Reported release
400
Status
CLOSED UR3
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2007-09-07
Closed date
2008-01-07
Last modified date
2008-02-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK33228
Modules/Macros
DFHZITDL DFHZITEL DFHZITFL DFHZITGL
Fix information
Fixed component name
CICSTS V3 Z/OS
Fixed component ID
5655M1500
Applicable component levels
R400 PSY UK33228
UP08/01/29 P F801
Fix is available
Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.
[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"3.1","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"3.1","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
02 February 2008