A fix is available
APAR status
Closed as unreproducible.
Error description
DFHZATDX doesn't get control when DFHZATS determines that the clash is between a shipped terminal (being installed) and an already locally installed terminal.
Local fix
n/A
Problem summary
**************************************************************** * USERS AFFECTED: All CICS Users * **************************************************************** * PROBLEM DESCRIPTION: DFHAC2236 Transaction CITS abend * * AZVE in program DFHZATS term ????. * **************************************************************** * RECOMMENDATION: * **************************************************************** The autoinstall program DFHZATDX or DFHZATDY is not called when a shipped terminal is being autoinstalled and clashes with an already installed local terminal id. Instead DFHZATS will abend transaction CITS with code AZVE. Additional keywords: msgDFHAC2236 abendAZVE URM AIEXIT
Problem conclusion
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
DFHZATS has been altered to allow the autoinstall exit to be driven when a shipped terminal id clashes with a local terminal id. The CICS Transaction Server for z/OS Version 3 Release 2 Customization Guide, SC34-6814-03 has been altered in Chapter 14 ('Writing a program to control autoinstall of shipped terminals') under the heading of 'Installing shipped terminals and connections' to include local terminals in the list of terminal types that will result in the exit being driven if there is a clash with the name of the shipped definition. The first paragraph has been altered to say: "Because your autoinstall control program is invoked for shipped terminal connections, you can use it to reset the TERMINAL (or CONNECTION) attribute of a shipped definition to an alias, thereby avoiding conflicts with names of remote terminals, local terminals and connections already installed in the AOR." The following paragraph has been deleted: "If the name of a shipped definition clashes with the name of a local terminal or connection installed in the AOR, the install is rejected, and the autoinstall control program is not invoked." Under the sub-heading 'CICS-generated aliases' the text has been changed to include local terminals as follows: "The autoinstall control program is invoked once for each shipped terminal or connection definition to be installed. If CICS detects that the name on a shipped definition clashes with the name of a remote terminal, local terminal or connection already installed in the AOR, it generates an alias TERMID and passes it to the control program in field SELECTED_SHIPPED_TERMID of the communications area." The following paragraph has been added to the end of the section 'Installing shipped terminals and connections': "If the autoinstall control program selects a terminal name that clashes with the name of a local terminal, then the request is rejected and the autoinstall control program is not invoked again."
APAR Information
APAR number
PM43237
Reported component name
CICSTS V3 Z/OS
Reported component ID
5655M1500
Reported release
500
Status
CLOSED UR3
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2011-07-08
Closed date
2011-08-19
Last modified date
2011-09-01
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK70895
Modules/Macros
DFHZATS
Fix information
Fixed component name
CICSTS V3 Z/OS
Fixed component ID
5655M1500
Applicable component levels
R500 PSY UK70895
UP11/08/26 P F108
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.2","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.2","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
01 September 2011