PK65668: CICS TERMINAL AUTOINSTALL PROGRAM DISCARDS DUPLICATE TERMINAL ABENDAZVE AZVE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Customer is using their own terminal autoinstall exit.   A user
  logged onto AOR1, issued a transaction that ran in TOR1. This
  caused terminal WXYZ to be shipped to TOR1 and installed.
  She then logged off of AOR1, logged onto AOR2 with the same
  terminal, termid WXYZ.  Issued a transaction that was sent to
  TOR1, and in this region is where they received an ABENDAZVE-
  DFHZATS is trying to install a remote terminal with the same
  terminal id as an existing TCT entry.
  The problem here is that their autoinstall exit issued a
  DISCARD for this terminal WXYZ, so it was no longer a duplicate.
  Code in DFHZATS does an inquire for the terminal prior to
  calling the autoinstall exit, and assumes it is still there
  upon return from the exit, issuing the ABEND AZVE
  Additional Symptom(s) Search Keyword(s):
  KIXREVGJT
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: Transaction CITS abends AZVE when the   *
  *                      Terminal Autoinstall program issues an  *
  *                      EXEC CICS DISCARD of the selected       *
  *                      shipped terminal.                       *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  Transaction CITS (DFHZATS) is started to install a shipped
  terminal in an AOR, but finds that a Skeleton already exists
  for the same Termid from another TOR.
  The customer's URM is passed the Termid and told there is a
  clash with an existing entry. They choose to delete the Terminal
  with the EXEC CICS DISCARD instruction.
  
  On return to DFHZATS, the REPLACE_SHIPPED_TERMINAL routine still
  has a pointer to the now-freed Skeleton and finds that the
  storage indicates that it is no longer valid so abends AZVE.
  
  Additional keywords
  INSTALL_SHIPPED_TERM SELECTED_SHIPPED_TERMID CLASH
  REPLACE_SHIPPED_TERMINAL AbendAZVE LTERMID DELETE_SESSID
  

Problem conclusion

• DFHZATS has been amended to always check the CICS tables for the
  terminal selected by the URM; and if the terminal selected by
  the URM is not the alias, then the alias is deleted.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

• ž**** PE10/09/15 FIX IN ERROR. SEE APAR PM13756  FOR DESCRIPTION
  ž**** PE10/09/10 FIX IN ERROR. SEE APAR PM22158  FOR DESCRIPTION
  

APAR Information

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

  PK57904

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

  UK36532 UK36536

Modules/Macros

•    DFHZATS
  

Fix information

• Fixed component name

  CICSTS V3 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK36532

     UP08/05/27 P F805

• R500 PSY UK36536

     UP08/05/27 P F805

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.