DHCP Address Release Notification Exit Program


  Required Parameter Group:

1 Reason for release Input Binary(4)
2 Client IP address Input Char(*)
3 Length of client IP address Input Binary(4)
4 Client identifier Input Char(*)
5 Length of client identifier Input Binary(4)

  Exit Point Name: QIBM_QTOD_DHCP_ARLS

  Exit Point Format Name: DHCR0100

The DHCP Address Release Notification exit program allows for notification each time the DHCP server releases an IP address from its specific client host assignment binding.

An address could have been released from the client that it was bound to for one of the following reasons:

  1. The client explicitly sent a DHCP RELEASE request to the DHCP server.
  2. The lease duration that the client was last given for using the IP address has expired.
  3. A DHCP server administrator has explicitly released the IP address.

When an exit program is added to the exit point, it is called whenever the DHCP server releases an IP address from the specific client host that it had been assigned to. This is for notification purposes only, and no data is expected to be sent back to the DHCP server from the exit program. The exit program will be sent information about the IP address, the identity of the client, and the reason for the IP address being released.


Authorities and Locks

None.


Required Parameter Group

Reason for release
INPUT; BINARY(4)

A reason that the DHCP server has released the IP address from being bound to the specific client host. The possible values are:

1 The DHCP server received a DHCP RELEASE packet from the client.
2 The duration of the lease that the client was last given for use of the IP address has expired.
3 The release is forced by DHCP server administrator.

Client IP address
INPUT; CHAR(*)

The Internet Protocol (IP) address that was just released from its client host binding. This string is in dotted decimal format and left-justified.

Length of client IP address
INPUT; BINARY(4)

The length (in bytes) of the client IP address.

Client identifier
INPUT; CHAR(*)

The unique identifier of the client from which the IP address has been released. This is usually the hardware address of the client machine.

Length of client identifier
INPUT; BINARY(4)

The length (in bytes) of the client identifier string.



Exit program introduced: V4R2
Top | Server Support APIs | APIs by category