IBM Support

OA40162: DS623 ICAT TEMS CONFIGURATION UPDATES

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as new function.

Error description

  • OMEGAMON Enhanced 3270 User Interface (e3270UI) Data Retrieval
    Agent (DRA) startup (KOBAGENT) in the TEMS'
    &rhilev.&rte.RKANCMDU(KDSSTRT1) takes a minimum of 3 minutes
    and 10 seconds for the Tivoli OMEGAMON Manager (TOM) address
    space to start communicating with the z/OS TEMS that starts up
    the DRA because the TEMS has a built-in 3-minute delay for the
    TEMS itself to completely come up prior to starting up any of
    the Agents.
    

Local fix

  • In certain cases, the moving of the KOBAGENT IRAMAN startup to
    the RKANCMDU(KDSSTART) member from RKANCMDU(KDSSTRT1) may start
    the agent before the TEMS CTDS STARTUP fully initializes.  The
    timeout issues may occasionally happen causing the TEMS to
    encounter these types of messages in the RKLVLOG:
    ===============================================================
    (001A-D3E8C823:kdcsuse.c,120,"KDCS_UseFamily") status=1c010005,
    "cant bind socket", ncs/KDC1_STC_CANT_BIND_SOCKET
    Connection failure: "ip.pipe:#x.x.x.x:1918 Endpoint
    unresponsive: "ip:#x.x.x.x:1918", 1C010001:1DE0000F, 33,
    CT/DS RPC Error: DSR031 - CTDS_CreatePath RPC abend
    status=1c020006, "location server unavailable", ncs/KDC
    
    5,"socket__inq_my_netaddr") status=10020002, "socket buffer too
    small", ncs/KDC1
    
    Check local failed. status = 5
    Create Path Error. status 155 path NCS:{SOCKET=sna:USCACO01.TS
    } CT/DS:{SERVER=SRVR01 USER=OB}
    "Find_HUB") KOBDRA76E Unable to connect the the TEMS
    ========================================================
    
    If these conditions occur, the following circumvention may be
    used until a more permanent ITM and KOB resolution are
    available:
    1. In the RKANCMDU(KDSSTART) TEMS startup member, increase the
    delay interval in starting up the KOBAGENT
    DRA by increasing the "DELAY=hh:mm:ss" parameter as shown in the
    example below:
    AT ADD ID=KOB DELAY=00:01:00 CMD='IRAMAN KOBAGENT START'
                           =====
    
    2. If you have the following products installed and configured
    in the RTE where the TEMS is running:
    - OMEGAMON XE for CICS V5.1.0
    - OMEGAMON XE for DB2 V5.1.1
    - OMEGAMON XE on z/OS V5.1.0
    
    Then ensure that the following RKANDATV now-obsolete catalog
    files are removed from the TEMS RTE's RKANDATV library prior
    to starting up the TEMS:
    EDIT &rhilev.&rte.RKANDATV
    
    Command ===>
    
               Name     Prompt       Size   Created          Changed
    ID
    _________ KC5ATR
    _________ KC5CAT
    _________ KD5ATR
    _________ KD5CAT
    
    
    _________ KHLATR
    _________ KHLCAT
    
    These products renamed their RKANDATV catalog and attribute
    files in the new upgraded versions, which cause the TEMS to log
    the following duplicate attribute messages:
    ===========================================================
    2012.227 09:52:35.73
    (0001-C769FC4B:kglatrvl.c,193,"add_to_index") Warning: attribute
    name conflict
    
    2012.227 09:52:33.37
    (0006-C769FC4B:kglatrbk.c,893,"atrblk_set_format")  app <OMCICS>
    table <CICSEVD> column <CAPTURE> file <KC5ATR> timestamp
    <1110601172956000> line <5926>
    .
    .
    2012.227 09:52:38.65
    (70C6-C769FC4B:kglatrvl.c,194,"add_to_index")  app <KDP> table
    <KDP_CFG> column <ORIGINNODE>
    2012.227 09:52:38.65
    (70C7-C769FC4B:kglatrvl.c,194,"add_to_index") file <KDPATR>
    timestamp <1120426032318000> line <3>
    .
    .
    2012.227 09:52:45.23
    (282F-C769FC4B:kglatrvl.c,195,"add_to_index")  app <KM5> table
    <HLHCHKS> column <ORIGINNODE>
    2012.227 09:52:45.23
    (2830-C769FC4B:kglatrvl.c,195,"add_to_index")  file <KM5ATR>
    timestamp <1120502060715000> line <29579>
    .
    2012.227 09:52:45.28
    (2F99-C769FC4B:kglatrvl.c,195,"add_to_index")  enum count
    ==========================================================
    
    These duplicate attribute messages might contribute to the TEMS
    timeout so remove the obsolete RKANDATV files.  The ICAT or
    PARMGEN RTE Load job (pp#2xxxx ICAT / KCIJPLOD PARMGEN)
    typically deletes these members via its DELRUN step but if the
    RTE load job is not able to get exclusive enqueue on the
    RKANDATV library, the RTE Load job provides a warning condition
    code.
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CANDLE MANAGEMENT SERVER users.          *
    ****************************************************************
    * PROBLEM DESCRIPTION: OMEGAMON Enhanced 3270 User Interface   *
    *                      (e3270UI) Data Retrieval Agent (DRA)    *
    *                      startup (KOBAGENT) in the TEMS'         *
    *                      &rhilev.&rte.RKANCMDU(KDSSTRT1) takes a *
    *                      minimum of 3 minutes and 10 seconds for *
    *                      the Tivoli OMEGAMON Manager (TOM)       *
    *                      address space to start communicating    *
    *                      with the z/OS TEMS that starts up the   *
    *                      DRA because the TEMS has a built-in     *
    *                      3-minute delay for the TEMS itself to   *
    *                      completely come up prior to starting up *
    *                      any of the Agents.                      *
    ****************************************************************
    * RECOMMENDATION: Apply the PTF.                               *
    OMEGAMON Enhanced 3270 User Interface (e3270UI) Data Retrieval
    Agent (DRA) startup (KOBAGENT) in the TEMS'
    &rhilev.&rte.RKANCMDU(KDSSTRT1) takes a minimum of 3 minutes and
    10 seconds for the Tivoli OMEGAMON Manager (TOM) address space
    to start communicating with the z/OS TEMS that starts up the DRA
    because the TEMS has a built-in 3-minute delay for the TEMS
    itself to completely come up prior to starting up any of the
    Agents.
    

Problem conclusion

Temporary fix

Comments

  • Support a faster KOBAGENT Data Retrieval Agent (DRA) startup  in
    the z/OS TEMS address space, when the TEMS starts up the   DRA
    by moving the KOBAGENT startup IRAMAN command from
    &rhilev.&rte.RKANCMDU(KDSSTRT1) member to
    &rhilev.&rte.RKANCMDU(KDSSTART) right after the "CTDS
    STARTUP"statement, which is the main TEMS startup command.
    

APAR Information

  • APAR number

    OA40162

  • Reported component name

    MGMT SERVER DS

  • Reported component ID

    5608A2800

  • Reported release

    623

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    YesSpecatt / Serviceability

  • Submitted date

    2012-08-15

  • Closed date

    2012-08-15

  • Last modified date

    2012-09-05

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

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

    UA66248

Modules/Macros

  • KDS621SC
    

Fix information

  • Fixed component name

    MGMT SERVER DS

  • Fixed component ID

    5608A2800

Applicable component levels

  • R623 PSY UA66248

       UP12/08/29 P F208

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":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SSRJ5K","label":"Tivoli Management Server for Distributed Systems on z\/OS"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"623","Edition":"","Line of Business":{"code":"LOB17","label":"Mainframe TPS"}}]

Document Information

Modified date:
05 September 2012