This article follows on from getting the simplest example of OSPF working. It gives the z/OS commands to display useful information.
I want to
- Display a summary of the configuration, number of links, number of interfaces (one line of output per area). F OMP1,OSPF,areasum
- Display the routers. F OMP1,ospf,database,areaid=0.0.0.0
- Display the directly connected links. F OMP1,ospf,neighbor
- Display all links, by IP address from F OMP1,OSPF, LSA, LSTYPE=2,LSID=…
- Display links for a specific ospf router. F OMP1,OSPF, LSA, LSTYPE=1,LSID=…
- Display the IP addresses in the network. Either use F OMP1,RTTABLE or for each router F OMP1,OSPF,LSA,LSTYPE=1,LSID=…. , LINK ID: is the IP address of the remote end, LINK DATA: is the IP address of the router’s end.
- Display all of the routers in the network. F OMP1,ospf,database,areaid=0.0.0.0 and extract “LS ORIGINATOR”
- Display the connection from an ospf router. F OMP1,OSPF,LSA,LSTYPE=1,LSID=….
OMP1
I configured multiple TCPIP subsystems, and each one had an OMPROUTE defined. I used a started task OEMP1, as the OMPROUTE for my base TCPIP.
If you have only one TCPIP subsystem, you can use OMPROUTE as your name.
F OMP1,OSPF,areasum
This displays the area summary.
AREA ID AUTHENTICATION #IFCS #NETS #RTRS #BRDRS DEMAND 0.0.0.0 NONE 2 3 3 0 OFF
F OMP1,OSPF,EXTERNAL
EZZ7853I AREA LINK STATE DATABASE
TYPE LS DESTINATION LS ORIGINATOR SEQNO AGE XSUM
# ADVERTISEMENTS: 0
CHECKSUM TOTAL: 0X0
F OMP1,ospf,list,areas
“Displays all information concerning configured OSPF areas and their associated ranges.”
EZZ7832I AREA CONFIGURATION 820
AREA ID AUTYPE STUB? DEFAULT-COST IMPORT-SUMMARIES?
0.0.0.0 0=NONE NO N/A N/A
--AREA RANGES--
AREA ID ADDRESS MASK ADVERTISE?
0.0.0.0 11.11.0.0 255.255.255.0 YES
The entry with address 11.11.0.0 comes from the omproute configuration file entry
range ip_address=11.11.0.1
subnet_mask=255.255.255.0
;
F OMP1,ospf,list,ifs
“For each OSPF interface, display the IP address and configured parameters as coded in the
OMPROUTE configuation file”
EZZ7833I INTERFACE CONFIGURATION 822 IP ADDRESS AREA COST RTRNS TRDLY PRI HELLO DEAD DB_EX 10.1.3.2 0.0.0.0 1 5 1 1 10 40 40 10.1.1.2 0.0.0.0 1 5 1 1 10 40 40
F OMP1,ospf,list,nbma
“Displays the interface address and polling interval related to interfaces connected to nonbroadcast multiaccess networks.”
NBMA CONFIGURATION 824 INTERFACE ADDR POLL INTERVAL << NONE CONFIGURED >>
F OMP1,ospf,list,nbrs
“Displays the configured neighbors on non-broadcast networks”
NEIGHBOR CONFIGURATION 826 NEIGHBOR ADDR INTERFACE ADDRESS DR ELIGIBLE? << NONE CONFIGURED >>
F OMP1,ospf,list,vlinks
“Displays all virtual links that have been configured with this router as an endpoint.”
VIRTUAL LINK CONFIGURATION 828 VIRTUAL ENDPOINT TRANSIT AREA RTRNS TRNSDLY HELLO DEAD DB_EX << NONE CONFIGURED >>
F OMP1,ospf,database,areaid=0.0.0.0
EZZ7853I AREA LINK STATE DATABASE TYPE LS DESTINATION LS ORIGINATOR SEQNO AGE XSUM 1 1.2.3.4 1.2.3.4 0X80000013 61 0X3D8D 1 9.2.3.4 9.2.3.4 0X8000001A 393 0X5A78 1 @10.1.1.2 10.1.1.2 0X8000000D 286 0X9E22 2 10.1.0.2 1.2.3.4 0X80000006 1241 0XC35E 2 10.1.1.1 9.2.3.4 0X80000003 353 0X8197 2 @10.1.1.2 10.1.1.2 0X80000005 3600 0X64BD 2 10.1.3.1 9.2.3.4 0X80000003 383 0X6BAB 2 @10.1.3.2 10.1.1.2 0X80000005 3600 0X4ED1
(LS) Type is described here.
- Router links advertisement
- Network link advertisement
- Summary link advertisement
- Summary ASBR advertisement
- Autonomous System (AS -think entire network) external link.
- LS ORIGINATOR: Indicates the router that originated the advertisement.
- LS DESTINATION: Indicates an IP destination (network, subnet, or host).
From the above
TYPE LS DESTINATION LS ORIGINATOR 2 10.1.0.2 1.2.3.4
means router 1.2.3.4 told every one that it has the end of a network link, and its address is 10.1.0.2.
TYPE LS DESTINATION LS ORIGINATOR
1 1.2.3.4 1.2.3.4
says router 1.2.3.4 told every one “here I am, router 1.2.3.4”.
You can use the type and destination in the command:
F OMP1,OSPF,LSA,LSTYPE=…,LSID=…
For example
below.
F OMP1,OSPF,LSA,LSTYPE=1,LSID=1.2.3.4
This allows you to see a lot of information about an individual element of the OSPF database.
LSTYPE=1 is for Router Links Advertisment.
The valid LSID values are given in the output of F OMP1,ospf,database,areaid=0.0.0.0 above.
F OMP1,OSPF,LSA,LSTYPE=1,LSID=9.2.3.4
EZZ7880I LSA DETAILS
LS DESTINATION (ID): 9.2.3.4
LS ORIGINATOR: 9.2.3.4
ROUTER TYPE: (0X00)
# ROUTER IFCS: 3
LINK ID: 10.1.0.2
LINK DATA: 10.1.0.3
INTERFACE TYPE: 2
LINK ID: 10.1.1.2
LINK DATA: 10.1.1.1
INTERFACE TYPE: 2
LINK ID: 10.1.3.2
LINK DATA: 10.1.3.1
INTERFACE TYPE: 2
- LINK ID: Is the IP address of the remote end
- LINK DATA: Is the IP address of the router’s end
- INTERFACE TYPE: 2 is “Network links”.
F OMP1,OSPF,LSA,LSTYPE=2,LSID=10.1.0.3
This allows you to see a lot of information about an individual element of the OSPF database.
LSTYPE=2 is “Network links the set of routers attached to a network”.
The valid LSID values are given in the output of F OMP1,ospf,database,areaid=0.0.0.0 above, with type=2.
F OMP1,OSPF,LSA,LSTYPE=2,LSID=10.1.0.3 EZZ7880I LSA DETAILS LS OPTIONS: E (0X02) LS TYPE: 2 LS DESTINATION (ID): 10.1.0.3 LS ORIGINATOR: 9.2.3.4 NETWORK MASK: 255.255.255.0 ATTACHED ROUTER: 1.2.3.4 (100) ATTACHED ROUTER: 9.2.3.4 (100)
Where (100) is the metric.
F OMP1,ospf,if
EZZ7849I INTERFACES 832 IFC ADDRESS PHYS ASSOC. AREA TYPE STATE #NBRS #ADJS 10.1.3.2 JFPORTCP4 0.0.0.0 BRDCST 64 1 1 10.1.1.2 ETH1 0.0.0.0 BRDCST 64 1 1
F OMP1,ospf,neighbor
EZZ7851I NEIGHBOR SUMMARY 834 NEIGHBOR ADDR NEIGHBOR ID STATE LSRXL DBSUM LSREQ HSUP IFC 10.1.3.1 9.2.3.4 128 0 0 0 OFF JFPORTCP4 10.1.1.1 9.2.3.4 128 0 0 0 OFF ETH1
F OMP1,ospf,routers
EZZ7855I OSPF ROUTERS 836
DTYPE RTYPE DESTINATION AREA COST NEXT HOP(S)
NONE
F OMP1,ospf,statistics
EZZ7856I OSPF STATISTICS 838
OSPF ROUTER ID: 10.1.1.2 (*OSPF)
EXTERNAL COMPARISON: TYPE 2
AS BOUNDARY CAPABILITY: NO
ATTACHED AREAS: 1 OSPF PACKETS RCVD: 3336
OSPF PACKETS RCVD W/ERRS: 0 TRANSIT NODES ALLOCATED: 84
TRANSIT NODES FREED: 78 LS ADV. ALLOCATED: 1
LS ADV. FREED: 1 QUEUE HEADERS ALLOC: 32
QUEUE HEADERS AVAIL: 32 MAXIMUM LSA SIZE: 512
# DIJKSTRA RUNS: 4 INCREMENTAL SUMM. UPDATES: 0
INCREMENTAL VL UPDATES: 0 MULTICAST PKTS SENT: 3371
UNICAST PKTS SENT: 7 LS ADV. AGED OUT: 1
LS ADV. FLUSHED: 1 PTRS TO INVALID LS ADV: 0
INCREMENTAL EXT. UPDATES: 0
F OMP1,OSPF,LSA,LSTYPE=2,LSID=10.1.0.3
Where
- LSTYPE=2 is “Network links the set of routers attached to a network”.
- 10.1.0.3 is an LS destination (from F OMP1,ospf,database,areaid=…) It comes from the frr definition below
interface eno1 ip address 10.1.0.3 peer 10.1.0.2/24
Only addresses on the Server are accepted. Addresses from the Laptop are not valid.
In the command F OMP1,OSPF,LSA,LSTYPE=1,LSID=1.2.3.4, some of the LINK IDs seem to be valid.
F OMP1,OSPF,LSA,LSTYPE=1,LSID=x.x.x.x
This allows you to see a lot of information about an individual element of the OSPF database.
The LSATYPE is described in here. LSTYPE=1 is for Router Links Advertisment.
The LSID is one of the routers, for example in
- F OMP1,ospf,database,areaid=0.0.0.0, it displays, LS DESTINATION LS ORIGINATOR
- F OMP1,ospf,neighbor, it displays NEIGHBOR ID
F OMP1,OSPF,LSA,LSTYPE=1,LSID=9.2.3.4
EZZ7880I LSA DETAILS
LS DESTINATION (ID): 9.2.3.4
LS ORIGINATOR: 9.2.3.4
ROUTER TYPE: (0X00)
# ROUTER IFCS: 3
LINK ID: 10.1.0.3
LINK DATA: 10.1.0.3
INTERFACE TYPE: 2
LINK ID: 10.1.1.1
LINK DATA: 10.1.1.1
INTERFACE TYPE: 2
LINK ID: 10.1.3.1
LINK DATA: 10.1.3.1
INTERFACE TYPE: 2
F OMP1,RTTABLE
EZZ7847I ROUTING TABLE 842
TYPE DEST NET MASK COST AGE NEXT HOP(S)
STAT* 10.0.0.0 FF000000 0 16079 10.1.1.2
SPF 10.1.0.0 FFFFFF00 101 16071 10.1.1.1 (2)
SPF* 10.1.1.0 FFFFFF00 1 16078 ETH1
SPF* 10.1.3.0 FFFFFF00 1 16078 JFPORTCP4
SPF 11.1.0.2 FFFFFFFF 201 4733 10.1.1.1 (2)
0 NETS DELETED, 3 NETS INACTIVE
(2) is the number of equal-cost routes to the destination.
D TCPIP,,OMPROUTE,RTTABLE,DEST=10.1.0.0
gives
EZZ7874I ROUTE EXPANSION 105
DESTINATION: 10.1.0.0
MASK: 255.255.255.0
ROUTE TYPE: SPF
DISTANCE: 101
AGE: 943
NEXT HOP(S): 10.1.1.1 (ETH1)
10.1.3.1 (JFPORTCP4)
ColinPaice 
One thought on “OSPF on z/OS, basic commands”