<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE rfc [
  <!ENTITY nbsp    "&#160;">
  <!ENTITY zwsp   "&#8203;">
  <!ENTITY nbhy   "&#8209;">
  <!ENTITY wj     "&#8288;">
]>
<?xml-stylesheet type="text/xsl" href="rfc2629.xslt" ?>
<!-- generated by https://github.com/cabo/kramdown-rfc version 1.7.21 (Ruby 3.2.3) -->
<rfc xmlns:xi="http://www.w3.org/2001/XInclude" ipr="trust200902" docName="draft-yu-ccamp-resource-pm-yang-04" category="std" consensus="true" submissionType="IETF" tocInclude="true" sortRefs="true" symRefs="true" version="3">
  <!-- xml2rfc v2v3 conversion 3.25.0 -->
  <front>
    <title abbrev="Resource PM YANG">A YANG Data Model for Resource Performance Monitoring</title>
    <seriesInfo name="Internet-Draft" value="draft-yu-ccamp-resource-pm-yang-04"/>
    <author fullname="Chaode Yu">
      <organization>Huawei Technologies</organization>
      <address>
        <email>yuchaode@huawei.com</email>
      </address>
    </author>
    <author initials="F." surname="Peruzzini" fullname="Fabio Peruzzini">
      <organization>FiberCop</organization>
      <address>
        <email>fabio.peruzzini@fibercop.com</email>
      </address>
    </author>
    <author initials="Y." surname="Zheng" fullname="Yanlei Zheng">
      <organization>China Unicom</organization>
      <address>
        <email>zhengyanlei@chinaunicom.cn</email>
      </address>
    </author>
    <author initials="I." surname="Busi" fullname="Italo Busi">
      <organization>Huawei Technologies</organization>
      <address>
        <email>italo.busi@huawei.com</email>
      </address>
    </author>
    <author initials="A." surname="Guo" fullname="Aihua Guo">
      <organization>Futurewei Technologies</organization>
      <address>
        <email>aihuaguo.ietf@gmail.com</email>
      </address>
    </author>
    <author initials="V." surname="Lopez" fullname="Victor Lopez">
      <organization>Nokia</organization>
      <address>
        <email>victor.lopez@nokia.com</email>
      </address>
    </author>
    <author initials="X." surname="Zhao" fullname="Xing Zhao">
      <organization>CAICT</organization>
      <address>
        <email>zhaoxing@caict.ac.cn</email>
      </address>
    </author>
    <author initials="M." surname="Jin" fullname="Mingshuang Jin">
      <organization>Huawei Technologies</organization>
      <address>
        <email>jinmingshuang@huawei.com</email>
      </address>
    </author>
    <date year="2026" month="January" day="07"/>
    <area>Routing</area>
    <workgroup>Common Control and Measurement Plane</workgroup>
    <keyword>next generation</keyword>
    <keyword>unicorn</keyword>
    <keyword>sparkling distributed ledger</keyword>
    <abstract>
      <?line 76?>

<t>This document defines a YANG data model for resource Performance Monitoring, applicable to network controllers,  which provides the functionalities of retrieval of performance monitoring capabilities, TCA (Threshold Crossing Alert) configuration, current or history performance data retrieval, and performance monitoring task management.</t>
    </abstract>
    <note removeInRFC="true">
      <name>About This Document</name>
      <t>
        The latest revision of this draft can be found at <eref target="https://YuChaode.github.io/draft-yu-ccamp-resource-pm-yang/draft-yu-ccamp-resource-pm-yang.html"/>.
        Status information for this document may be found at <eref target="https://datatracker.ietf.org/doc/draft-yu-ccamp-resource-pm-yang/"/>.
      </t>
      <t>
        Discussion of this document takes place on the
        Common Control and Measurement Plane Working Group mailing list (<eref target="mailto:ccamp@ietf.org"/>),
        which is archived at <eref target="https://mailarchive.ietf.org/arch/browse/ccamp/"/>.
        Subscribe at <eref target="https://www.ietf.org/mailman/listinfo/ccamp/"/>.
      </t>
      <t>Source for this draft and an issue tracker can be found at
        <eref target="https://github.com/YuChaode/draft-yu-ccamp-resource-pm-yang"/>.</t>
    </note>
  </front>
  <middle>
    <?line 80?>

<section anchor="introduction">
      <name>Introduction</name>
      <t>Resource performance monitoring is a basic function of network management. By viewing and analyzing the performance data of different resources (such as network element, interface, board, termination point, tunnel termination point) operators can detect the running state of the network in time, quickly resolve real-time problems or identify major risks in advanced , avoiding users' complaints.</t>
      <t>According to the business requirements stated in <xref target="TMF-518"/>, resource performance monitoring requirements include:</t>
      <ul spacing="normal">
        <li>
          <t>Retrieval of current and historical performance measurements for network resources</t>
        </li>
        <li>
          <t>Distribution of Threshold Crossing Alerts (TCAs) to the collectors of PM data</t>
        </li>
        <li>
          <t>Control of performance monitoring in the network: enable/disable of PM collection and TCA generation</t>
        </li>
      </ul>
      <t>Currently, there are some existing documents related to performance monitoring in IETF, but there is no overlap with our current work. The relative monitored objects are summarized in Table 1.</t>
      <table>
        <thead>
          <tr>
            <th align="left">YANG Module</th>
            <th align="left">Performance-Monitored Object</th>
            <th align="left">Reference</th>
          </tr>
        </thead>
        <tbody>
          <tr>
            <td align="left">ietf-te-telemetry, ietf-vn-telemetry</td>
            <td align="left">TE tunnel, virtual network</td>
            <td align="left">
              <xref target="I-D.ietf-teas-actn-pm-telemetry-autonomics"/></td>
          </tr>
          <tr>
            <td align="left">ietf-network-vpn-pm</td>
            <td align="left">VPN service topology</td>
            <td align="left">
              <xref target="RFC9375"/></td>
          </tr>
          <tr>
            <td align="left">ietf-service-pm</td>
            <td align="left">Transport network service</td>
            <td align="left">
              <xref target="I-D.zheng-ccamp-client-pm-yang"/></td>
          </tr>
          <tr>
            <td align="left">ietf-lmap-control, ietf-lmap-report</td>
            <td align="left">massive measurement agents in broadband service</td>
            <td align="left">
              <xref target="RFC8194"/></td>
          </tr>
        </tbody>
      </table>
      <t><xref target="I-D.ietf-teas-actn-pm-telemetry-autonomics"/> provides a YANG data model that describes performance monitoring and scaling intent mechanisms for TE-Tunnels and Virtual Networks(VNs). <xref target="I-D.ietf-opsawg-yang-vpn-service-pm"/> defines a YANG data model for performance monitoring of both network topology layer and overlay VPN service topology layer. <xref target="I-D.zheng-ccamp-client-pm-yang"/> provides a performance monitoring YANG data model on client signal level. <xref target="RFC8194"/> defines a data model for Large-Scale Measurement Platforms(LMAP), focusing on  task capability and configuration of massive measurement agents.</t>
      <t>This document defines a YANG module for resource performance monitoring, which defines the capabilities of resource performance monitoring, the tca configuration model of a specific resource. In addition, the sub-module of monitoring task and a few RPCs are defined to support the operations of performance monitoring, such as data retrieval and controlling the monitoring tasks.</t>
      <t>The YANG data model defined in this document conforms to the Network Management Datastore Architecture (NMDA) defined in <xref target="RFC8342"/>.</t>
      <section anchor="terminology-and-notations">
        <name>Terminology and Notations</name>
        <t>Refer to <xref target="RFC7446"/> and <xref target="RFC7581"/> for the key terms used in this document.  The following terms are defined in <xref target="RFC7950"/> and are not redefined here:
*  client
*  server
*  augment
*  data model
*  data node</t>
        <t>The following terms are defined in <xref target="RFC6241"/> and are not redefined here:
*  configuration data
*  state data</t>
        <t>The following terms are defined in <xref target="RFC8454"/> and are not redefined here:
*  CMI
*  MPI
*  MDSC
*  CNC
*  PNC</t>
        <ul empty="true">
          <li>
            <t>To Be Added: some explanation of performance indicator</t>
          </li>
        </ul>
      </section>
      <section anchor="tree-diagram">
        <name>Tree Diagram</name>
        <t>A simplified graphical representation of the data model is used in Section 3 of this document.  The meaning of the symbols in these diagrams are defined in <xref target="RFC8340"/>.</t>
      </section>
      <section anchor="prefix-in-data-node-names">
        <name>Prefix in Data Node Names</name>
        <t>In this document, names of data nodes and other data model objects are prefixed using the standard prefix associated with the corresponding YANG imported modules, as shown in the following table.</t>
        <table anchor="tab-prefixes">
          <name>Prefixes and corresponding YANG modules</name>
          <thead>
            <tr>
              <th align="left">Prefix</th>
              <th align="left">Yang Module</th>
              <th align="left">Reference</th>
            </tr>
          </thead>
          <tbody>
            <tr>
              <td align="left">rpm</td>
              <td align="left">ietf-resource-pm</td>
              <td align="left">RFC XXXX</td>
            </tr>
            <tr>
              <td align="left">rpm-types</td>
              <td align="left">ietf-resource-pm-types</td>
              <td align="left">RFC XXXX</td>
            </tr>
            <tr>
              <td align="left">yang</td>
              <td align="left">ietf-yang-types</td>
              <td align="left">
                <xref target="RFC6991"/></td>
            </tr>
          </tbody>
        </table>
        <t>RFC Editor Note:
Please replace XXXX with the RFC number assigned to this document.</t>
      </section>
    </section>
    <section anchor="yang-data-model-for-resource-performance-monitoring">
      <name>YANG Data Model for Resource Performance Monitoring</name>
      <section anchor="capabilities-of-resource-performance-monitoring">
        <name>Capabilities of Resource Performance Monitoring</name>
        <t>### Supported Resources and Corresponding PM Capabilities
