IBM E027SLL-H Troubleshooting Guide - Page 117

Name Resolution, The First SEND

Page 117 highlights

Name Resolution IBM Tivoli Monitoring V6.1 depends on IBM's HPNS EZASMI getaddrinfo and EZASMI getnameinfo calls for resolver services. These calls are used to find the symbolic name and dotted-decimal IP address of the default network interface for the z/OS image. A failure in either EZASMI call results in failure to initialize the TCP/IP service for the z/OS address space. Confirming that the Name Resolution calls are successful: The following message indicates Name Resolution was successful: kdebprc.c,661,"interface_discovery") IPV4 interface list: 'SYSL' 9.42.46.26: source=hostname:0, seq=0, flags=0441 In this example, the interface 'SYSL' is found and source=hostname indicates that the host name SYSL was successfully resolved to an IP address. Repairing the Name Resolution failures: The following messages illustrate a Name Resolution failure: kdebprc.c,661,"interface_discovery") IPV4 interface list: 'WINMVS2C' 9.20.138.199: source=GE1, seq=0, flags=0441 kdebprc.c,214,"register_string") Unable to resolve interface address: WINMVS2C In the messages above, the absence of source=hostname indicates an interface was discovered but the name is not resolvable to an address. Typically, this error results when the z/OS image does not contain a TCP/IP resolver setup file that provides either GLOBAL or DEFAULT configuration data. Consequently, native z/OS address spaces are not enabled for name resolution by default. By adding a DD statement for SYSTCPD to the started task JCL of the IBM Tivoli Monitoring task (pointing to a usable file in USER.PARMLIB(TCPDATA)), resolver support can be enabled. The following messages illustrate a variant of name resolution failure: kdebprc.c,661,"interface_discovery") IPV6 interface list: 'NULL' "KDE1I_OpenTransportProvider") Status 1DE00048=KDE1_STC_NOINTERFACESREGISTERED The messages above indicate that no (IPV6) interface is registered. This can also result in TCP/IP service initialization failure for the IBM Tivoli Monitoring address space. The absence of an interface can only be fixed by the z/OS TCP/IP administrator. The First SEND This section provides information about confirming whether or not First SEND was successful as well as how to repair failures in the First SEND. Confirming that he First SEND was successful: The sequence of the following communication messages indicate the first SEND operation (an lb__lookup RPC request) and the first RECEIVE operation: "KDCR0_Send") request FFFF/0.0 (200): ip.pipe:#9.42.46.26[1918] "KDCR0_InboundPacket") response FFFE/0.0 (320): ip.pipe:#9.42.46.26[1918] "KDCL_GetBinding") Using LLB at ip.pipe:#9.42.46.26[1918] When the first network I/O is successful, the response indicates link and transport connectivity with the hub computer. Repairing the failures in the First SEND: There are two consideration specific to OS/390 and z/OS platforms: v RACF permission to the started task for the OMVS segment Chapter 5. Installation and configuration troubleshooting 99

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
  • 172
  • 173
  • 174
  • 175
  • 176
  • 177
  • 178
  • 179
  • 180
  • 181
  • 182
  • 183
  • 184
  • 185
  • 186
  • 187
  • 188
  • 189
  • 190
  • 191
  • 192
  • 193
  • 194
  • 195
  • 196
  • 197
  • 198
  • 199
  • 200
  • 201
  • 202
  • 203
  • 204
  • 205
  • 206
  • 207
  • 208
  • 209
  • 210
  • 211
  • 212
  • 213
  • 214
  • 215
  • 216
  • 217
  • 218
  • 219
  • 220
  • 221
  • 222
  • 223
  • 224
  • 225
  • 226
  • 227
  • 228
  • 229
  • 230
  • 231
  • 232
  • 233
  • 234
  • 235
  • 236
  • 237
  • 238
  • 239
  • 240
  • 241
  • 242
  • 243
  • 244
  • 245
  • 246
  • 247
  • 248
  • 249
  • 250
  • 251
  • 252
  • 253
  • 254
  • 255
  • 256
  • 257
  • 258
  • 259
  • 260
  • 261
  • 262
  • 263
  • 264
  • 265
  • 266
  • 267
  • 268
  • 269
  • 270
  • 271
  • 272
  • 273
  • 274
  • 275
  • 276
  • 277
  • 278
  • 279
  • 280
  • 281
  • 282
  • 283
  • 284
  • 285
  • 286
  • 287
  • 288
  • 289
  • 290
  • 291
  • 292
  • 293
  • 294
  • 295
  • 296
  • 297
  • 298
  • 299
  • 300
  • 301
  • 302
  • 303
  • 304
  • 305
  • 306
  • 307
  • 308
  • 309
  • 310

Name Resolution
IBM Tivoli Monitoring V6.1 depends on IBM's HPNS EZASMI getaddrinfo and
EZASMI getnameinfo calls for resolver services. These calls are used to find the
symbolic name and dotted-decimal IP address of the default network interface for
the z/OS image. A failure in either EZASMI call results in failure to initialize the
TCP/IP service for the z/OS address space.
Confirming that the Name Resolution calls are successful:
The following message indicates Name Resolution was successful:
kdebprc.c,661,"interface_discovery") IPV4 interface list: ’SYSL’
9.42.46.26: source=hostname:0, seq=0, flags=0441
In this example, the interface 'SYSL' is found and
source=hostname
indicates that
the host name SYSL was successfully resolved to an IP address.
Repairing the Name Resolution failures:
The following messages illustrate a Name Resolution failure:
kdebprc.c,661,"interface_discovery") IPV4 interface list: ’WINMVS2C’
9.20.138.199: source=GE1, seq=0, flags=0441
kdebprc.c,214,"register_string") Unable to resolve interface address: WINMVS2C
In the messages above, the absence of
source=hostname
indicates an interface was
discovered but the name is not resolvable to an address. Typically, this error results
when the z/OS image does not contain a TCP/IP resolver setup file that provides
either GLOBALor DEFAULT configuration data. Consequently, native z/OS
address spaces are not enabled for name resolution by default. By adding a DD
statement for SYSTCPD to the started task JCL of the IBM Tivoli Monitoring task
(pointing to a usable file in USER.PARMLIB(TCPDATA)), resolver support can be
enabled.
The following messages illustrate a variant of name resolution failure:
kdebprc.c,661,"interface_discovery") IPV6 interface list: ’NULL’
"KDE1I_OpenTransportProvider") Status 1DE00048=KDE1_STC_NOINTERFACESREGISTERED
The messages above indicate that no (IPV6) interface is registered. This can also
result in TCP/IP service initialization failure for the IBM Tivoli Monitoring address
space. The absence of an interface can only be fixed by the z/OS TCP/IP
administrator.
The First SEND
This section provides information about confirming whether or not First SEND
was successful as well as how to repair failures in the First SEND.
Confirming that he First SEND was successful:
The sequence of the following communication messages indicate the first SEND
operation (an lb__lookup RPC request) and the first RECEIVE operation:
"KDCR0_Send") request FFFF/0.0 (200): ip.pipe:#9.42.46.26[1918]
"KDCR0_InboundPacket") response FFFE/0.0 (320): ip.pipe:#9.42.46.26[1918]
"KDCL_GetBinding") Using LLB at ip.pipe:#9.42.46.26[1918]
When the first network I/O is successful, the response indicates link and transport
connectivity with the hub computer.
Repairing the failures in the First SEND:
There are two consideration specific to OS/390 and z/OS platforms:
v
RACF permission to the started task for the OMVS segment
Chapter 5. Installation and configuration troubleshooting
99