IBM Support

PM21000: TRYING TO AUTOINSTALL A SHIPPED TERMINAL IN AN AOR YOU SOMETIMESRECEIVE ABENDAZVU AND ABENDAZTI AFTER UK36536

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                               *
    ****************************************************************
    * 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 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.
    
    Additional keywords: ABENDAZVU AZTI ABENDAZTI DFHAC2236
                         MSGDFHAC2236
    

Problem conclusion

  • 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

    PM21000

  • Reported component name

    CICS TS Z/OS V4

  • Reported component ID

    5655S9700

  • Reported release

    600

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2010-08-23

  • Closed date

    2010-09-17

  • Last modified date

    2010-10-02

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

    PM13756

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

    UK60537

Modules/Macros

  •    DFHZATS
    

Fix information

  • Fixed component name

    CICS TS Z/OS V4

  • Fixed component ID

    5655S9700

Applicable component levels

  • R600 PSY UK60537

       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":"4.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":"4.1","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
02 October 2010