A generic "resources" structure is defined to describe the objects that could be monitored:</t>
        <ul spacing="normal">
          <li>
            <t>"resource":  the identifier of a monitored object</t>
          </li>
          <li>
            <t>"resource-type": indicate what exact kind of resource is</t>
          </li>
          <li>
            <t>"holding time": the longest time period that performance data could be monitored</t>
          </li>
          <li>
            <t>"indicator name": the indicators that could be monitored for the resource</t>
          </li>
          <li>
            <t>"sub-resources": the identifier of the performace monitoring point of this resource (e.g., if the resource is a network element, the sub resources may be a list of termination points)</t>
          </li>
        </ul>
        <artwork type="ascii-art"><![CDATA[
module: ietf-resource-pm
   +--rw performance-monitoring
      +--rw resources
         +--rw resource-list* [resource]
            +--rw resource             union
            +--ro resource-type?       identityref
            +--ro holding-time?     uint8
            +--ro indicator-name*   string
            +--ro sub-resources*    -> ../resource
]]></artwork>
        <section anchor="introduction-of-performance-indicators">
          <name>Introduction of Performance Indicators</name>
          <t>It is impossible to list all the PM indicator exhaustively, even if ITU-T and IETF has done a lot of work.  Some new performance indicators would be raised once there are some new requirements and technologies. So in this document we would like to provide String type rather than an explicit type for performance indicator, to have a better compatibility for future extension. Then if there are some new indicators, there is no need to revise this document or create a branch of documents to standardize the PM indicators.</t>
          <t>For optical network, a performance management information table in the session10.2 of <xref target="ITU-T_G.874"/> lists all the PM current data and history data collected on the EMF(Equipment Management Function). A few indicators of different resources are listed below as an example.</t>
          <t>// To be added: performance indicators of different resources in optical network.</t>
          <t>For IP network, a few indicators of different resources are listed below as an example.
For a network element, following are possible indicators:
* CPU usage.
* Memory usage.
* Total active routes.
* Total active mac entries.</t>
          <t>For an interface, following are possible indicators:
* Ingress unicast packets.
* Ingress multicast packets.
* Ingress discard packets.
* Ingress error packets.
* Ingress unknown protocol packets.
* Egress unicast packets.
* Egress multicast packets.
* Egress discard packets.
* Egress error packets.</t>
          <t>For a board, following are possible indicators:
