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 and V1R13. |
| Timing: | Before installing z/OS V2R2. |
| 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. This check is provided in z/OS V1R13 via VTAM APAR OA43345 and TCP/IP APAR PM96813. 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 or V1R13 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 on health check customization, see IBM Health Checker for z/OS User's Guide