OA40764: ADDING THE FQDN FIELD TO THE EIF EVENTS

A fix is available

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as new function.

Error description

  • The Event Pump source is currently uses VTAM CPname, not FQDN.
    This requires some customers to implement a post processing step
    to accommodate FQDN translation. One of them reported during the
    Event Pump trial that maintaining this translation lookup
    process was not efficient.
    

Local fix

  • Omnibus lookup table
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All Tivoli Event Pump for z/OS users.        *
    ****************************************************************
    * PROBLEM DESCRIPTION: Fully qualified domain name value was   *
    *                      added into EIF message as a source.     *
    ****************************************************************
    * RECOMMENDATION: Apply the PTF.                               *
    ****************************************************************
    Tivoli Event Pump for z/OS issues VTAM CPname as a source value
    in EIF messages. This APAR expands the capabilities of the
    Tivoli Event Pump for z/OS facility by providing the user with
    an option to insert the fully qualified domain name (FQDN) value
    of the running machine into EIF messages. This APAR does not
    change the behavior of Tivoli Event Pump for z/OS functionality,
    all features will work as before after applying this fix. The
    VTAM CPname source values are still supported and issued as the
    default after applying this APAR.
    
    The user should add the EIF_FQDN=YES parameter into master
    startup parameter member, (GPZPARMS) to enable FQDN.
    
    EIF_FQDN has the following format:
    
      EIF_FQDN= YES | NO
    
    where NO is the default value.
    If the value of the EIF_FQDN parameter is different from YES or
    NO, the default value is used.
    
    Tivoli Event Pump for z/OS issues a request to the system
    Resolver to retrieve the fully qualified domain name of the
    running machine. Make sure that your system and/or application
    has been properly configured to be able resolve the FQDN. Tivoli
    Event Pump for z/OS uses the host name for the FQDN value in
    cases where the request to the Resolver fails. Please see the
    IP Configuration Guide for more information about system
    Resolver.
    

Problem conclusion

Temporary fix

Comments

  • The following information should be added into Chapter 2. Master
    address space parameters (GPZPARMS) of Configuration Reference
    for IBM Tivoli Event Pump for z/OS Version 4.2.2 documentation:
    
    EIF_FQDN
    
    Purpose
    
      Specifies whether the fully qualified domain name will be used
      as a source in the EIF message instead of VTAM CPname.
    
    Syntax
    
                         +--NO---+
                         |       |
      >>--- EIF_FQDN= ---+-------+---><
                         |       |
                         +--YES--+
    
    Operand Descriptions
    
      NO    Specifies to use the using VTAM CPname as a source in
            the EIF message. This is a default value.
      YES   Specifies to use the using fully qualified domain name
            as the source in EIF message.
    
    Usage Notes
    
    If the value specified for the EIF_FQDN value is not YES for NO,
    the default value is used.
    
    Tivoli Event Pump for z/OS issues a request to the system
    Resolver to retrieve the fully qualified domain name of the
    running machine. Make sure that your system and/or application
    has been properly configured to be able resolve the FQDN.
    Tivoli Event Pump for z/OS uses the host name for the FQDN value
    in cases where the request to the Resolver fails. Please see the
    IP Configuration Guide for more information about system
    Resolver.
    
    This statement is also valid for the event distributor (GTMSRVR)
    startup procedure in a 3-address-space environment. For the
    GTMSRVR startup procedure, the data set is specified by the
    AOPSYSIN  DD statement.
    
    The following information should be added into Chapter 2. GTM
    prefix messages of Message Reference for IBM Tivoli Event Pump
    for z/OS Version 4.2.2 documentation:
    
    GTM5610W    FULLY QUALIFIED DOMAIN NAME CANNOT BE RESOLVED, USE
                HOST NAME FOR FQDN
    
    
    Explanation:   Tivoli Event Pump for z/OS was unable to resolve
                   the fully qualified domain name of the running
                   machine.
    
    System action: Processing continues. Tivoli Event Pump for z/OS
                   uses the host name for the FQDN value in cases
                   where the request to the Resolver fails.
    
    Administrator response: Check the configuration of system
                   Resolver. Make sure that your system and/or
                   application has been properly configured to be
                   able resolve the fully qualified domain name of
                   the running machine. Please see the IP
                   Configuration Guide for more information about
                   system Resolver.
    

APAR Information

  • APAR number

    OA40764

  • Reported component name

    EVENT PUMP FOR

  • Reported component ID

    5698B3400

  • Reported release

    422

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    YesSpecatt / New Function

  • Submitted date

    2012-11-07

  • Closed date

    2012-12-05

  • Last modified date

    2013-01-02

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

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

    UA67420

Modules/Macros

  • GPZ$SUBI GTMAOPD9 GTMAOPE0 GTMAOPE1 GTMAOPG5
    GTMAOPG7 GTMAOPH3 GTMAOP58 GTMCATSC GTMEIF00 GTMEIF01 GTMEIF02
    GTMEIF03 GTMEIF05 GTMINFO  GTMIPRCV GTMIPREV GTMIPSND GTMPARMS
    GTMRXIPJ GTMSEND  GTMUCBSC GTMVTOC
    

Publications Referenced
SC27404100 GC27231005      

Fix information

  • Fixed component name

    EVENT PUMP FOR

  • Fixed component ID

    5698B3400

Applicable component levels

  • R422 PSY UA67420

       UP12/12/11 P F212

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.



Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

Tivoli Event Pump for z/OS

Software version:

422

Reference #:

OA40764

Modified date:

2013-01-02

Translate my page

Machine Translation

Content navigation