* CPU usage.
* Memory usage.</t>
        </section>
      </section>
      <section anchor="threshold-crossing-alert-control">
        <name>Threshold Crossing Alert Control</name>
        <t>Threshold crossing alert control parameters could be set directly for a resource, or set through applying an existing profile to the resource. Therefore, there are four main requirements for Threshold Crossing Alert Control:</t>
        <ul spacing="normal">
          <li>
            <t>Creation/retrieval/deletion/updating of TCA profile;</t>
          </li>
          <li>
            <t>Enabling/disabling TCA reporting on the resource;</t>
          </li>
          <li>
            <t>Configuring TCA on the resource by associating an existing profile;</t>
          </li>
          <li>
            <t>Configuring TCA on the resource by detailed parameters.</t>
          </li>
        </ul>
        <t>To satisfy the above requirements, the module defines "tca-management", including the "profile" structure to enable the preset of tca parameters, "tca" structure to describe the tca parameters (directly set or preset by applying profiles) and tca status of a specific resource.</t>
        <t>And for the TCA parameters, no matter it is configured directly on the resource or by a preset profile, there should not be any differences. The TCA parameters (tca-indicator) should include:</t>
        <ul spacing="normal">
          <li>
            <t>Threshold-type: This threshold type is used to indicate when the alert will be triggered.  By exceeding the upper bound value, or by below the lower bound value.</t>
          </li>
          <li>
            <t>Period: This period is used to indicate the frequency of the data collection.</t>
          </li>
          <li>
            <t>Severity: This severity is used to indicate what level of alert would be triggered if cross the threshold.</t>
          </li>
          <li>
            <t>Indicator-value: The value of threshold.</t>
          </li>
          <li>
            <t>Indicator-value-unit: The unit of threshold value.</t>
          </li>
        </ul>
        <t>In addition, the function of enabling/disabling TCA on the resource can be controlled by the "admin-status" attribute in "tca" node. The pre-defined profiles with unique profile id could be applied to "tca" node, shown as "applied-profiles" in "tca" node.</t>
        <artwork type="ascii-art"><![CDATA[
module: ietf-resource-pm
  +--rw performance-monitoring
     +--rw tca-management
     |  +--rw profiles
     |  |  +--rw profile* [profile-id]
     |  |     +--rw profile-id      yang:uuid
     |  |     +--rw profile-name?   string
     |  |     +--rw tca-cfg
     |  |        +--rw tca-indicator* [indicator-name threshold-type period severity]
     |  |           +--rw indicator-name          string
     |  |           +--rw indicator-value         string
     |  |           +--rw indicator-value-unit    string
     |  |           +--rw threshold-type          enumeration
     |  |           +--rw period                  identityref
     |  |           +--rw severity                identityref
     |  +--rw tcas
     |     +--rw tca* [resource]
     |        +--rw resource            -> /performance-monitoring/resources/resource-list/resource
     |        +--ro resource-type?      identityref
     |        +--rw admin-status?       enumeration
     |        +--rw applied-profiles
     |        |  +--rw profile* [profile-id]
     |        |     +--rw profile-id    -> ../../../../../profiles/profile/profile-id
     |        +--rw tca-cfg
     |           +--rw tca-indicator* [indicator-name threshold-type period severity]
     |              +--rw indicator-name          string
     |              +--rw indicator-value         string
     |              +--rw indicator-value-unit    string
     |              +--rw threshold-type          enumeration
     |              +--rw period                  identityref
     |              +--rw severity                identityref
]]></artwork>
      </section>
      <section anchor="data-retrieval-of-resource-performance-monitoring">
        <name>Data Retrieval of Resource Performance Monitoring</name>
        <section anchor="get-currenthistory-performance-monitoring-data">
          <name>Get Current/History Performance Monitoring Data</name>
          <t>For the retrieval of current/history performance data, we consider these data are not suitable to define in a data model.  Because performance data can be changed frequently and if we follow that approach, according to the requirement of on-change notification in YANG-push <xref target="RFC8641"/>, once the performance data changes, the controller should trigger a notification to the northbound system, there would be great number of notifications reported in the big network.</t>
          <t>These two retrieval interfaces are usually invoked on-demand. It is also hard to support retrieving performance data of multiple resources by data model in one request. And for history performance data retrieval, there could be a requirement to specify the start time and end time.  It is not quite flexible to support this requirement by data model neither. So we suggest to define an RPC to accomplish these two functions.</t>
          <artwork type="ascii-art"><![CDATA[
  rpcs:
    +---x get-pm-data
    |  +---w input
    |  |  +---w resources*                     -> /performance-monitoring/resources/resource-list/resource
    |  |  +---w is-requesting-history-data?   boolean
    |  |  +---w start-time?                    yang:date-and-time
    |  |  +---w end-time?                      yang:date-and-time
    |  +--ro output
    |     +--ro pm-data
    |        +--ro pm-data-list* [resource]
    |           +--ro resource          -> /performance-monitoring/resources/resource-list/resource
    |           +--ro task-id*          yang:uuid
    |           +--ro collect-time?     yang:date-and-time
    |           +--ro resource-type?    identityref
    |           +--ro indicator-data
    |              +--ro indicator-data-list* [indicator-name]
    |                 +--ro indicator-name          string
    |                 +--ro indicator-value?        string
    |                 +--ro indicator-value-unit?   string
]]></artwork>
        </section>
        <section anchor="get-profile-associated-resources">
          <name>Get Profile Associated Resources</name>
          <t>For the TCA related definition, it can be found in the previous Section (Section2.2). A TCA profile can be associated with a lot of resources, so we don't defined a resource list under the profile instance to avoid reporting some unnecessary notifications while the resource instances in this list have been changed. We define an RPC operation to support this flexible retrieval request.</t>
          <artwork type="ascii-art"><![CDATA[
  rpcs:
    +---x get-profile-associated-resources
       +---w input
       |  +---w profile-id?   -> /performance-monitoring/tca-management/profiles/profile/profile-id
       +--ro output
          +--ro resource-list*   -> /performance-monitoring/resources/resource-list/resource
]]></artwork>
        </section>
      </section>
      <section anchor="controlling-of-resource-performance-monitoring">
        <name>Controlling of Resource Performance Monitoring</name>
        <section anchor="clear-performance-monitoring-data-of-specific-resources">
          <name>Clear Performance Monitoring Data of Specific Resources</name>
          <t>We define an RPC to enable clearing the performance monitoring data of specified resources. If there are any resources failed to clear performance monitoring data, their identifier should be returned by the failed-resources leaf list. An empty list indicates that this operation was performed successfully.</t>
          <artwork type="ascii-art"><![CDATA[
  rpcs:
    +---x clear-performance-monitoring-data
    |  +---w input
    |  |  +---w resources*   -> /performance-monitoring/resources/resource-list/resource
    |  +--ro output
    |     +--ro failed-resources*   -> /performance-monitoring/resources/resource-list/resource
]]></artwork>
        </section>
        <section anchor="enabledisable-performance-monitoring">
          <name>Enable/Disable Performance Monitoring</name>
          <t>To enable/disable performance monitoring data, we introduce a monitor task to do this control. In the monitoring task, the resource, the monitored period, the monitored indicators could be set. The disabling, enabling operation can be satisfied by changing the admin status which includes disabled, enabled. The change's result will affect the task status accordingly.</t>
          <artwork type="ascii-art"><![CDATA[
   module: ietf-resource-pm
      +--rw performance-monitoring
         +--rw monitor-tasks
         |  +--rw monitor-task* [task-id]
         |     +--rw task-id          yang:uuid
         |     +--rw resource-id?     leafref
         |     +--ro resource-type?   identityref
         |     +--rw task-name?       string
         |     +--rw admin-status?    enumeration
         |     +--ro task-status?     enumeration
         |     +--rw task-cfg
         |        +--rw period?       identityref
         |        +--rw indicators
         |           +--rw indicator* [indicator-name]
         |              +--rw indicator-name          string
         |              +--rw indicator-value-unit?   string
]]></artwork>
        </section>
      </section>
    </section>
    <section anchor="resource-performance-monitoring-tree-diagram">
      <name>Resource Performance Monitoring Tree Diagram</name>
      <figure anchor="fig-rpm-tree">
        <name>Resource Performance Monitoring tree diagram</name>
        <artwork type="ascii-art" name="ietf-resource-pm.tree"><![CDATA[
=============== NOTE: '\' line wrapping per RFC 8792 ================

module: ietf-resource-pm
  +--rw performance-monitoring
     +--rw resources
     |  +--rw resource-list* [resource]
     |     +--rw resource          union
     |     +--ro resource-type?    identityref
     |     +--ro holding-time?     uint8
     |     +--ro indicator-name*   string
     |     +--ro sub-resources*    -> ../resource
     +--rw tca-management
     |  +--rw profiles
     |  |  +--rw profile* [profile-id]
     |  |     +--rw profile-id      yang:uuid
     |  |     +--rw profile-name?   string
     |  |     +--rw tca-cfg
     |  |        +--rw tca-indicator*
     |  |                [indicator-name threshold-type period \
                                                            severity]
     |  |           +--rw indicator-name          string
     |  |           +--rw indicator-value         string
     |  |           +--rw indicator-value-unit    string
     |  |           +--rw threshold-type          enumeration
     |  |           +--rw period                  identityref
     |  |           +--rw severity                identityref
     |  +--rw tcas
     |     +--rw tca* [resource]
     |        +--rw resource            leafref
     |        +--ro resource-type?      identityref
     |        +--rw admin-status?       enumeration
     |        +--rw applied-profiles
     |        |  +--rw profile* [profile-id]
     |        |     +--rw profile-id    leafref
     |        +--rw tca-cfg
     |           +--rw tca-indicator*
     |                   [indicator-name threshold-type period \
                                                            severity]
     |              +--rw indicator-name          string
     |              +--rw indicator-value         string
     |              +--rw indicator-value-unit    string
     |              +--rw threshold-type          enumeration
     |              +--rw period                  identityref
     |              +--rw severity                identityref
     +--rw monitor-tasks
        +--rw monitor-task* [task-id]
           +--rw task-id          yang:uuid
           +--rw resource?        leafref
           +--ro resource-type?   identityref
           +--rw task-name?       string
           +--rw admin-status?    enumeration
           +--ro task-status?     enumeration
           +--rw task-cfg
              +--rw period?       identityref
              +--rw indicators
                 +--rw indicator* [indicator-name]
                    +--rw indicator-name          string
                    +--rw indicator-value-unit?   string

  rpcs:
    +---x get-pm-data
    |  +---w input
    |  |  +---w resources*                    leafref
    |  |  +---w is-requesting-history-data?   boolean
    |  |  +---w start-time?                   yang:date-and-time
    |  |  +---w end-time?                     yang:date-and-time
    |  +--ro output
    |     +--ro pm-data
    |        +--ro pm-data-list* [resource]
    |           +--ro resource          leafref
    |           +--ro task-id*          yang:uuid
    |           +--ro collect-time?     yang:date-and-time
    |           +--ro resource-type?    identityref
    |           +--ro indicator-data
    |              +--ro indicator-data-list* [indicator-name]
    |                 +--ro indicator-name          string
    |                 +--ro indicator-value?        string
    |                 +--ro indicator-value-unit?   string
    +---x clear-performance-monitoring-data
    |  +---w input
    |  |  +---w resources*   leafref
    |  +--ro output
    |     +--ro failed-resources*   leafref
    +---x get-profile-associated-resources
       +---w input
       |  +---w profile-id?   leafref
       +--ro output
          +--ro resource-list*   leafref
]]></artwork>
      </figure>
    </section>
    <section anchor="yang-model-for-resource-performance-monitoring">
      <name>YANG Model for Resource Performance Monitoring</name>
      <figure anchor="fig-rpm-yang">
        <name>Resource Performance Monitoring YANG module</name>
        <sourcecode type="yang" markers="true" name="ietf-resource-pm@2025-07-04.yang"><![CDATA[
module ietf-resource-pm {
  yang-version 1.1;
  namespace "urn:ietf:params:xml:ns:yang:ietf-resource-pm";
  prefix rpm;

  import ietf-yang-types {
    prefix "yang";
  }

  import ietf-resource-pm-types {
    prefix "rpm-types";
  }

  organization
    "IETF CCAMP Working Group";

  contact
    "WG Web:   <https://datatracker.ietf.org/wg/ccamp/>
     WG List:  <mailto:ccamp@ietf.org>

     Editor:   Chaode Yu
               <yuchaode@huawei.com>

     Editor:   Fabio Peruzzini
               <fabio.peruzzini@fibercop.com>

     Editor:   Yanlei Zheng
               <zhengyanlei@chinaunicom.cn>

     Editor:   Victor Lopez
               <victor.lopez@nokia.com>

     Editor:   Italo Busi
               <italo.busi@huawei.com>

     Editor:   Aihua Guo
               <aihuaguo.ietf@gmail.com>

     Editor:   Xing Zhao
               <zhaoxing@caict.ac.cn>

     Editor:   Mingshuang Jin
               <jinmingshuang@huawei.com>";

  description
    "This module defines a model for resource performance
    monitoring.

    The model fully conforms to the Network Management
    Datastore Architecture (NMDA).

    Copyright (c) 2025 IETF Trust and the persons
    identified as authors of the code.  All rights reserved.

    Redistribution and use in source and binary forms, with or
    without modification, is permitted pursuant to, and subject
    to the license terms contained in, the Revised BSD License
    set forth in Section 4.c of the IETF Trust's Legal Provisions
    Relating to IETF Documents
    (https://trustee.ietf.org/license-info).

    This version of this YANG module is part of RFC XXXX; see
    the RFC itself for full legal notices.

    The key words 'MUST', 'MUST NOT', 'REQUIRED', 'SHALL', 'SHALL
    NOT', 'SHOULD', 'SHOULD NOT', 'RECOMMENDED', 'NOT RECOMMENDED',
    'MAY', and 'OPTIONAL' in this document are to be interpreted as
    described in BCP 14 (RFC 2119) (RFC 8174) when, and only when,
    they appear in all capitals, as shown here.";

  revision 2025-07-04 {
    description  "Initial revision.";
  }

  container performance-monitoring {
    description
      "the root node.";

    uses resource-info-grouping;
    uses tca-management-grouping;
    uses monitoring-tasks-grouping;
  }

  grouping resource-info-grouping {
    description
      "grouping of resources' PM capabilities related information";

    container resources {
      description
        "resources' PM capabilities related information";

      list resource-list {
        description
          "list of resource instances";
        key resource;

        leaf resource {
          type union {
            type instance-identifier {
              require-instance false;
            }
            type yang:object-identifier;
            type string;
            type yang:uuid;
          }
        }

        leaf resource-type {
          type identityref {
            base rpm-types:resource-type;
        }
        config false;
          description
          "the type of resource, such as NE, board or port";
     }

      leaf holding-time {
         description
           "Contains the time period in hours within which 24h PM
            data records and 15min PM data records may be retrieved.
            If the domain controller does not store PM data it is the
            time supported in the NE";
        config false;
        type uint8;
        units "hour";
      }

     leaf-list indicator-name {
        type string;
        config false;
     }

     leaf-list sub-resources {
       description
          "the identifier of the performace monitoring point of this
          resource. If the resource is a NE, the sub-resource should
          be termination point. If the resource is a termination
          point contained in this NE, the sub-resource should be the
          logic channel on this TP";
      config false;
      type leafref {
        path "../rpm:resource";
      }
    }
  }
}

}

  grouping monitoring-tasks-grouping {
    description
      "grouping of performance monitoring task";

    container monitor-tasks {
      description
        "Information of PM tasks";

      list monitor-task {
        description
          "monitoring task list";

        key task-id;
        uses task-instance-grouping;
      }
    }
  }

  grouping task-instance-grouping {
    description
      "grouping of performance monitoring task. In this monitoring
      task, the client can specify a resource to run a monitor task
      and what kind of performance data need to be monitored.";

    leaf task-id {
      description
        "identifier of the performance task";
      type yang:uuid;
    }

    leaf resource {
      description
        "the identifier of network resource on which the performance
        monitoring task is running";

      type leafref {
        path "/rpm:performance-monitoring/rpm:resources" +
        "/rpm:resource-list/rpm:resource";
      }
    }

    leaf resource-type {
      description
        "the type of resource, such as NE, board or port";

      config false;
      type identityref {
        base rpm-types:resource-type;
      }
    }

    leaf task-name {
      description
        "the name of monitoring task";

      type string;
    }

    leaf admin-status {
      description
        "it is used to control enbling/disabling PM task";

      type enumeration {
        enum enabled {
          description
            "it is used to enable the pm task, if the task is enabled,
            the task-staus should be running";
        }

        enum disabled {
          description
            "it is used to disenable the pm task, if the task is
            disabled, the task-staus should be suspended";
        }
      }
    }

    leaf task-status {
      config false;
      description
        "the status of monitoring task.";

      type enumeration {
        enum running;

        enum suspended;

        enum abnormal;
      }
    }

    uses task-configuration-grouping;
  }

  grouping task-configuration-grouping {
    description
      "grouping of pm task configuration";

    container task-cfg {
      description
        "Configuration of the monitoring task";

      leaf period {
        description
          "it is used to indicate the interval as per monitoring
          task";
        type identityref {
          base rpm-types:period;
        }
      }

      container indicators {
        description
          "performance indicators";

        list indicator {
          description
            "list of PM indicators to be monitored";

          key indicator-name;
          uses indicator-grouping;
        }
      }
    }
  }

  grouping indicator-grouping {
    description
      "grouping of a monitoring indicator instance";

    leaf indicator-name {
      description
        "performance indicator's name";

      type string;
    }

    leaf indicator-value-unit {
      description
        "unit of indicator value";

      type string;
    }
  }

  grouping tca-management-grouping {
    description
      "grouping of configuration and management for Threshol Crossing
      Alert";

    container tca-management {
      description
        "configuration and management for Threshol Crossing Alert";

      container profiles {
        description
          "the TCA profile in the whole network";

        list profile {
          description
            "List of TCA profile instances";

          key "profile-id";
          uses tca-profile-grouping;
        }
      }

      container tcas {
        description
          "TCA configuration on the network resources.";

        list tca {
          description
            "List of TCA configuration instances";

          key "resource";

          leaf resource {
            description
              "the identifier of network resource on which threshold
              is configured for TCA purpose";

            type leafref {
              path "/rpm:performance-monitoring/rpm:resources" +
              "/rpm:resource-list/rpm:resource";
            }
          }

          leaf resource-type {
            description
              "the type of resource, such as NE, board or termination
              point";

            config false;

            type identityref {
              base rpm-types:resource-type;
            }
          }

          leaf admin-status {
            description
              "it is used to control the validity of threshold";
            type enumeration {
              enum enabled {
              description
                "if the admin-status of TCA configuration is enabled,
                the threshold is effective";
              }

              enum disabled {
                description
                  "if the admin-status of TCA configuration is
                  disabled, the threshold is not effective";
              }
            }
          }

          uses tca-grouping;
        }
      }
    }
  }

  grouping tca-profile-grouping {
    description
      "grouping of TCA profile instance";

    leaf profile-id {
      description
        "identifier of threshold crossing alerrt profile";

      type yang:uuid;
    }

    leaf profile-name {
      description
        "Name of the threshold crossing alerrt profile";

      type string;
    }

    container tca-cfg {
      description
        "detailed TCA configuration in a profile";

      list tca-indicator {
        description
          "list of TCA configuration.";

        key "indicator-name threshold-type period severity";
        uses tca-indicator-grouping;
      }
    }
  }

  grouping tca-indicator-grouping {
    description
      "grouping for detail TCA configuration";
    leaf indicator-name {
      type string;
      description
        "name of the indicator";
    }

    leaf indicator-value {
      mandatory true;
      type string;
      description
        "treshold value of the indicator";
    }

    leaf indicator-value-unit {
      mandatory true;
      type string;
      description
        "unit of indicator's value";
    }

    leaf threshold-type {
      description
        "it is used to indicate the trigger/clearing condition of
        alert upon the threshold";

      type enumeration {
        enum upperbound-trigger {
          description
            "If the performace data exceeds this threshold value,
            a TCA will be triggered";
        }
        enum lowerbound-trigger {
          description
            "if the performace data is lower than this threshold
            value, a TCA will be triggered";
        }
        enum upperbound-clear {
          description
            "If the performance data is not longer bigger than this
            threshold value, the TCA triggered before will be cleared
            by system automatically";
        }
        enum lowerbound-clear {
          description
            "If the performance data is not longer lower than this
            threshold value, the TCA triggered before will be cleared
            by system automatically";
        }
      }
    }

    leaf period {
      description
        "it is used to indicate the interval as per monitoring task";

      type identityref {
        base rpm-types:period;
      }
    }

    leaf severity {
      description
        "it is used to indicate what severity level of alert would be
        triggered if not confirms to the threashold";

      type identityref {
        base rpm-types:severity;
      }
    }
  }

  grouping tca-grouping {
    description
      "grouping of TCA configuration";

    container applied-profiles {
        description
          "Information of applied TCA profiles on this resource";

      list profile {
          description
            "list of applied TCA profile";

        key "profile-id";

        leaf profile-id {
          description
            "identifier of the applied TCA profile";

          type leafref {
            path "../../../../../rpm:profiles/rpm:profile" +
            "/rpm:profile-id";
          }
        }
      }
    }
    container tca-cfg {
      description
        "detailed configuration of TCA";
      list tca-indicator {
         description
           "list of tca indicator configuration";
        key "indicator-name threshold-type period severity";
        uses tca-indicator-grouping;
      }
    }
  }

  rpc get-pm-data {
    input {

      leaf-list resources {
        description
          "the identifier of resources from which performace
          data is collected";

        type leafref {
          path "/rpm:performance-monitoring/rpm:resources" +
          "/rpm:resource-list/rpm:resource";
        }
      }

      leaf is-requesting-history-data {
        description
        "true indicate this is a request for historic data, then start-time and end-time should be assigned";
        type boolean;
      }
      leaf start-time {
        description
        "the starttime of performance data needed to be retrieved";

        type yang:date-and-time;
      }

      leaf end-time {
        description
        "the endtime of performance data needed to be retrieved";

        type yang:date-and-time;
      }
    }
    output {
      container pm-data {
        description
          "result of historic performance data";

        list pm-data-list {
          description
            "list of historic performance data";

          key resource;
          uses pm-data-instance-grouping;
        }
      }
    }
  }

  rpc clear-performance-monitoring-data {
        description
        "This operation clears (reset) the PM registers for a list of
        Measurement Points. Within the request for each Measurement
        Point, it is possible to specify the granularity (15min, 24hr,
        NA) and location (nearEnd and/or farEnd and/or bidirectional)
        for the PM registers that are to be reset.";
    input {

      leaf-list resources {
        description
          "the identifier of measurement points to clear PM data";

        type leafref {
          path "/rpm:performance-monitoring/rpm:resources" +
          "/rpm:resource-list/rpm:resource";
        }
      }
    }
    output {
      leaf-list failed-resources {
        description
          "the identifier of measurement points which are failed to
          clear PM data. An empty list indicates that the total
          request was successful.";

        type leafref {
          path "/rpm:performance-monitoring/rpm:resources" +
          "/rpm:resource-list/rpm:resource";
        }
      }
    }
  }

  rpc get-profile-associated-resources {
    input {

      leaf profile-id {
        description
          "the identifier of profile which the client want to
          retrieve";

        type leafref {
          path "/rpm:performance-monitoring/rpm:tca-management"
          + "/rpm:profiles/rpm:profile/rpm:profile-id";
        }
      }

    }
    output {
      leaf-list resource-list {
        description
          "Provides the set of Resources associated with the profile
          provided.";

        type leafref {
          path "/rpm:performance-monitoring/rpm:resources" +
          "/rpm:resource-list/rpm:resource";
        }
      }
    }
  }

  grouping pm-data-instance-grouping {
    description
      "grouping for common attributes of performance data";

    leaf resource {
    description
      "the identifier of network resource which is monitored.";

      type leafref {
        path "/rpm:performance-monitoring/rpm:resources" +
        "/rpm:resource-list/rpm:resource";
      }
    }

    leaf-list task-id {
       description
        "the task id list of the tasks from which the pm data is retrieved";

        type yang:uuid;
    }
    leaf collect-time {
      description
        "the time of this data is collected";

      type yang:date-and-time;
    }

    leaf resource-type {
      description
        "the type of resource, such as NE, board or port";

      type identityref {
        base rpm-types:resource-type;
      }
    }

    container indicator-data {
      description
        "grouping for historic performance data";

      list indicator-data-list {
        description
          "list of historic performance data";
        key indicator-name;

        uses indicator-data-instance-grouping;
      }
    }
  }

  grouping indicator-data-instance-grouping {
    description
      "grouping for a performance data";

    leaf indicator-name {
      description
        "name of performance data indicator";

      type string;
    }

    leaf indicator-value {
      description
        "value of performance data";

      type string;
    }

    leaf indicator-value-unit {
      description
        "unit of performance data value";

      type string;
    }
  }
}
]]></sourcecode>
      </figure>
    </section>
    <section anchor="yang-model-for-resource-performance-monitoring-types">
      <name>YANG Model for Resource Performance Monitoring Types</name>
      <figure anchor="fig-rpm-type-yang">
        <name>Resource Performance Monitoring Types YANG module</name>
        <sourcecode type="yang" markers="true" name="ietf-resource-pm-types@2025-07-04.yang"><![CDATA[
module ietf-resource-pm-types {
  yang-version 1.1;
  namespace
  "urn:ietf:params:xml:ns:yang:ietf-resource-pm-types";

  prefix rpm-types;

  organization
    "IETF CCAMP Working Group";
  contact
    "WG Web:   <https://datatracker.ietf.org/wg/ccamp/>
     WG List:  <mailto:ccamp@ietf.org>

     Editor:   Chaode Yu
               <yuchaode@huawei.com>

     Editor:   Fabio Peruzzini
               <fabio.peruzzini@fibercop.com>

     Editor:   Yanlei Zheng
               <zhengyanlei@chinaunicom.cn>

     Editor:   Victor Lopez
               <victor.lopez@nokia.com>

     Editor:   Italo Busi
               <italo.busi@huawei.com>

     Editor:   Aihua Guo
               <aihuaguo.ietf@gmail.com>

     Editor:   Xing Zhao
               <zhaoxing@caict.ac.cn>

     Editor:   Mingshuang Jin
               <jinmingshuang@huawei.com>";

  description
    "This module defines types model for resource performance
    monitoring which will be imported by ietf-resource-pm
    data model.

    The model fully conforms to the Network Management
    Datastore Architecture (NMDA).

    Copyright (c) 2025 IETF Trust and the persons
    identified as authors of the code.  All rights reserved.

    Redistribution and use in source and binary forms, with or
    without modification, is permitted pursuant to, and subject
    to the license terms contained in, the Revised BSD License
    set forth in Section 4.c of the IETF Trust's Legal Provisions
    Relating to IETF Documents
    (https://trustee.ietf.org/license-info).

    This version of this YANG module is part of RFC XXXX; see
    the RFC itself for full legal notices.

    The key words 'MUST', 'MUST NOT', 'REQUIRED', 'SHALL', 'SHALL
    NOT', 'SHOULD', 'SHOULD NOT', 'RECOMMENDED', 'NOT RECOMMENDED',
    'MAY', and 'OPTIONAL' in this document are to be interpreted as
    described in BCP 14 (RFC 2119) (RFC 8174) when, and only when,
    they appear in all capitals, as shown here.";

  revision 2025-07-04 {
    description  "Initial revision.";

  }

  identity resource-type {
    description "this is the base type of all the rerource type";
  }

  identity network-element {
    base resource-type;
    description "NE resource type";
  }

   identity interface {
      base resource-type;
      description "Network interface";
   }

  identity board {
    base resource-type;
    description "board resource type";
  }

  identity termination-point {
    base resource-type;
    description "Termination point resource";
  }

  identity tunnel-termination-point {
    base resource-type;
    description "Tunnel termination point resource";
  }

  identity period {
    description
      "this is the base type of all the performace monitoring priod
      type.";
  }

  identity period-15-minutes {
    base period;
    description
      "the during of monitoring task will be repeated at every 15
      minutes";
  }

  identity period-24-hours {
    base period;
    description
       "the during of monitoring task will be repeated at every 24
       hours";
  }

  identity severity {
    description
        "it is used to indicate what severity alarm will be caused if
        exceeds the threshold";
  }

  identity critical {
    description
        "critical alarm will be caused if exceeds the threshold";
    base severity;
  }

  identity major {
    description
        "major alarm will be caused if exceeds the threshold";
    base severity;
  }

  identity minor {
    description
        "minor alarm will be caused if exceeds the threshold";
    base severity;
  }

  identity warning {
    description
        "only a warning will be caused if exceeds the threshold";
    base severity;
  }

  identity layer-rate-type {
    description
        "It is used to indicate the layer rate of network element when
        retrieving the pm parameters supported";
  }
}

]]></sourcecode>
      </figure>
    </section>
    <section anchor="manageability-considerations">
      <name>Manageability Considerations</name>
      <t>&lt;Add any manageability considerations&gt;</t>
    </section>
    <section anchor="security-considerations">
      <name>Security Considerations</name>
      <t>The YANG module specified in this document defines a schema for data that is designed to be accessed via network management protocols such as NETCONF <xref target="RFC6241"/> or RESTCONF <xref target="RFC8040"/>. The lowest NETCONF layer is the secure transport layer, and the mandatory-to-implement secure transport is Secure Shell (SSH) <xref target="RFC6242"/>. The lowest RESTCONF layer is HTTPS, and the mandatory-to-implement secure transport is TLS <xref target="RFC8446"/>.</t>
      <t>The NETCONF access control model <xref target="RFC8341"/> provides the means to restrict access for particular NETCONF or RESTCONF users to a preconfigured subset of all available NETCONF or RESTCONF protocol operations and content.</t>
      <t>There are a number of data nodes defined in this YANG module that are writable/creatable/deletable (i.e., config true, which is the default). These data nodes may be considered sensitive or vulnerable in some network environments. Write operations (e.g., edit-config) to these data nodes without proper protection can have a negative effect on network operations. Considerations in Section 8 of <xref target="RFC8795"/>are also applicable to their subtrees in the module defined in this document.</t>
      <t>Some of the readable data nodes in this YANG module may be considered sensitive or vulnerable in some network environments. It is thus important to control read access (e.g., via get, get-config, or notification) to these data nodes. Considerations in Section 8 of <xref target="RFC8795"/> are also applicable to their subtrees in the module defined in this document.</t>
    </section>
    <section anchor="iana-considerations">
      <name>IANA Considerations</name>
      <t>This document registers following YANG modules in the YANG Module Names registry <xref target="RFC6020"/>.</t>
      <t>name:         ietf-resource-pm
   namespace:    urn:ietf:params:xml:ns:yang:ietf-resource-pm
   prefix:       dvcrpm
   reference:    RFC XXXX: A YANG Data Model for Resource Performance Monitoring</t>
      <t>name:         ietf-resource-pm-types
   namespace:    urn:ietf:params:xml:ns:yang:ietf-resource-pm-types
   prefix:       dvcrpm-types
   reference:    RFC XXXX: A YANG Data Model for Resource Performance Monitoring</t>
    </section>
  </middle>
  <back>
    <references anchor="sec-combined-references">
      <name>References</name>
      <references anchor="sec-normative-references">
        <name>Normative References</name>
        <reference anchor="TMF-518" target="https://www.tmforum.org/resources/collection/mtosi-4-0">
          <front>
            <title>Resource Performance Management</title>
            <author>
              <organization>TM Forum (TMF)</organization>
            </author>
            <date year="2011"/>
          </front>
          <seriesInfo name="TMF518_RPM" value=""/>
        </reference>
        <reference anchor="ITU-T_G.874" target="https://www.itu.int/rec/T-REC-G.874/en">
          <front>
            <title>Management aspects of optical transport network elements</title>
            <author>
              <organization>International Telecommunication Union</organization>
            </author>
            <date year="2020" month="October"/>
          </front>
          <seriesInfo name="ITU-T Recommendation G.874" value=""/>
        </reference>
        <reference anchor="RFC9375">
          <front>
            <title>A YANG Data Model for Network and VPN Service Performance Monitoring</title>
            <author fullname="B. Wu" initials="B." role="editor" surname="Wu"/>
            <author fullname="Q. Wu" initials="Q." role="editor" surname="Wu"/>
            <author fullname="M. Boucadair" initials="M." role="editor" surname="Boucadair"/>
            <author fullname="O. Gonzalez de Dios" initials="O." surname="Gonzalez de Dios"/>
            <author fullname="B. Wen" initials="B." surname="Wen"/>
            <date month="April" year="2023"/>
            <abstract>
              <t>The data model for network topologies defined in RFC 8345 introduces vertical layering relationships between networks that can be augmented to cover network and service topologies. This document defines a YANG module for performance monitoring (PM) of both underlay networks and overlay VPN services that can be used to monitor and manage network performance on the topology of both layers.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="9375"/>
          <seriesInfo name="DOI" value="10.17487/RFC9375"/>
        </reference>
        <reference anchor="RFC8194">
          <front>
            <title>A YANG Data Model for LMAP Measurement Agents</title>
            <author fullname="J. Schoenwaelder" initials="J." surname="Schoenwaelder"/>
            <author fullname="V. Bajpai" initials="V." surname="Bajpai"/>
            <date month="August" year="2017"/>
            <abstract>
              <t>This document defines a data model for Large-Scale Measurement Platforms (LMAPs). The data model is defined using the YANG data modeling language.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8194"/>
          <seriesInfo name="DOI" value="10.17487/RFC8194"/>
        </reference>
        <reference anchor="RFC8342">
          <front>
            <title>Network Management Datastore Architecture (NMDA)</title>
            <author fullname="M. Bjorklund" initials="M." surname="Bjorklund"/>
            <author fullname="J. Schoenwaelder" initials="J." surname="Schoenwaelder"/>
            <author fullname="P. Shafer" initials="P." surname="Shafer"/>
            <author fullname="K. Watsen" initials="K." surname="Watsen"/>
            <author fullname="R. Wilton" initials="R." surname="Wilton"/>
            <date month="March" year="2018"/>
            <abstract>
              <t>Datastores are a fundamental concept binding the data models written in the YANG data modeling language to network management protocols such as the Network Configuration Protocol (NETCONF) and RESTCONF. This document defines an architectural framework for datastores based on the experience gained with the initial simpler model, addressing requirements that were not well supported in the initial model. This document updates RFC 7950.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8342"/>
          <seriesInfo name="DOI" value="10.17487/RFC8342"/>
        </reference>
        <reference anchor="RFC7446">
          <front>
            <title>Routing and Wavelength Assignment Information Model for Wavelength Switched Optical Networks</title>
            <author fullname="Y. Lee" initials="Y." role="editor" surname="Lee"/>
            <author fullname="G. Bernstein" initials="G." role="editor" surname="Bernstein"/>
            <author fullname="D. Li" initials="D." surname="Li"/>
            <author fullname="W. Imajuku" initials="W." surname="Imajuku"/>
            <date month="February" year="2015"/>
            <abstract>
              <t>This document provides a model of information needed by the Routing and Wavelength Assignment (RWA) process in Wavelength Switched Optical Networks (WSONs). The purpose of the information described in this model is to facilitate constrained optical path computation in WSONs. This model takes into account compatibility constraints between WSON signal attributes and network elements but does not include constraints due to optical impairments. Aspects of this information that may be of use to other technologies utilizing a GMPLS control plane are discussed.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="7446"/>
          <seriesInfo name="DOI" value="10.17487/RFC7446"/>
        </reference>
        <reference anchor="RFC7581">
          <front>
            <title>Routing and Wavelength Assignment Information Encoding for Wavelength Switched Optical Networks</title>
            <author fullname="G. Bernstein" initials="G." role="editor" surname="Bernstein"/>
            <author fullname="Y. Lee" initials="Y." role="editor" surname="Lee"/>
            <author fullname="D. Li" initials="D." surname="Li"/>
            <author fullname="W. Imajuku" initials="W." surname="Imajuku"/>
            <author fullname="J. Han" initials="J." surname="Han"/>
            <date month="June" year="2015"/>
            <abstract>
              <t>A Wavelength Switched Optical Network (WSON) requires certain key information fields be made available to facilitate path computation and the establishment of Label Switched Paths (LSPs). The information model described in "Routing and Wavelength Assignment Information Model for Wavelength Switched Optical Networks" (RFC 7446) shows what information is required at specific points in the WSON. Part of the WSON information model contains aspects that may be of general applicability to other technologies, while other parts are specific to WSONs.</t>
              <t>This document provides efficient, protocol-agnostic encodings for the WSON-specific information fields. It is intended that protocol- specific documents will reference this memo to describe how information is carried for specific uses. Such encodings can be used to extend GMPLS signaling and routing protocols. In addition, these encodings could be used by other mechanisms to convey this same information to a Path Computation Element (PCE).</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="7581"/>
          <seriesInfo name="DOI" value="10.17487/RFC7581"/>
        </reference>
        <reference anchor="RFC7950">
          <front>
            <title>The YANG 1.1 Data Modeling Language</title>
            <author fullname="M. Bjorklund" initials="M." role="editor" surname="Bjorklund"/>
            <date month="August" year="2016"/>
            <abstract>
              <t>YANG is a data modeling language used to model configuration data, state data, Remote Procedure Calls, and notifications for network management protocols. This document describes the syntax and semantics of version 1.1 of the YANG language. YANG version 1.1 is a maintenance release of the YANG language, addressing ambiguities and defects in the original specification. There are a small number of backward incompatibilities from YANG version 1. This document also specifies the YANG mappings to the Network Configuration Protocol (NETCONF).</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="7950"/>
          <seriesInfo name="DOI" value="10.17487/RFC7950"/>
        </reference>
        <reference anchor="RFC6241">
          <front>
            <title>Network Configuration Protocol (NETCONF)</title>
            <author fullname="R. Enns" initials="R." role="editor" surname="Enns"/>
            <author fullname="M. Bjorklund" initials="M." role="editor" surname="Bjorklund"/>
            <author fullname="J. Schoenwaelder" initials="J." role="editor" surname="Schoenwaelder"/>
            <author fullname="A. Bierman" initials="A." role="editor" surname="Bierman"/>
            <date month="June" year="2011"/>
            <abstract>
              <t>The Network Configuration Protocol (NETCONF) defined in this document provides mechanisms to install, manipulate, and delete the configuration of network devices. It uses an Extensible Markup Language (XML)-based data encoding for the configuration data as well as the protocol messages. The NETCONF protocol operations are realized as remote procedure calls (RPCs). This document obsoletes RFC 4741. [STANDARDS-TRACK]</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="6241"/>
          <seriesInfo name="DOI" value="10.17487/RFC6241"/>
        </reference>
        <reference anchor="RFC8340">
          <front>
            <title>YANG Tree Diagrams</title>
            <author fullname="M. Bjorklund" initials="M." surname="Bjorklund"/>
            <author fullname="L. Berger" initials="L." role="editor" surname="Berger"/>
            <date month="March" year="2018"/>
            <abstract>
              <t>This document captures the current syntax used in YANG module tree diagrams. The purpose of this document is to provide a single location for this definition. This syntax may be updated from time to time based on the evolution of the YANG language.</t>
            </abstract>
          </front>
          <seriesInfo name="BCP" value="215"/>
          <seriesInfo name="RFC" value="8340"/>
          <seriesInfo name="DOI" value="10.17487/RFC8340"/>
        </reference>
        <reference anchor="RFC6991">
          <front>
            <title>Common YANG Data Types</title>
            <author fullname="J. Schoenwaelder" initials="J." role="editor" surname="Schoenwaelder"/>
            <date month="July" year="2013"/>
            <abstract>
              <t>This document introduces a collection of common data types to be used with the YANG data modeling language. This document obsoletes RFC 6021.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="6991"/>
          <seriesInfo name="DOI" value="10.17487/RFC6991"/>
        </reference>
        <reference anchor="RFC8040">
          <front>
            <title>RESTCONF Protocol</title>
            <author fullname="A. Bierman" initials="A." surname="Bierman"/>
            <author fullname="M. Bjorklund" initials="M." surname="Bjorklund"/>
            <author fullname="K. Watsen" initials="K." surname="Watsen"/>
            <date month="January" year="2017"/>
            <abstract>
              <t>This document describes an HTTP-based protocol that provides a programmatic interface for accessing data defined in YANG, using the datastore concepts defined in the Network Configuration Protocol (NETCONF).</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8040"/>
          <seriesInfo name="DOI" value="10.17487/RFC8040"/>
        </reference>
        <reference anchor="RFC6242">
          <front>
            <title>Using the NETCONF Protocol over Secure Shell (SSH)</title>
            <author fullname="M. Wasserman" initials="M." surname="Wasserman"/>
            <date month="June" year="2011"/>
            <abstract>
              <t>This document describes a method for invoking and running the Network Configuration Protocol (NETCONF) within a Secure Shell (SSH) session as an SSH subsystem. This document obsoletes RFC 4742. [STANDARDS-TRACK]</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="6242"/>
          <seriesInfo name="DOI" value="10.17487/RFC6242"/>
        </reference>
        <reference anchor="RFC8446">
          <front>
            <title>The Transport Layer Security (TLS) Protocol Version 1.3</title>
            <author fullname="E. Rescorla" initials="E." surname="Rescorla"/>
            <date month="August" year="2018"/>
            <abstract>
              <t>This document specifies version 1.3 of the Transport Layer Security (TLS) protocol. TLS allows client/server applications to communicate over the Internet in a way that is designed to prevent eavesdropping, tampering, and message forgery.</t>
              <t>This document updates RFCs 5705 and 6066, and obsoletes RFCs 5077, 5246, and 6961. This document also specifies new requirements for TLS 1.2 implementations.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8446"/>
          <seriesInfo name="DOI" value="10.17487/RFC8446"/>
        </reference>
        <reference anchor="RFC8341">
          <front>
            <title>Network Configuration Access Control Model</title>
            <author fullname="A. Bierman" initials="A." surname="Bierman"/>
            <author fullname="M. Bjorklund" initials="M." surname="Bjorklund"/>
            <date month="March" year="2018"/>
            <abstract>
              <t>The standardization of network configuration interfaces for use with the Network Configuration Protocol (NETCONF) or the RESTCONF protocol requires a structured and secure operating environment that promotes human usability and multi-vendor interoperability. There is a need for standard mechanisms to restrict NETCONF or RESTCONF protocol access for particular users to a preconfigured subset of all available NETCONF or RESTCONF protocol operations and content. This document defines such an access control model.</t>
              <t>This document obsoletes RFC 6536.</t>
            </abstract>
          </front>
          <seriesInfo name="STD" value="91"/>
          <seriesInfo name="RFC" value="8341"/>
          <seriesInfo name="DOI" value="10.17487/RFC8341"/>
        </reference>
        <reference anchor="RFC8795">
          <front>
            <title>YANG Data Model for Traffic Engineering (TE) Topologies</title>
            <author fullname="X. Liu" initials="X." surname="Liu"/>
            <author fullname="I. Bryskin" initials="I." surname="Bryskin"/>
            <author fullname="V. Beeram" initials="V." surname="Beeram"/>
            <author fullname="T. Saad" initials="T." surname="Saad"/>
            <author fullname="H. Shah" initials="H." surname="Shah"/>
            <author fullname="O. Gonzalez de Dios" initials="O." surname="Gonzalez de Dios"/>
            <date month="August" year="2020"/>
            <abstract>
              <t>This document defines a YANG data model for representing, retrieving, and manipulating Traffic Engineering (TE) Topologies. The model serves as a base model that other technology-specific TE topology models can augment.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8795"/>
          <seriesInfo name="DOI" value="10.17487/RFC8795"/>
        </reference>
        <reference anchor="RFC6020">
          <front>
            <title>YANG - A Data Modeling Language for the Network Configuration Protocol (NETCONF)</title>
            <author fullname="M. Bjorklund" initials="M." role="editor" surname="Bjorklund"/>
            <date month="October" year="2010"/>
            <abstract>
              <t>YANG is a data modeling language used to model configuration and state data manipulated by the Network Configuration Protocol (NETCONF), NETCONF remote procedure calls, and NETCONF notifications. [STANDARDS-TRACK]</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="6020"/>
          <seriesInfo name="DOI" value="10.17487/RFC6020"/>
        </reference>
      </references>
      <references anchor="sec-informative-references">
        <name>Informative References</name>
        <reference anchor="I-D.ietf-teas-actn-pm-telemetry-autonomics">
          <front>
            <title>YANG models for Virtual Network (VN)/TE Performance Monitoring Telemetry and Scaling Intent Autonomics</title>
            <author fullname="Young Lee" initials="Y." surname="Lee">
              <organization>Samsung Electronics</organization>
            </author>
            <author fullname="Dhruv Dhody" initials="D." surname="Dhody">
              <organization>Huawei</organization>
            </author>
            <author fullname="Ricard Vilalta" initials="R." surname="Vilalta">
              <organization>CTTC</organization>
            </author>
            <author fullname="Daniel King" initials="D." surname="King">
              <organization>Lancaster University</organization>
            </author>
            <author fullname="Daniele Ceccarelli" initials="D." surname="Ceccarelli">
              <organization>Cisco</organization>
            </author>
            <date day="13" month="October" year="2025"/>
            <abstract>
              <t>   This document provides YANG data models that describe the performance
   monitoring parameters and scaling intent mechanisms for TE-tunnels
   and Virtual Networks (VNs).  Their performance monitoring parameters
   are exposed as the key telemetry data for tunnels and VN.

   The models presented in this document allow customers to subscribe to
   and monitor the key performance data of the TE-tunnel or the VN.  The
   models also provide customers with the ability to program autonomic
   scaling intent mechanisms on the level of TE-tunnel as well as VN.

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-ietf-teas-actn-pm-telemetry-autonomics-16"/>
        </reference>
        <reference anchor="I-D.zheng-ccamp-client-pm-yang">
          <front>
            <title>A YANG Data Model for Client Signal Performance Monitoring</title>
            <author fullname="Chaode Yu" initials="C." surname="Yu">
              <organization>Huawei Technologies</organization>
            </author>
            <author fullname="Haomian Zheng" initials="H." surname="Zheng">
              <organization>Huawei Technologies</organization>
            </author>
            <author fullname="Italo Busi" initials="I." surname="Busi">
              <organization>Huawei Technologies</organization>
            </author>
            <author fullname="Zheng Yanlei" initials="Z." surname="Yanlei">
              <organization>China Unicom</organization>
            </author>
            <author fullname="Victor Lopez" initials="V." surname="Lopez">
              <organization>Nokia</organization>
            </author>
            <author fullname="Oscar Gonzalez de Dios" initials="O. G." surname="de Dios">
              <organization>Telefonica</organization>
            </author>
            <date day="29" month="August" year="2025"/>
            <abstract>
              <t>   A transport network is a server-layer network to provide connectivity
   services to its client.  Given the client signal is configured, the
   followup function for performance monitoring, such as latency and bit
   error rate, would be needed for network operation.

   This document describes the data model to support the performance
   monitoring functionalities.

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-zheng-ccamp-client-pm-yang-13"/>
        </reference>
        <reference anchor="I-D.ietf-opsawg-yang-vpn-service-pm">
          <front>
            <title>A YANG Data Model for Network and VPN Service Performance Monitoring</title>
            <author fullname="Bo Wu" initials="B." surname="Wu">
              <organization>Huawei</organization>
            </author>
            <author fullname="Qin Wu" initials="Q." surname="Wu">
              <organization>Huawei</organization>
            </author>
            <author fullname="Mohamed Boucadair" initials="M." surname="Boucadair">
              <organization>Orange</organization>
            </author>
            <author fullname="Oscar Gonzalez de Dios" initials="O. G." surname="de Dios">
              <organization>Telefonica</organization>
            </author>
            <author fullname="Bin Wen" initials="B." surname="Wen">
              <organization>Comcast</organization>
            </author>
            <date day="11" month="November" year="2022"/>
            <abstract>
              <t>The data model for network topologies defined in RFC 8345 introduces vertical layering relationships between networks that can be augmented to cover network and service topologies.  This document defines a YANG module for performance monitoring (PM) of both underlay networks and overlay VPN services that can be used to monitor and manage network performance on the topology of both layers.
              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-ietf-opsawg-yang-vpn-service-pm-15"/>
        </reference>
        <reference anchor="RFC8454">
          <front>
            <title>Information Model for Abstraction and Control of TE Networks (ACTN)</title>
            <author fullname="Y. Lee" initials="Y." surname="Lee"/>
            <author fullname="S. Belotti" initials="S." surname="Belotti"/>
            <author fullname="D. Dhody" initials="D." surname="Dhody"/>
            <author fullname="D. Ceccarelli" initials="D." surname="Ceccarelli"/>
            <author fullname="B. Yoon" initials="B." surname="Yoon"/>
            <date month="September" year="2018"/>
            <abstract>
              <t>This document provides an information model for Abstraction and Control of TE Networks (ACTN).</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8454"/>
          <seriesInfo name="DOI" value="10.17487/RFC8454"/>
        </reference>
        <reference anchor="RFC8641">
          <front>
            <title>Subscription to YANG Notifications for Datastore Updates</title>
            <author fullname="A. Clemm" initials="A." surname="Clemm"/>
            <author fullname="E. Voit" initials="E." surname="Voit"/>
            <date month="September" year="2019"/>
            <abstract>
              <t>This document describes a mechanism that allows subscriber applications to request a continuous and customized stream of updates from a YANG datastore. Providing such visibility into updates enables new capabilities based on the remote mirroring and monitoring of configuration and operational state.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8641"/>
          <seriesInfo name="DOI" value="10.17487/RFC8641"/>
        </reference>
      </references>
    </references>
    <?line 1330?>

<section numbered="false" anchor="acknowledgments">
      <name>Acknowledgments</name>
      <t>This document was prepared using kramdown.</t>
    </section>
  </back>
  <!-- ##markdown-source:
H4sIAAAAAAAAA+09a3PcNpLfVeX/gBt/sJQdjixHzkPePBRZTnRlKTpL2Vzu
duuKw8HMcMUh5/iQMrF1v/36AYAAQXJmJOdury7arVgigUaj0Q30C80gCJ7s
lHGZyCMxOBa/HF98L16HZSjOs4lMxDTLxTtZZFUeSXEpc/h7Eabw+3mWxmWW
x+ls8GQnHI9zeQsA6qbnBAreRWEpZ1m+OhJFOXmy82RnkkVpuIDhJnk4LYNV
FURRuFgGueobLBfBKkxnwfPDJztFNV7ERRFnablaQp+z0+s3QjwVYVJkMF6c
TuRSwn/ScjAUAzkhnMIE/zg7/g7+AfwHZ++u3wAmabUYy/wIMACU4J8oSwuZ
FlVxJMq8kk92YAafwmRyGeJUsqrk2d1l+c0sz6olPD3JFossFSeAT54lIkwn
4lyGRZXLBeAgLpMwldDlRq6g1wQGEYFI5a+lmMlU5mEJE6FnVRpHWc6/F8sw
v0lgLDGJizKPx1UpJyKRk5nMASmZVoitEFviIASTbPAz4I/Qv8f+9GIRxgm8
ILp/G8tyOsryGb0J82gOb+ZluSyO9vexIT6Kb+VIt9vHB/vjPLsr5D6B2Keu
s7icV2Po/Et1Mg+Be/bXLDD1SmAtitIaUvceMbxRnK2Ds+79aF4ukgGyXliV
8ywnYgb4HyGmVZIwN/Ko4peKX8BEwzT+jVbsSPxQhXcyFtcymqdZks1iWXAz
yaRcVRF1/3ZODUdRtrAG4QHehOM4QxmqfvstTmMzDLyJgS9PsqUDcorNR0vd
/NspNoqyZSvsX8I0Afz+bS7TmQX4ZB6nofgJeW3hAP8NG66o07cRNiJ+XIyi
1AN9VoZJJr6rChvjdfSIsdNoDJ36KHIcw0vxfZXZtKhKYORe4CF2m1UZceS3
M3zYCv4vcQS7gXibLeVv1ggX2U0cOgBvqeEowYbfpvi6Fd6/ohD9G6yzTeHj
s5PrBmnD7Fdo+W0UAthRGLUR9RwaFDALAPjPcboFYf8epwvT16Et7G+4N5cg
qsTg1+dvgpcHXxxxd7XDt2/lYRrOaO/gtpaUGLyuz8WbLK8WYhfg7vEr2kaF
ePH84IAfFDIHfON0mmGHNzD6f7y7PFcIhPlMgpxrMb+7uxuViynCpE1FC22x
H2VJIiOUu/1FmRVxcBg8Rxhn1z8F1//x/eiLzw/dSdX4i7BYQtdCZFORLcs4
ChPY2sO0WGZ5CftwiVu5kAk1Lrpne5aWMk9J9gHCNXQAEi9QRugZSlSWOkT4
ETgI5BOI8eK5TwxCHYiPUOC0YiA0k27ixGU1itMSCBPtXwfvTk8C6rAvU1zr
IAhEOIbTIoxK/Pt6HhcCTtaKyDCR0ziVhQj5PJ/geb4w53nef54PRbhcJjDV
cSJFmRmyRXzeJDIvhkLczeNoLpZ5dhtPYKRyLmEvTSMmWVzC1HERcgnnmbwF
IsIfS2u4hRlOROEStjruMxTXJ8fAY3PAcZ4lE3GSZ3D6Q6tjGLfcQySm8azi
k3QooirPccIwKyAAAFw5o9DEDQ5DOio7sCjD4gbORc1JI03kRTyZJBL/eops
kWeTKuJT/MmOkaYOmDGuwDgs4sjQBumgCWqNJr5bwS4k77AXIglvktVvhNdc
+lMCIJN4OpU0dyM5YreAYwhkoMnpQxEjQ0/DSA7FOAvzyVDA37CRMCcusxgb
lVWaAot4b/ZAllB3yfICFisF7ipByAizHLoglkUJYoBo4UM9epyChC5gyP+s
4ugmWRGmyS30kmES4CvkH+CyRYELGKMWF09XQJe/I5fGxU2BMMLJLc58ImD9
brN4guNVIF3FM+CGxTIJAcWC1us4Ap2K3gPbIiZ4AIEcFDAi4MD6UcHIThD0
+/dql7y/H9Zi0bGaDow4jZJqgjstsAlItsXmmidxHZkpaR9yoNbqWkEiqUlm
1hKhvtbaoOKbLqmAhQepKfb0rNUGissFvUATR55BgFpj7JZFXLJ6BY+ETHEX
2Ae9lHYDBldv0DRHlFhbu8X/nTANktUQ4eUS9EopigxWXP4KsyJdV21WuDgJ
LQig340WKv7AvFWpAIJspZnIbmWehEtxB7qiAMoZ4iP6I6CYZOhwKGp4MFA2
/judEoRUtViEefwbM8Q1TfOAuOkDb55gB1Xw7IO9WwbnBtaPBEt8eCdJHAHv
D9g1oB+hf+n5ER+sX6ErKjVBKeH/KLxlDiSkR7dp/eiDuD5V4jqEfSMvK2Aw
tWgfgKu/OQtejxSgsAjgjEhRGTb9Azj0sjRbxFFxf1+PqiAEt0ts/kH85fIC
jzFQj/AgWKI+shII/5/evTn58tPPX9qdVUPseO0duerlB4UaqZ9KW4+SGBZM
6+r39wZgsgjhLbOsogE9yiWC/rAIQQRuHVkSsJ2ycAowT8LJGNmzHhqx/uLg
y0MaA/+3LaHMaeefq+U8xGO3iEBgoUEHHxM+sBkwT5eI8gI0PTA0igVvBNen
wTWta0GN/6LW9oLpWOz+5aLYGzkrnC2L8G7GFjMuXL0OgHG/ItCBJUj5OAN5
0otnlj4JV6DiIF4sd6t2DqFmBsm+tbYp2oFME2/YdBiKKOIZameJvJXJSNjL
a027MeO3qGgFV7AEsmkzlzh6sfv2/PhybwiNo4p2WBiPdQOjpqyIAo4igiTr
5sfRWgVtwXuMo5y102OoFC8NgPZ7S4FipWsNCOxURmFjDoq+U0AKteh4CmqL
BjUC3QcO4knMahcCKKpxoPDG2Tc0KVJixFTeiXeXJ7zTMsq0zRfVkrYHhMO6
BYAtus+lodCajavR6ZUgvVRrSw1UNPmlx0oaITr07NVBuiAz6ANVSZ9taKCL
DI92KY7RPYIKESy62L04f328Z0NWfPnp4Yv7e8Lk6VMwKFDDYmHBGVxkJVMA
VUo4RnBc7vf54eFnwM/YSD14+cUBPEBOQcxu5Ir0tQI1In8mI0FH4BSok5Fu
yW3t1TAofv7ly+dqKHyfZqhZ6lZ45IKu84lQwke/ouCjh+oTNKJmC/24pnD9
Zwp/6mXYCJvPXhwebIKNw8Gs5yBmpI7ynxsO+g2u0uHLww0GPTk/o3/PL9W/
r69O+MUF/3uJ/z7Z+VpcZ+I74JDJRE6OtPoDCmtqNg2b3eN0gvZllmsuyaUE
HTCc5SGY98ew34GyC1IJuMCj5Zy0SjgMQUaB9AYksoXF5HHNGldKafuUm/l8
AltXqg4AkvDVYpwlhVIKCwDLyHQsGfD4c8XjhP9lDi1+xffkT75A79pFuEDd
9qzBp0Nyi9AGYNiFD8AMtT1n/7d0tyWNADjwVk04l9ALDBz1DraMIotiUi9J
R2T9GHRE0E/SiTlggLSwH0Ej3tHADoW9BnTtu1SrxBYDoY6oNEQ1xw/ogJtp
VbH954N4hIoorN+xb75cwEM6/y1vpzPYmxPxr/AjqEOOSs1qKQu/Ez9v6yTw
kKbn1Ic0DNO4OTsltl9+eUDq1fsj8RQIFaglKthX89XgUv/NO7e3EIr+g3uy
rwGdU3Lp4xaJ0neZwOmKOj1IEdCRcDXris3Zx4/LDtoBHzYup7Ml/4Awh+Lq
k8Zhu7bXU+h0xecd4PPOGOtIgBOHAGBa2dBR5smugnN4YAzDAbB4XvFpg/Oq
D1WtffKpqsSE9NIoq8BoHFsmENmtn9RgB0eCuikbPAYSkiLQtJmcTsQM0FNt
XBJUExhM/gpatLiJUXgtXSQuqC+aryREYP1DVxwzydKZLErBDgGYbjZhtD23
hz8Pgmk2TtpFFFTzsJMG5hDVOBIwVGtqYh+1UMX2yLi6KnlLzOZqpr4rR7MR
WDBTZzT2DnmeGqVaWV6dBejZgHcoErCcCXrTQVPs8ab7X/ADrB/FcRDmsFYs
TEeeyJPT8U9BkN/ZNA4WFteyVHMbyylh5N19EyBqn4h/13//zWrpNXb2jar2
pNqtM+Ew2TfqFS9EuYJNpK2PYi5yLXGXCqjzRVtTwx4B8swn6K8t7ZnbbR2W
wKYi+FqMRvs13yDheX9wnYTkMLG4+MwwJZyBJXIAHjywVylXK61wmCTEBbAd
1Jwtf52HVYF+DPSpgMmTIj+xXxl3EoqLzlFBzlLilYxYhd0g4gpVj1Tetesb
BTRTwpGHMSoLGb5vOG6wu+MCw2FLK04xgmF8XfpOKuhJfENzVCafuCpZRYfl
hWHpmAdBRZcSKUlxFJf8smmpGryHCG4e3uJ8x7IEsSCHIAiGstOw55TiSQAS
rG0MI5NTKFXC2JxfTRLtt2I3Uyp5i83lLdCnMUMYJMol7n+ARg4ozkmPMe4t
tHeUVhL/Jr2lZfvkDUDREQu1JwybRnFtfcRkn/AOQOqI1lIKSbHyg+ejF4jE
+/dW0AQ0W+SvwmYw7S6j7bV2WK70fkuOPmII6nF6/mb3FFhgSVhY5tAb5d7e
G4ljsvos5upwViPhER+JjAeqFWpctPYhqLmsX+3vowaNex9r0B3c2zEAkKRB
UUPps0ubyB8JXwTcsqHXiiOprFra6wHJqDi5/Am0WCDnCP86lwtchPrBNViI
YO1G5MjMs6qUhf8cjiMBQ2LYycw0TG3f/2a4nKWzHJ3mFO+CDWkZRjey5AH1
u0WVlN1vJ3ERkRLe8k7mOQp0y5sqvUlR44YdosyA95xGp904nfahdNqN0Wk7
QnolVaDkI6wfm3Md3nvtlUc7VbeIdIuQWigPB+AI1peE1SxqdaaQIL2wJ0dl
whteaHiWkl/wfTkHlpnNKa63Yj9k7YcHak9jPn5s9YT2SThnQVOyffhTdLIv
QpAt5ywg1+WaCSqd8wT3SgzuGi/OPmjgkh5VS4yNsgWKYQWF2ytaLQxFxJjt
QcEIbIVN2BusPHX2BKjTifIP6NaNNmK8MhZiB102BTORZQjNJ9YiseMJdn8A
XkxX1CUcZxQAq2k3VE4rMh21W29QRmFQb/iDoQo4aTN3oLCzrQFYQA7XsIaK
bgFWF6PQQmpIsBv9HNPBbS92DXcRvFxDRtJpflLYFHusFAAA9MBURZc3kYJ1
aa2B01pbKMKRC6cbHugxaUnazQPkNdg01wBAIUoaPYWS5l1gTBQYdOngeZKu
zB4foeZy7SEhdnEJjJTvaQh24O+TmucDzrUiL29pBIH0F+2BKTPbUpKMPgv4
XQxHMpI/j2czQGoCOtt3K+DFCBQPveZgQwJBxlkFhAOpqVi+xyt1HLEpdec2
od3okmwqhZwysNqQIjcHsiYQZeW4kuqIHwG8Av0zBwVLgSzUnx0zBeOLfPTE
DDxdvXmZ+aI+Rpsec6AmoDoetKpOUzqixaJfGceetgEcFyV3wN+c9oZA5I5y
fdt2tF627ztN9sPA+FjWSRITXBkS1XAC1lrAAjEQwNac4Yf6CYsieruYBYF3
A23Ra5li/wagD+tiNut4Up8AlK3BVK/hDZX3CpSUgWoQaIiDxtDbmo4bWI7c
xN3E1KsPBoBCp37efAUWpfotiCd/c9qJRlNowCYbeqmOqiqe9DdHq++bptXX
aIvoR1PvpfPebBCAq2tT1pxGe4MWPC0s3nRsyA1I5qcd2/aeLCEP7kmis1nP
xkTNj0zBAjI5r53dFWG8H9/Yb+1udp9NupuFs7hOWI9bfBiNRW/zYgRfi/12
cbDS2hxfieU78Adpd360zsfGzN5ntMOkdQmcTo29odlqU5EU1i9tgskeE/v/
ekT9y37doR1VTxyF//5jiKPwIG8qjn09+8Vxbc9OcfR7biWOfvetxNHvvpE4
1v4ydsI7+VMb+eGfiu9ByVNpRvs/KK9Few8ag606PrL9ZK39ruzBITqw8KIA
4J/rMBg5S1SAsKjiUmdK8tFNOWtWyAp1ORmFoBm1eLSV1jCHUws90qx9oXqL
ijQoRXc68sRebBDXPAuj+RBs/kaum2VTUPprGjBUxBK1b/YWAW4Y+wiWVTHX
Uc/PMNQ6NE6/FiwJkLJU6jRQrRIrLQ6dH/ZQCq8UzLM5q6TFqijlQqvkRguc
oUWoIzeYH2lBKZSBp4PbYGvFM8efc01rAn9bC2tcHuy2qYoqTICmcXqb3ZA3
C7QsmB+o2eyFxdskYo7+ASs5QYEj+6YlAZPcDctEWi6i8cqJvIL6mPK6yKIc
CW3wbJKoyhSqVTxndRFHMqlWOuSZq+gJMo1ECwz+ALbjySGXQmfQOKcJWLeK
V+sUjNhJj2xMIpUx4kK+3TuMTMw4VmOYHRj43eUJPkCOxAh1MVdygmuiNemi
VcsUIl9Ghcq9hv0j+FXMJOUHcexe7TL4BnfEZVWaZ+ax65n3fh59NttjxUWg
lhPDDGohCVc8cMdZlsgw9bvRCllRicYPqayYRx7A+lEzH4RUb1oB9IJgjSKr
Spt6Qj9vklr47zqCO80DOGtRjT4G8RuDYEoPqAjWYjc0fr+Lsl4t+vWQq2NO
tSbmnYN+p/rsbqFtd0NNaFfdaCF3O4hu3WR9X9IxvnlEX9JPbIPKDonhUX2p
LNfjOiHDxMLrs5k9epwOTBuMMspB91FH5ZROEnUWLDEgk1WFSW3ZVb+8GL2g
UITlRNQAmhkhJlZmOBJsZ9rsJln6rDQR9tqvymE6QIM1gtooTzHOQ5mQnKlu
OScpxISJnQC/CGH3dw+5u3ms/HZ1eFhBK0xMjYaleNdYylQrDSPxs2xsxial
ztvozQlQn5X6fNpmf1aaek3KOj5qAqjepi2s7azW9ZFnerYJ14WwgdHQtuG1
CjQL2yP3KEuRPbHSEDfXYk/gxMj79FaEdaUdqJbEeIteu38jhNl2d8RKVdBa
jPLNyknN/qAU2cFR9JXWKs6UndwwGI3SB560mDi3syeUwjgm/qvytPaSMdya
jQRAnxLHo+Ik5GIJJgUJgPYsqrwOYuua4e9Ck3wNwIsqQnnDS56rTRmc5hW0
c8RD1ZKPcQ72n+NN+n1Ezn7KoRe5/1rdAuni6OuseV+klzvucI/jXAlZpxpx
+jDqlypzS9kblIHckt47dHbNod1ETpQx23xqBXvtOBr7YI2bd2hcvxZ/qUOE
Qzox8y9txFreyAujwx+cq61CBoUCLScKMu7dOCJv5M8oYwiMCo4GhNOpvmRF
FFEQjdnXydCiN+tHbJb4Y5qpVwFlUltvP7Q1AN1FqWd/c5sacOp1vSk33bXN
DgZ/PikE7Qtu+o8tBp661p4x5KGk3cFCtCQC2a09J5vvVWniRAPYbrl1XRRO
ta+rfm0vHzB2f15Uo0vN9W1t/GZdmqjXz+/a5yfboPcajXLd2drInPaF5Cv3
R1z8eH16JJ799RmcMHCg3uXhcqnMfkoq/eLzL1+IRqevdjpjJGtCJHaExOzD
DQ91Z2Kd77X2rS7KqWs2XGPK+M07kun8hl2pdH7LdYl03bGjjtDRhpGj7QJH
W8SN+sJGm0WNWgMb9LOZ//qvO81+2/wY7/eDY1EPDkU9OBL1uEDU4+JQjwtD
tUSh1gahNo5BqXPxIeGkh0STNgombRVL2jiU1D1TX/aE/7pF9ryf/x3Zs3+2
kr2+jr2yt7Zjl+z5HbeRPb/3NrLn995Y9lp02h0XVIc6u+ON2a3J+m21/BkH
m8PCdct+/bUDB1919Rv2aa0+En0KawcSRuYaLzvV1NbWtYbqS9Za5bRVGDcX
ozUd21TSHe0+aA9ftLgJtgxe2GyydRhiyyiE7xLfMgbRDcD2XHQFILaJP2wc
fmjQr9G+J5LwiEDCQ+IIG4URHhlFeEQQ4RExhEeEELZxyW0tag3O6OXQNtea
3X8zv3iLW3yNV7xxSHg42o89r7Zxk7DVjNcxp/EsoHugaB2r65jrLGlqq679
Yp3HnAuEIJd8NWjavSNszTc3n5raKZtfriQrHQVKZx/691vf77DIBXDe4z0X
cTA6eLXDRdWKJd7GG1R5eoT9jiiVtzj6dZEcpcURCWoT3gD7qovCQJlXuKHz
TWDvxut7IrlqO6Dqhdj5vtnFgt7a01zErbvblQap7YAuc52cHJ9fCrd2I2GI
DtEwYh4Y/Py9+FmOj+DXP+viYSgQWBfsRuZ1zca7mSrV+DXzDvR7G2PdRfFn
LCxXZkduMcivd7gdX79F+KY+YvO8/HNL8UO/e6P6oQekr9yhD82ud+iB6i5u
6AOyawR6gNrrAvpA6hKJHojWQog+BFMJ0QPQUezQB2GqE7bQw69I6Pd3SxJ6
QLoKD37NTMk3CJY1D1NmeONWQ2sROmtbp5711j5iHK/5egT2wzjOBtU5qFtv
hQ4F+iRbrvJ4Ni/FbrSHtfte8kXK67wquICXCqEVWco7uAlmTej+F9UOLHSu
fESJ3OI4SQRBJY8+FsmYqPHeSVPhVVfPwrQwDBgwMfDJGDg2p7s8i2KoKlvl
1B1/hwMAqWFix0PBSf2LuMSQ9rLKC1ghzNDhcndFRRe3qb8iWBJHMsX8HKqE
QduJquTAgZJ3dMtxIr67eg2bBLWl7nitYorZXHYxicNRpKdfk+5ZId7KWZhg
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

-->

</rfc>
