Troubleshooting
Problem
What role does RTVTCPINF play during save procedures?
Environment
The RTVTCPINF is a new cl command that was introduced at 7.2. The command was created to save related TCP/IP configuration items (DB files, Data areas, IFS files, environment variables, validation lists, etc) for the system's TCP/IP processing and some of the system's TCP servers. The TCP/IP configuration objects will be consolidated and managed as a set of related objects. Listed below are the TCP servers that will have its configuration objects saved when the RTVTCPINF command is called:
- TCP/IP server (TCP/IP servers and Host table)
- TCP/IP configuration (interfaces, network, ports, protocols, routes, services and VIPA)
- Bootstrap Protocol (BOOTP)
- Dynamic Host Configuration Protocol (DHCP)
- File Transfer Protocol (FTP)
- HyperText Transfer Protocol (HTTP) - Administration Server
- Internet Daemon (INETD)
- IP packet filtering configuration
- Line Printer Daemon (LPD)
- NetServer (NETSVR)
- OMPROUTE Daemon (OSPF and RIP/RIPng routing daemon)
- Post Office Protocol (POP)
- Point-to-Point Protocol (PPP)
- Quality of Service (QoS)
- Remote Execution (REXEC)
- Route Daemon (RIP routing daemon)
- Simple Mail Transfer Protocol (SMTP)
- Simple Network Management Protocol (SNMP)
- Service and Support Proxy (SRVSPTPRX)
- Telnet
- Trivial File Transfer Protocol (TFTP)
- Virtual Private Network (VPN)
The RTVTCPINF command is automatically run under the covers when the QUSRSYS library is saved. The TCP/IP configuration objects are stored in QUSRSYS as save files before the QUSRSYS library itself is actually saved. The command can also be executed directly on the IBM i command line or invoked within a
CL program i.e. RTVTCPINF LIB(LibraryName).
A restore of the last valid save of the QUSRSYS library will restore the TCP/IP configuration objects that were saved with RTVTCPINF. The UPDTCPINF cl command was created to provide users with a way to restore saved TCP/IP configuration objects interactively or through a batch process. When a user makes a call to UPDTCPINF, they have the option of restoring all of the objects that were saved or just some of the objects. Listed below is a version of UPDTCPINF that can be used to restore only TCP/IP configuration information that were saved in a user's library:
UPDTCPINF LIB(LibraryName) TYPE(*TCPCFG)
When invoked either through a save of the QUSRSYS library or direct call, the RTVTCPINF command understands that some TCP functions may not be configured or used on the system. If the configuration objects for one or more of the TCP servers is missing on the system, the object not found message 'CPFA0A9' will be posted in either the backup procedure's job log or the user's interactive job log. The object not found message for certain TCP/IP configuration objects is normally generated during save operations after the system was migrated to 7.2 or above. In some cases, a few of the TCP servers listed above were not configured prior to the system migration. With some of the TCP servers not configured prior to the system migration, they have no TCP/IP configuration objects to save. When RTVTCPINF is invoked on systems where these TCP servers were not configured prior to the migration, msgCPFA0A9 will be posted because some of the configuration objects are missing for one of more of the above TCP servers.
The RTVTCPINF command tracks when configuration objects may not exist because the corresponding TCP server has not be configured and is not used on the system. When this situation occurs, RTVTCPINF will issue completion message CPCC880.
The RTVTCPINF command will also detect when required configuration objects must exist for all systems with the TC1 product installed. When these objects are missing, the command will issue escape message CPFC880.
Customers may choose to configure TCP servers to remove the CPFA0A9 messages that can be generated for optional configurations, even when the TCP functions are not being used (i.e. Autostart server (AUTOSTART) is set to *NO).
Listed below is a simple procedure that can be used to create the OMPROUTED IFS directory and corresponding configuration objects on systems at 7.2 & above:
On the IBM i command line, type CHGOSPFA and press the enter key.
When changing the system's OSPF attributes for the first time, the system will create IFS directory /QIBM/UserData/OS400/TCPIP/OMPROUTED. The OMPROUTED directory should also contain two new configuration files QTOOSPF.CONF & QTOOSPFINDX.CONF.
The creation of configuration objects for the other TCP servers can be performed to allow RTVTCPINF to complete without generating object not found messages for optional configuration objects used by the TCP servers.
Related Information
[{"Type":"MASTER","Line of Business":{"code":"LOB57","label":"Power"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SWG60","label":"IBM i"},"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.1.0"}]
Was this topic helpful?
Document Information
Modified date:
18 December 2019
UID
nas8N1021215