IBM Support

PM13756: TRYING TO AUTOINSTALL A SHIPPED TERMINAL IN AN AOR YOU SOMETIMES RECEIVE ABENDAZVU AND ABENDAZTI AFTER UK36 10/09/15 PTF PECHANGE

A fix is available

Subscribe

You can track all active APARs for this component.

 

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:

    PM22158 PM21000 UK60597

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