3.1.1.1.3.2.1 AdjustIPAddressRangeMapping

The AdjustIPAddressRangeMapping procedure can be used to adjust the IP address to IP address range mapping.

The following are the input parameters to this procedure:

Param_rangeId: A 64-bit unsigned value specifying the record identifier of the address range to which the IP address rows have to be mapped onto. This can be 0 to specify the addresses have to be unmapped from existing association.

Param_StartIPAddress: This is of type IPAddress specifying the starting address of the range to which the addresses have to be remapped.

Param_EndIPAddress: This is of type IPAddress specifying the ending address of the range to which the addresses have to be remapped.

Param_AddressSpaceRecordId: This is a 64-bit signed integer that specifies the RecordId of the AddressSpace to which the IPRange specified by Param_rangeId belongs.

Param_ManagedByValue: This is the string value of the predefined custom field of the address range having the CustomFieldRecordId to be ManagedByCustomFieldRecordId.

Param_ManagedByEntityValue: This is the string value of the predefined custom field of the address range having the CustomFieldRecordId to be ManagedByEntityCustomFieldRecordId.

This procedure has no return value.

The steps involved in this procedure are as follows:

  1. The address family of the Param_StartIPAddress and Param_EndIPAddress passed as parameter to the procedure determines the simple table of the ADM_IPAddressTable compound table to be used for performing the processing steps.

  2. Enumerate the rows in ADM_IPAddressTable having their address within the specified Param_StartIPAddress and Param_EndIPAddress, and AddressSpaceRecordId equal to Param_AddressSpaceRecordId.

  3. For each row enumerated from the previous step, compute the ManagedByValue and ManagedByEntityValue fields. If these field values are the same as the Param_ManagedByValue and Param_ManagedByEntityValue passed in as parameters, set their ParentIPRangeRecordId to the specified Param_rangeId value and update the table.