IBM Support

Detailed Explanations and Actions for Message EZZ7828I ERROR ADDING/DELETING/CHANGING IPV4 STACK ROUTE

Troubleshooting


Problem

This document provides additional detail and actions for occurrences of message EZZ7828I.

Cause

The following message is issued in any instance where OMPROUTE attempts to add a route to the TCPIP stack routing table and TCPIP rejects this attempt:

EZZ7828I Error adding/deleting/changing version stack route, return code retcode, ioctl errno=errno:description, errno2=errnojr

Depending on the ioctl errno returned by TCPIP, OMPROUTE either continues processing or terminates.

This document distinguishes the ioctl errnos which cause OMPROUTE termination from those which allow OMPROUTE to continue processing.

Resolving The Problem

OMPROUTE continues processing if any of the following situations are encountered:

  • If the ioctl errno returned by TCPIP on an attempt to add, delete or change a stack route is x'79' (121 EINVAL). x'79' (121 EINVAL) will be seen on any attempt to add a route which has an invalid IP address/subnet mask combination. This often indicates that the IP address represents a subnet or broadcast address, or some other reserved address and mask combination.
  • If an attempt to change or delete a route to TCPIP results in ioctl errno x'81' (129 ENOENT). This means that an attempt was made to change or delete a route which was no longer in the TCPIP stack.
  • If an attempt to add a route returns ioctl errno x'75' (117 EEXIST) (OMPROUTE has tried to add a route which already exists to TCPIP), or x'46A' (1130 EHOSTUNREACH)/ x'45E' (1118 ENETUNREACH) (OMPROUTE has tried to add a route to TCPIP but the destination is not actually reachable).

OMPROUTE terminates if any of the following situations are encountered:
  • An attempt to change the metric on a stack route fails with an ioctl errno other than l errno x'81' (129 ENOENT) or x'79' (121 EINVAL)
  • An attempt to add a new stack route fails with an errno other than x'75' (117 EEXIST), x'46A' (1130 EHOSTUNREACH), x'45E' (1118 ENETUNREACH) or x'79' (121 EINVAL)
  • An attempt to delete a stack route fails with an errno other than x'81' (129 ENOENT) or x'79' (121 EINVAL)

It is rare for any other nonzero ioctl errno other than x'79' (121 EINVAL) to be returned by TCPIP when trying to add, delete or change routes. However, in a case where OMPROUTE no longer has enough storage to continue processing, an ioctl errno x'462' (1122 ENOBUFS) will be seen and OMPROUTE will terminate.

The following example of message EZZ7828I indicates that OMPROUTE will continue processing:
EZZ7828I ERROR ADDING/DELETING/CHANGING IPV4 STACK ROUTE, RETURN CODE -1, IOCTL ERRNO=121:EDC5121I INVALID ARGUMENT., ERRNO2=742F7252

[{"Product":{"code":"SSSN3L","label":"z\/OS Communications Server"},"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Component":"All","Platform":[{"code":"PF035","label":"z\/OS"},{"code":"PF025","label":"Platform Independent"}],"Version":"1.10;1.11;1.12;1.13;2.1;2.2","Edition":"All Editions","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Document Information

Modified date:
15 June 2018

UID

swg21238001