3.1.1.1.1.2.10 GetUtilizationTrendForLogicalGroupNode

This procedure can be used to retrieve the address range utilization trend for the logical group node specified. The following are the input parameters to this procedure:

Param_logicalGroupNode: The LogicalGroupNode for which the address range utilization is being requested.

Param_addressfamily: The AddressFamily of the address range for which the utilization information for the logical group node is being requested.

Param_utilizationType: This is of type IPUtilizationType, specifying the type of utilization data that is being requested.

Param_startDate: This is the start date of the duration for which the utilization trend is being requested.

Param_endDate: This is the end date of the duration for which the utilization trend is being requested.

The following is the output parameter of this procedure.

Result_utilization: This will be of type IPCumulativeUtilization having IpUtilization to be a collection of IPUtilization. If the Param_addressfamily is Internet, the IPv4Utilization is returned and IPv6Utilization if the Param_addressfamily is InternetV6.

The following are the processing steps involved.

  1. Call the procedure GetObjectIdsForLogicalGroupNode passing the following parameters:

    • Param_logicalGroupNode

    • Param_objectType is assigned the value of EnumerationObjectType.IPRange.

    • Param_addressfamily.

  2. If Param_addressfamily is Internet, initialize Result_utilization to IPv4Utilization, otherwise initialize Result_utilization to IPv6Utilization.

  3. For each id in Result_ObjectIds:

    1. Call the procedure GetIPRangeFromTable passing id as Param_Id and Param_addressfamily.

    2. If Param_utilizationType is Current:

      1. Add result.UtilizationStatistics to Result_utilization.

    3. Otherwise, if Param_addressFamily is InternetV6 or Param_utilizationType is not Current,

      1. Call the procedure GetRangeUtilization passing the following parameters:

        • Param_id is set to id.

        • Param_addressfamily

        • Param_utilizationType

        • Param_startDate

        • Param_endDate

      2. Add the corresponding members of IPCumulativeUtilization with Result_utilization.

Return Result_utilization as the output parameter of this procedure.