Send Neighbor Solicitation (NDPING)

The Send Neighbor Solicitation (SNDNGHSOL) command, also known as NDPING, tests the reachability of an IPv6 address on the local network using the Neighbor Discovery protocol.

Parameters

Keyword Description Choices Notes
INTNETADR Remote internet address Character value Required, Positional 1
LIND Line description Element list Required, Positional 2
Element 1: Line description Name
Element 2: Virtual LAN identifier 1-4094, *NONE
MSGMODE Message mode Element list Optional
Element 1: Response message detail *VERBOSE, *QUIET
Element 2: Summary, if response errors *COMP, *ESCAPE

Remote internet address (INTNETADR)

Specifies the remote IP version 6 internet address to which the Neighbor Solicitation is sent.

character-value
Specify the internet address of the remote system. If the internet address is entered from a command line, the address must be enclosed in apostrophes.

Line description (LIND)

Specifies the name of the line description associated with the network over which the Neighbor Solicitation is sent.

Element 1: Line description

name
Specify the name of an existing line description to be used for sending the Neighbor Solicitation.

Element 2: Virtual LAN identifier

Specifies the virtual LAN identifier to be used for sending the Neighbor Solicitation on an Ethernet line. This identifies the virtual LAN according to IEEE standard 802.1Q.

*NONE
The line is not part of a virtual LAN.
1-4094
Specify the virtual LAN identifier of the associated line.

Message mode (MSGMODE)

Specifies the amount of information to be displayed.

Element 1: Response message detail

*VERBOSE
Display messages as each Neighbor Advertisement response arrives.
*QUIET
Display only the initial NDPING (SNDNGHSOL) message and the summary message.

Element 2: Summary, if response errors

*COMP
The summary message returned by the NDPING (SNDNGHSOL) request is a completion message.
*ESCAPE
A monitorable escape message is returned. This is useful if you have written a program to issue the NDPING request and wish to monitor the NDPING request for errors. See the error messages section of the NDPING (SNDNGHSOL) command help for a list of possible escape messages.

Examples 

SNDNGHSOL INTNETADR('fe80::1:1:2') LIND(ETHLINE *NONE)
          MSGMODE(*QUIET *ESCAPE)

This command sends a Neighbor Solicitation message to the IP address fe80::1:1:2 to the network associated with line description ETHLINE with no associated virtual LAN.

Because the *QUIET option of the MSGMODE parameter is specified, no intermediate status messages are displayed. If no responses to the Neighbor Solicitations are received, the final summary message is sent as an escape message because of the *ESCAPE option of the MSGMODE parameter.

Error messages

*ESCAPE Messages

TCP1901
Internet address &2 not valid.
TCP3234
The specified line name does not support IPv6 Neighbor Discovery.
TCP3235
Error occurred sending Neighbor Solicitation. Reason code &1.
TCP3240
Neighbor Solicitation statistics: &1 of &2 successful (&3 %).