IP Services: Replace GATEWAY statements in the TCP/IP profile
Description
As of z/OS V2R2, support for the GATEWAY statement in the TCP/IP profile is removed. You must migrate your static route configuration to the equivalent BEGINROUTES statements.
Also, the migration health check ZOSMIGV2R1_CS_GATEWAY is removed in z/OS V2R2.
Table 1 provides more details about this migration action. Use this information to plan your changes to the system.
Element or feature: | z/OS Communications Server. |
---|---|
When change was introduced: | z/OS V2R2. |
Applies to migration from: | z/OS V2R1. |
Timing: | Before installing z/OS V2R3. |
Is the migration action required? | Yes, if you have defined static routes by using GATEWAY statements, you must migrate to the BEGINROUTES statements. |
Target system hardware requirements: | None. |
Target system software requirements: | None. |
Other system (coexistence or fallback) requirements: | None. |
Restrictions: | None. |
System impacts: | TCP/IP configuration error messages are issued if a GATEWAY statement is configured to the TCP/IP stack. |
Related IBM Health Checker for z/OS check: | ZOSMIGV2R1_CS_GATEWAY can help you determine if you are using any GATEWAY statements in your TCP/IP profile. If the GATEWAY statement is processed, warning message EZZ0717I is issued. |
Steps to take
You must migrate your static route configuration from GATEWAY statements to BEGINROUTES statements.
Follow
these steps:
- Obtain a dump of the TCP/IP stack address space from your z/OS V2R1 system.
- Use the TCPIPCS PROFILE command against the dump. The command formats all configured static routes as BEGINROUTES profile statements.
- Use the BEGINROUTES profile statements from the TCPIPCS PROFILE command output to replace the GATEWAY statements in your TCP/IP stack profile.
Remove any customization for the ZOSMIGV2R1_CS_GATEWAY health check in your HZSPRMxx parmlib member.
Reference information
For more information,
see the following references:
- For more information about the TCP/IP profile BEGINROUTES statement, see BEGINROUTES statement in z/OS Communications Server: IP Configuration Reference.
- For more information about health check customization, see IBM Health Checker for z/OS User's Guide