kmcpeake | 4fe18c8 | 2015-11-17 20:07:39 +0000 | [diff] [blame] | 1 | /* |
| 2 | * Copyright 2015 Open Networking Laboratory |
| 3 | * |
| 4 | * Licensed under the Apache License, Version 2.0 (the "License"); |
| 5 | * you may not use this file except in compliance with the License. |
| 6 | * You may obtain a copy of the License at |
| 7 | * |
| 8 | * http://www.apache.org/licenses/LICENSE-2.0 |
| 9 | * |
| 10 | * Unless required by applicable law or agreed to in writing, software |
| 11 | * distributed under the License is distributed on an "AS IS" BASIS, |
| 12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| 13 | * See the License for the specific language governing permissions and |
| 14 | * limitations under the License. |
| 15 | */ |
| 16 | package org.onosproject.faultmanagement.impl; |
| 17 | |
kmcpeake | b172d5f | 2015-12-10 11:30:43 +0000 | [diff] [blame] | 18 | import static com.google.common.base.Preconditions.checkNotNull; |
kmcpeake | 4fe18c8 | 2015-11-17 20:07:39 +0000 | [diff] [blame] | 19 | import java.util.Dictionary; |
| 20 | import java.util.HashSet; |
| 21 | import java.util.Map; |
| 22 | import java.util.Set; |
| 23 | import java.util.concurrent.ConcurrentHashMap; |
kmcpeake | b172d5f | 2015-12-10 11:30:43 +0000 | [diff] [blame] | 24 | import static java.util.concurrent.Executors.newSingleThreadScheduledExecutor; |
| 25 | import java.util.concurrent.ScheduledExecutorService; |
| 26 | import java.util.stream.Collectors; |
| 27 | import org.apache.commons.collections.CollectionUtils; |
kmcpeake | 4fe18c8 | 2015-11-17 20:07:39 +0000 | [diff] [blame] | 28 | import org.apache.felix.scr.annotations.Activate; |
| 29 | import org.apache.felix.scr.annotations.Component; |
| 30 | import org.apache.felix.scr.annotations.Deactivate; |
| 31 | import org.apache.felix.scr.annotations.Modified; |
| 32 | import org.apache.felix.scr.annotations.Property; |
| 33 | import static org.onlab.util.Tools.nullIsNotFound; |
| 34 | |
| 35 | import org.onosproject.incubator.net.faultmanagement.alarm.Alarm; |
| 36 | import org.onosproject.incubator.net.faultmanagement.alarm.AlarmEntityId; |
| 37 | import org.onosproject.incubator.net.faultmanagement.alarm.AlarmEvent; |
| 38 | import org.onosproject.incubator.net.faultmanagement.alarm.AlarmId; |
| 39 | import org.onosproject.incubator.net.faultmanagement.alarm.AlarmListener; |
| 40 | import org.onosproject.incubator.net.faultmanagement.alarm.AlarmService; |
| 41 | import org.onosproject.net.ConnectPoint; |
| 42 | import org.onosproject.net.DeviceId; |
| 43 | import org.slf4j.Logger; |
| 44 | import static org.slf4j.LoggerFactory.getLogger; |
| 45 | import org.apache.felix.scr.annotations.Service; |
| 46 | import static org.onlab.util.Tools.get; |
| 47 | import org.onosproject.core.ApplicationId; |
| 48 | import org.onosproject.core.IdGenerator; |
| 49 | import org.onosproject.core.CoreService; |
| 50 | import org.apache.felix.scr.annotations.Reference; |
| 51 | import org.apache.felix.scr.annotations.ReferenceCardinality; |
| 52 | import org.onlab.util.ItemNotFoundException; |
kmcpeake | b172d5f | 2015-12-10 11:30:43 +0000 | [diff] [blame] | 53 | import org.onosproject.incubator.net.faultmanagement.alarm.AlarmProvider; |
kmcpeake | 4fe18c8 | 2015-11-17 20:07:39 +0000 | [diff] [blame] | 54 | import org.onosproject.incubator.net.faultmanagement.alarm.DefaultAlarm; |
kmcpeake | b172d5f | 2015-12-10 11:30:43 +0000 | [diff] [blame] | 55 | import org.onosproject.net.device.DeviceService; |
kmcpeake | 4fe18c8 | 2015-11-17 20:07:39 +0000 | [diff] [blame] | 56 | import org.osgi.service.component.ComponentContext; |
kmcpeake | b172d5f | 2015-12-10 11:30:43 +0000 | [diff] [blame] | 57 | import static java.util.concurrent.TimeUnit.SECONDS; |
| 58 | |
| 59 | import java.util.concurrent.atomic.AtomicLong; |
| 60 | import static org.onlab.util.Tools.groupedThreads; |
| 61 | import org.onosproject.net.Device; |
kmcpeake | 4fe18c8 | 2015-11-17 20:07:39 +0000 | [diff] [blame] | 62 | |
| 63 | /** |
| 64 | * Implementation of the Alarm service. |
| 65 | */ |
| 66 | @Component(immediate = true) |
| 67 | @Service |
| 68 | public class AlarmsManager implements AlarmService { |
| 69 | |
kmcpeake | b172d5f | 2015-12-10 11:30:43 +0000 | [diff] [blame] | 70 | // For subscribing to device-related events |
kmcpeake | 4fe18c8 | 2015-11-17 20:07:39 +0000 | [diff] [blame] | 71 | @Reference(cardinality = ReferenceCardinality.MANDATORY_UNARY) |
| 72 | protected CoreService coreService; |
kmcpeake | b172d5f | 2015-12-10 11:30:43 +0000 | [diff] [blame] | 73 | |
| 74 | @Reference(cardinality = ReferenceCardinality.MANDATORY_UNARY) |
| 75 | protected DeviceService deviceService; |
| 76 | |
| 77 | @Reference(cardinality = ReferenceCardinality.MANDATORY_UNARY) |
| 78 | protected AlarmProvider alarmProvider; |
| 79 | |
kmcpeake | 4fe18c8 | 2015-11-17 20:07:39 +0000 | [diff] [blame] | 80 | private final Logger log = getLogger(getClass()); |
| 81 | private ApplicationId appId; |
| 82 | private IdGenerator idGenerator; |
| 83 | |
kmcpeake | b172d5f | 2015-12-10 11:30:43 +0000 | [diff] [blame] | 84 | private ScheduledExecutorService alarmPollExecutor; |
kmcpeake | 4fe18c8 | 2015-11-17 20:07:39 +0000 | [diff] [blame] | 85 | |
kmcpeake | b172d5f | 2015-12-10 11:30:43 +0000 | [diff] [blame] | 86 | // dummy data |
kmcpeake | 4fe18c8 | 2015-11-17 20:07:39 +0000 | [diff] [blame] | 87 | private final AtomicLong alarmIdGenerator = new AtomicLong(0); |
| 88 | |
kmcpeake | b172d5f | 2015-12-10 11:30:43 +0000 | [diff] [blame] | 89 | private AlarmId generateAlarmId() { |
| 90 | return AlarmId.alarmId(alarmIdGenerator.incrementAndGet()); |
| 91 | } |
kmcpeake | 4fe18c8 | 2015-11-17 20:07:39 +0000 | [diff] [blame] | 92 | |
kmcpeake | b172d5f | 2015-12-10 11:30:43 +0000 | [diff] [blame] | 93 | private static final int DEFAULT_POLL_FREQUENCY_SECONDS = 120; |
| 94 | @Property(name = "alarmPollFrequencySeconds", intValue = DEFAULT_POLL_FREQUENCY_SECONDS, |
| 95 | label = "Frequency (in seconds) for polling alarm from devices") |
| 96 | private int alarmPollFrequencySeconds = DEFAULT_POLL_FREQUENCY_SECONDS; |
| 97 | |
| 98 | // TODO implement purging of old alarms. |
| 99 | private static final int DEFAULT_CLEAR_FREQUENCY_SECONDS = 500; |
| 100 | @Property(name = "clearedAlarmPurgeSeconds", intValue = DEFAULT_CLEAR_FREQUENCY_SECONDS, |
| 101 | label = "Frequency (in seconds) for deleting cleared alarms") |
| 102 | private int clearedAlarmPurgeFrequencySeconds = DEFAULT_CLEAR_FREQUENCY_SECONDS; |
| 103 | |
| 104 | // TODO Later should must be persisted to disk or database |
| 105 | private final Map<AlarmId, Alarm> alarms = new ConcurrentHashMap<>(); |
| 106 | |
| 107 | @Override |
| 108 | public Alarm updateBookkeepingFields(AlarmId id, boolean isAcknowledged, String assignedUser) { |
| 109 | |
| 110 | Alarm found = alarms.get(id); |
kmcpeake | 4fe18c8 | 2015-11-17 20:07:39 +0000 | [diff] [blame] | 111 | if (found == null) { |
kmcpeake | b172d5f | 2015-12-10 11:30:43 +0000 | [diff] [blame] | 112 | throw new ItemNotFoundException("Alarm with id " + id + " found"); |
kmcpeake | 4fe18c8 | 2015-11-17 20:07:39 +0000 | [diff] [blame] | 113 | } |
kmcpeake | b172d5f | 2015-12-10 11:30:43 +0000 | [diff] [blame] | 114 | |
| 115 | Alarm updated = new DefaultAlarm.Builder(found). |
| 116 | withAcknowledged(isAcknowledged). |
| 117 | withAssignedUser(assignedUser).build(); |
| 118 | alarms.put(id, updated); |
| 119 | return updated; |
| 120 | } |
| 121 | |
| 122 | public Alarm clear(AlarmId id) { |
| 123 | |
| 124 | Alarm found = alarms.get(id); |
| 125 | if (found == null) { |
| 126 | log.warn("id {} cant be cleared as it is already gone.", id); |
| 127 | return null; |
| 128 | } |
| 129 | Alarm updated = new DefaultAlarm.Builder(found).clear().build(); |
| 130 | alarms.put(id, updated); |
kmcpeake | 4fe18c8 | 2015-11-17 20:07:39 +0000 | [diff] [blame] | 131 | return updated; |
| 132 | } |
| 133 | |
| 134 | @Override |
kmcpeake | b172d5f | 2015-12-10 11:30:43 +0000 | [diff] [blame] | 135 | public Map<Alarm.SeverityLevel, Long> getAlarmCounts(DeviceId deviceId) { |
| 136 | |
| 137 | return getAlarms(deviceId).stream().collect( |
| 138 | Collectors.groupingBy(Alarm::severity, Collectors.counting())); |
| 139 | |
kmcpeake | 4fe18c8 | 2015-11-17 20:07:39 +0000 | [diff] [blame] | 140 | } |
kmcpeake | b172d5f | 2015-12-10 11:30:43 +0000 | [diff] [blame] | 141 | |
| 142 | @Override |
| 143 | public Map<Alarm.SeverityLevel, Long> getAlarmCounts() { |
| 144 | |
| 145 | return getAlarms().stream().collect( |
| 146 | Collectors.groupingBy(Alarm::severity, Collectors.counting())); |
| 147 | } |
| 148 | |
| 149 | |
kmcpeake | 4fe18c8 | 2015-11-17 20:07:39 +0000 | [diff] [blame] | 150 | private static final String NOT_SUPPORTED_YET = "Not supported yet."; |
| 151 | |
| 152 | @Override |
kmcpeake | a540481 | 2015-12-08 11:52:50 +0000 | [diff] [blame] | 153 | public Alarm getAlarm(AlarmId alarmId) { |
kmcpeake | 4fe18c8 | 2015-11-17 20:07:39 +0000 | [diff] [blame] | 154 | return nullIsNotFound( |
kmcpeake | b172d5f | 2015-12-10 11:30:43 +0000 | [diff] [blame] | 155 | alarms.get( |
| 156 | checkNotNull(alarmId, "Alarm Id cannot be null")), |
kmcpeake | 4fe18c8 | 2015-11-17 20:07:39 +0000 | [diff] [blame] | 157 | "Alarm is not found"); |
| 158 | } |
| 159 | |
| 160 | @Override |
| 161 | public Set<Alarm> getAlarms() { |
kmcpeake | b172d5f | 2015-12-10 11:30:43 +0000 | [diff] [blame] | 162 | return new HashSet<>(alarms.values()); |
kmcpeake | 4fe18c8 | 2015-11-17 20:07:39 +0000 | [diff] [blame] | 163 | } |
| 164 | |
| 165 | @Override |
| 166 | public Set<Alarm> getActiveAlarms() { |
kmcpeake | b172d5f | 2015-12-10 11:30:43 +0000 | [diff] [blame] | 167 | return alarms.values().stream().filter( |
| 168 | a -> !a.severity().equals(Alarm.SeverityLevel.CLEARED)). |
| 169 | collect(Collectors.toSet()); |
kmcpeake | 4fe18c8 | 2015-11-17 20:07:39 +0000 | [diff] [blame] | 170 | } |
| 171 | |
| 172 | @Override |
kmcpeake | a540481 | 2015-12-08 11:52:50 +0000 | [diff] [blame] | 173 | public Set<Alarm> getAlarms(Alarm.SeverityLevel severity) { |
kmcpeake | b172d5f | 2015-12-10 11:30:43 +0000 | [diff] [blame] | 174 | return alarms.values().stream().filter( |
| 175 | a -> a.severity().equals(severity)). |
| 176 | collect(Collectors.toSet()); |
kmcpeake | 4fe18c8 | 2015-11-17 20:07:39 +0000 | [diff] [blame] | 177 | } |
| 178 | |
| 179 | @Override |
kmcpeake | a540481 | 2015-12-08 11:52:50 +0000 | [diff] [blame] | 180 | public Set<Alarm> getAlarms(DeviceId deviceId) { |
kmcpeake | b172d5f | 2015-12-10 11:30:43 +0000 | [diff] [blame] | 181 | return alarms.values().stream().filter( |
| 182 | a -> deviceId.equals(a.deviceId())). |
| 183 | collect(Collectors.toSet()); |
| 184 | } |
| 185 | |
| 186 | private Set<Alarm> getActiveAlarms(DeviceId deviceId) { |
| 187 | return getActiveAlarms().stream().filter( |
| 188 | a -> deviceId.equals(a.deviceId())). |
| 189 | collect(Collectors.toSet()); |
kmcpeake | 4fe18c8 | 2015-11-17 20:07:39 +0000 | [diff] [blame] | 190 | } |
| 191 | |
| 192 | @Override |
kmcpeake | a540481 | 2015-12-08 11:52:50 +0000 | [diff] [blame] | 193 | public Set<Alarm> getAlarms(DeviceId deviceId, AlarmEntityId source) { |
kmcpeake | b172d5f | 2015-12-10 11:30:43 +0000 | [diff] [blame] | 194 | return getAlarms(deviceId).stream().filter( |
| 195 | a -> source.equals(a.source()) |
| 196 | ).collect(Collectors.toSet()); |
kmcpeake | 4fe18c8 | 2015-11-17 20:07:39 +0000 | [diff] [blame] | 197 | } |
| 198 | |
| 199 | @Override |
kmcpeake | a540481 | 2015-12-08 11:52:50 +0000 | [diff] [blame] | 200 | public Set<Alarm> getAlarmsForLink(ConnectPoint src, ConnectPoint dst) { |
kmcpeake | 4fe18c8 | 2015-11-17 20:07:39 +0000 | [diff] [blame] | 201 | //TODO |
| 202 | throw new UnsupportedOperationException(NOT_SUPPORTED_YET); |
| 203 | } |
| 204 | |
| 205 | @Override |
kmcpeake | a540481 | 2015-12-08 11:52:50 +0000 | [diff] [blame] | 206 | public Set<Alarm> getAlarmsForFlow(DeviceId deviceId, long flowId) { |
kmcpeake | 4fe18c8 | 2015-11-17 20:07:39 +0000 | [diff] [blame] | 207 | //TODO |
| 208 | throw new UnsupportedOperationException(NOT_SUPPORTED_YET); |
| 209 | } |
| 210 | |
kmcpeake | b172d5f | 2015-12-10 11:30:43 +0000 | [diff] [blame] | 211 | private final AlarmListener alarmListener = new InternalAlarmListener(); |
kmcpeake | 4fe18c8 | 2015-11-17 20:07:39 +0000 | [diff] [blame] | 212 | |
| 213 | private class InternalAlarmListener implements AlarmListener { |
| 214 | |
| 215 | @Override |
kmcpeake | a540481 | 2015-12-08 11:52:50 +0000 | [diff] [blame] | 216 | public void event(AlarmEvent event) { |
kmcpeake | b172d5f | 2015-12-10 11:30:43 +0000 | [diff] [blame] | 217 | log.debug("AlarmsManager. InternalAlarmListener received {}", event); |
| 218 | try { |
| 219 | |
| 220 | switch (event.type()) { |
| 221 | case DEVICE_DISCOVERY: |
| 222 | DeviceId deviceId = checkNotNull(event.getDeviceRefreshed(), "Listener cannot be null"); |
| 223 | log.info("New alarm set for {} received!", deviceId); |
| 224 | updateAlarms(event.subject(), deviceId); |
| 225 | break; |
| 226 | |
| 227 | case NOTIFICATION: |
| 228 | throw new IllegalArgumentException( |
| 229 | "Alarm Notifications (Traps) not expected or implemented yet. Received =" + event); |
| 230 | default: |
| 231 | break; |
| 232 | } |
| 233 | } catch (Exception e) { |
| 234 | log.warn("Failed to process {}", event, e); |
| 235 | } |
kmcpeake | 4fe18c8 | 2015-11-17 20:07:39 +0000 | [diff] [blame] | 236 | } |
| 237 | } |
| 238 | |
| 239 | @Activate |
kmcpeake | a540481 | 2015-12-08 11:52:50 +0000 | [diff] [blame] | 240 | public void activate(ComponentContext context) { |
kmcpeake | b172d5f | 2015-12-10 11:30:43 +0000 | [diff] [blame] | 241 | appId = coreService.registerApplication("org.onosproject.faultmanagement.alarms"); |
kmcpeake | 4fe18c8 | 2015-11-17 20:07:39 +0000 | [diff] [blame] | 242 | idGenerator = coreService.getIdGenerator("alarm-ids"); |
kmcpeake | b172d5f | 2015-12-10 11:30:43 +0000 | [diff] [blame] | 243 | log.info("Started with appId={}", appId); |
kmcpeake | 4fe18c8 | 2015-11-17 20:07:39 +0000 | [diff] [blame] | 244 | |
kmcpeake | b172d5f | 2015-12-10 11:30:43 +0000 | [diff] [blame] | 245 | alarmProvider.addAlarmListener(alarmListener); |
| 246 | |
| 247 | probeActiveDevices(); |
| 248 | |
| 249 | boolean result = modified(context); |
kmcpeake | 4fe18c8 | 2015-11-17 20:07:39 +0000 | [diff] [blame] | 250 | log.info("modified result = {}", result); |
| 251 | |
kmcpeake | b172d5f | 2015-12-10 11:30:43 +0000 | [diff] [blame] | 252 | alarmPollExecutor = newSingleThreadScheduledExecutor(groupedThreads("onos/fm", "alarms-poll-%d")); |
| 253 | alarmPollExecutor.scheduleAtFixedRate(new PollAlarmsTask(), |
| 254 | alarmPollFrequencySeconds, alarmPollFrequencySeconds, SECONDS); |
| 255 | |
| 256 | } |
| 257 | |
| 258 | /** |
| 259 | * Auxiliary task to keep alarms up to date. IN future release alarm-notifications will be used as an optimization |
| 260 | * so we dont have to wait until polling to detect changes. Furthermore with simple polling flapping alarms may be |
| 261 | * missed. |
| 262 | */ |
| 263 | private final class PollAlarmsTask implements Runnable { |
| 264 | |
| 265 | @Override |
| 266 | public void run() { |
| 267 | if (Thread.currentThread().isInterrupted()) { |
| 268 | log.info("Interrupted, quitting"); |
| 269 | return; |
| 270 | } |
| 271 | try { |
| 272 | probeActiveDevices(); |
| 273 | } catch (RuntimeException e) { |
| 274 | log.error("Exception thrown during alarm synchronization process", e); |
| 275 | } |
| 276 | } |
| 277 | } |
| 278 | |
| 279 | private void probeActiveDevices() { |
| 280 | Iterable<Device> devices = deviceService.getAvailableDevices(); |
| 281 | log.info("Refresh alarms for all available devices={} ...", devices); |
| 282 | for (Device d : devices) { |
| 283 | log.info("Lets tell alarm provider to refresh alarms for {} ...", d.id()); |
| 284 | alarmProvider.triggerProbe(d.id()); |
| 285 | } |
kmcpeake | 4fe18c8 | 2015-11-17 20:07:39 +0000 | [diff] [blame] | 286 | } |
| 287 | |
| 288 | @Deactivate |
kmcpeake | a540481 | 2015-12-08 11:52:50 +0000 | [diff] [blame] | 289 | public void deactivate(ComponentContext context) { |
kmcpeake | 4fe18c8 | 2015-11-17 20:07:39 +0000 | [diff] [blame] | 290 | log.info("Deactivate ..."); |
kmcpeake | b172d5f | 2015-12-10 11:30:43 +0000 | [diff] [blame] | 291 | alarmProvider.removeAlarmListener(alarmListener); |
kmcpeake | 4fe18c8 | 2015-11-17 20:07:39 +0000 | [diff] [blame] | 292 | |
kmcpeake | b172d5f | 2015-12-10 11:30:43 +0000 | [diff] [blame] | 293 | if (alarmPollExecutor != null) { |
| 294 | alarmPollExecutor.shutdownNow(); |
| 295 | } |
| 296 | alarms.clear(); |
kmcpeake | 4fe18c8 | 2015-11-17 20:07:39 +0000 | [diff] [blame] | 297 | log.info("Stopped"); |
| 298 | } |
| 299 | |
| 300 | @Modified |
kmcpeake | a540481 | 2015-12-08 11:52:50 +0000 | [diff] [blame] | 301 | public boolean modified(ComponentContext context) { |
kmcpeake | 4fe18c8 | 2015-11-17 20:07:39 +0000 | [diff] [blame] | 302 | log.info("context={}", context); |
| 303 | if (context == null) { |
| 304 | log.info("No configuration file"); |
| 305 | return false; |
| 306 | } |
kmcpeake | b172d5f | 2015-12-10 11:30:43 +0000 | [diff] [blame] | 307 | Dictionary<?, ?> properties = context.getProperties(); |
| 308 | String clearedAlarmPurgeSeconds = get(properties, "clearedAlarmPurgeSeconds"); |
kmcpeake | 4fe18c8 | 2015-11-17 20:07:39 +0000 | [diff] [blame] | 309 | |
kmcpeake | b172d5f | 2015-12-10 11:30:43 +0000 | [diff] [blame] | 310 | log.info("Settings: clearedAlarmPurgeSeconds={}", clearedAlarmPurgeSeconds); |
| 311 | |
kmcpeake | 4fe18c8 | 2015-11-17 20:07:39 +0000 | [diff] [blame] | 312 | return true; |
| 313 | } |
| 314 | |
kmcpeake | b172d5f | 2015-12-10 11:30:43 +0000 | [diff] [blame] | 315 | // Synchronised to prevent duplicate NE alarms being raised |
| 316 | synchronized void updateAlarms(Set<Alarm> discoveredSet, DeviceId deviceId) { |
| 317 | Set<Alarm> storedSet = getActiveAlarms(deviceId); |
| 318 | log.trace("currentNeAlarms={}. discoveredAlarms={}", storedSet, discoveredSet); |
| 319 | |
| 320 | if (CollectionUtils.isEqualCollection(storedSet, discoveredSet)) { |
| 321 | log.debug("Alarm lists are equivalent so no update for {}.", deviceId); |
| 322 | return; |
kmcpeake | 4fe18c8 | 2015-11-17 20:07:39 +0000 | [diff] [blame] | 323 | } |
kmcpeake | b172d5f | 2015-12-10 11:30:43 +0000 | [diff] [blame] | 324 | |
| 325 | storedSet.stream().filter( |
| 326 | (stored) -> (!discoveredSet.contains(stored))).forEach((stored) -> { |
| 327 | log.info("Alarm will be cleared as it is not on the element. Cleared alarm: {}.", stored); |
| 328 | clear(stored.id()); |
| 329 | }); |
| 330 | |
| 331 | discoveredSet.stream().filter( |
| 332 | (discovered) -> (!storedSet.contains(discovered))).forEach((discovered) -> { |
| 333 | log.info("Alarm will be raised as it is missing. New alarm: {}.", discovered); |
| 334 | AlarmId id = generateAlarmId(); |
| 335 | alarms.put(id, new DefaultAlarm.Builder(discovered).withId(id).build()); |
| 336 | }); |
kmcpeake | 4fe18c8 | 2015-11-17 20:07:39 +0000 | [diff] [blame] | 337 | } |
| 338 | |
| 339 | } |