A fix is available
APAR status
Closed as program error.
Error description
You are running CICS Transaction Server 3.2 and just applied maintenance to CICS. This maintenance included APAR PK65668 PTF UK36536. You intermittently receive the following message in an AOR: DFHAC2236 TRANSACTION CITS ABEND AZVU IN PROGRAM DFHZATS TERM ????. UPDATES TO RECOVERABLE RESOURCES WILL BE BACKED OUT. DFHAC2236 TRANSACTION XXXX ABEND AZTI IN PROGRAM *UNKNOWN TERM <ABK. When the abendAZVU occurred, CICS is attempting to autoinstall a shipped terminal definition- in this case termid \xxx. It happens that '\' was what the they had specified for sit parm VTPREFIX. APAR PK65668 modified code in DFHZATS so in some cases, when the autoinstall exit passed back termid \xxx to install, it now checks to see if the first character matches VTPREFIX and will issue the AZVU abend. . KIXREVSWM
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICS users with PK65668. * **************************************************************** * PROBLEM DESCRIPTION: Transaction CITS ABEND AZVU in program * * DFHZATS during autoinstall of a remote * * shipped terminal. * **************************************************************** * RECOMMENDATION: * **************************************************************** A CICS Transaction Gateway (CTG) client has an APPC connection to a CICS Server, TOR region. The CICS TOR has an MRO connection to a CICS AOR. The CTG client uses EPI to communicate with the server. The CTG client submits a transaction request to the TOR, which is transaction routed to the AOR where it runs to completion. The client virtual terminal is uninstalled on the TOR region but a Skeleton terminal entry is left in the AOR. The CTG client submits a second transaction request to the TOR and a virtual terminal is once again installed on the TOR and shipped over to the AOR. Transaction CITS (DFHZATS) is started to install the shipped terminal in the AOR, but finds that a Skeleton already exists for the same Termid. The customer's URM is passed the Termid and told there is a clash with an existing entry, it is also passed a newly created alternative Termid. The URM elects to re-use the existing Termid so DFHZATS must delete and re-install the entry. However after PK65668 DFHZATS processes the terminal install as if it was a new terminal, and calls routine CHECK_TERMID to verify the name. The Termid is rejected because it starts with a '\' which has been specified as the VTPREFIX in the SIT. The terminal is not flagged as a virtual terminal in the AOR as it was not created directly from a CTIN INSTALL request. DFHZATS ABENDs AZVU. Prior to PK65668 CHECK_TERMID was not called because an existing Termid was being re-used. The REPLACE_SHIPPED_TERMINAL routine was invoked to replace the terminal definition and the second transaction completed normally. Additional keywords: ABENDAZVU AZTI ABENDAZTI DFHAC2236 MSGDFHAC2236
Problem conclusion
UK36536 DFHZATS has been changed so that it no longer attempts to re-validate a Termid when a remote shipped terminal is being replaced.
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
APAR Information
APAR number
PM13756
Reported component name
CICSTS V3 Z/OS
Reported component ID
5655M1500
Reported release
500
Status
CLOSED PER
PE
YesPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2010-05-04
Closed date
2010-09-17
Last modified date
2010-10-01
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
Modules/Macros
DFHZATS
Fix information
Fixed component name
CICSTS V3 Z/OS
Fixed component ID
5655M1500
Applicable component levels
R500 PSY UK60597
UP10/09/23 P F009
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 October 2010