Display OSPF (DSPOSPF)

Where allowed to run: Interactive environments (*INTERACT *IPGM *IREXX *EXEC)
Threadsafe: No
Parameters
Examples
Error messages

The Display OSPF State and Configuration (DSPOSPF) command can show the current OSPF configuration or the state of the routing protocol. Current configuration information includes OSPF interfaces, neighbors, areas, and virtual links. Current state information includes neighbor state, adjacencies formed, link state database contents, and OSPF routes.

Top

Parameters

Keyword Description Choices Notes
IPVERSION OSPF Version *IPV4, *IPV6 Required, Positional 1
OPTION Option *CFG, *STATE Optional, Positional 2
CONFIG Configuration information *GLOBAL, *AREA, *IFC, *NBCIFC, *NGH, *VRTLNK Optional
STATE State information *IFC, *NGH, *LSA, *RTE Optional
IFC Interface Character value, *ALL Optional
NGH Neighbor Character value, *ALL Optional
LSA Link state advertisement Character value, *EXTERNAL Optional
Top

OSPF Version (IPVERSION)

Specifies which version of OSPF state and configuration information to display.

*IPV4
Display OSPF state and configuration for IPv4.
*IPV6
Display OSPF state and configuration for IPv6.
Top

Option (OPTION)

Specifies the type of OSPF information to be displayed.

*CFG
Display current OSPF configuration information.
*STATE
Display current OSPF state information.
Top

Configuration information (CONFIG)

Specifies which OSPF configuration options are to be displayed.

*GLOBAL
Display the global OSPF information such as router identifier and whether or not the OSPF routing protocol has been enabled.
*AREA
Display the configured OSPF areas.
*IFC
Display the configured OSPF interfaces.
*NBCIFC
Display the configured OSPF nonbroadcast interfaces.
*NGH
Display the configured OSPF neighbors.
*VRTLNK
Display the configured OSPF virtual links.
Top

State information (STATE)

Specifies which OSPF state options are to be displayed.

*IFC
Display the current state of OSPF interfaces.
*NGH
Display the current state of OSPF neighbors.
*LSA
Display the contents of the link-state database.
*RTE
Display the generated OSPF routes to other routers.
Top

Interface (IFC)

Display the current state information of OSPF interfaces.

*ALL
This option display the state of all configured OSPF interfaces.
character-value
Specify the internet address of a particular OSPF interface.

An IPv4 internet address is specified in the form nnn.nnn.nnn.nnn where nnn is a decimal number between 0 and 255. An IPv6 internet address is specified in the form n:n:n:n:n:n:n:n where n is a hexadecimal number in the range from 0 through X'ffff'. The value "::" indicates that one or more groups of 16 bits are zero.

The interface identifier can also be an alias name of an logical interface.

Top

Neighbor (NGH)

Display the current state of OSPF neighbors.

*ALL
Display the state of all configured OSPF neighbors.
character-value
Specifies the internet address of a particular OSPF neighbor.

An IPv4 internet address is specified in the form nnn.nnn.nnn.nnn where nnn is a decimal number between 0 and 255. An IPv6 internet address is specified in the form n:n:n:n:n:n:n:n where n is a hexadecimal number in the range from 0 through X'ffff'. The value "::" indicates that one or more groups of 16 bits are zero.

Top

Link state advertisement (LSA)

Specifies whether to display the external link state advertisements or the link-state database for a particular area.

*EXTERNAL
Display the external link state advertisements.
character-value
Specify the internet address for the area in the form a.a.a.a where a is a decimal number between 1 and 255.
Top

Examples

Example 1:Displaying Global Information of OSPF for IPv4

DSPOSPF   IPVERSION(*IPV4)  OPTION(*CFG)  CONFIG(*GLOBAL)

This command displays the current global configuration panel of IPv4 OSPF, such as router identifier, whether or not the OSPF protocol is enabled, and whether the system has been enabled or not as an autonomous boundary router.

Example 2:Displaying Current Configured IPv4 OSPF Interfaces

DSPOSPF   IPVERSION(*IPV4)  OPTION(*CFG)  CONFIG(*IFC)

This command displays the current configured IPv4 OSPF interfaces panel. This panel shows, for each OSPF interface, the values of the time intervals for sending of hello packets and the database exchange process.

Example 3:Displaying Currently Configured IPv4 OSPF Areas

DSPOSPF   IPVERSION(*IPV4)  OPTION(*CFG)  CONFIG(*AREA)

This command displays the currently configured IPv4 OSPF areas within which this system belongs.

Top

Error messages

*ESCAPE Messages

TCP6512
OSPF state and configuration can not be retrieved because OMPROUTED server is not active.
TCP9999
Internal system error in program &1.
Top