A fix is available
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