Change IP over SNA Interface (CHGIPSIFC)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The Change IP over SNA Interface (CHGIPSIFC) command changes an existing AF_INET Sockets over SNA interface (an IP address by which this local host is known on the SNA transport). This command changes only the subnetmask. It does not change the internet address. The internet address identifies the interface being changed.

Restrictions:

  1. The user must have *IOSYSCFG authority to use this command.
  2. The interface cannot be active when you submit this command. Use the End IP over SNA Interface (ENDIPSIFC) CL command to deactivate the interface.
  3. There can be no configured routes whose NEXTHOP internet address can be reached only through the network associated with the IP over SNA interface to be changed.
Top

Parameters

Keyword Description Choices Notes
INTNETADR Internet address Character value Required, Key, Positional 1
SUBNETMASK Subnet mask Character value, *SAME Optional, Positional 2
Top

Internet address (INTNETADR)

Specifies the internet address of an interface that has previously been added to the SNA configuration with the Add IP over SNA Interface (ADDIPSIFC) CL command. The internet address is specified in the form nnn.nnn.nnn.nnn where nnn is a decimal number ranging from 0 through 255.

This is a required parameter.

Top

Subnet mask (SUBNETMASK)

Specifies the subnet mask, which is a bit mask that defines the part of the network where this interface attaches. The mask is a 32-bit combination that is logically ANDed with the internet address to determine a particular subnetwork. The bits of the mask set to the value one (1) determine the network and subnetwork portions of the address. The bits set to the value zero (0) determine the host portion of the address.

Notes:

  1. The network portion must be equal to one bit in the subnetmask. The host portion and the subnetmask portion of an address must both be at least two bits wide.
  2. The bits that identify the subnetwork are not required to be adjacent in the address. However, it is strongly recommended that the subnet bits be contiguous and located in the most significant bits of the host address.

The possible values are:

*SAME
The subnet-mask value does not change.
subnet-mask
Specify the mask for the network subnet field and host address field of the internet address that defines a subnetwork. The subnetwork mask is in the form, nnn.nnn.nnn.nnn, where nnn is a decimal number ranging from 0 through 255. The subnet mask must mask off all bits of the network class's network ID portion of the internet address. For more detailed information on subnet masks and an example, see the Add IP over SNA Interface (ADDIPSIFC) CL command.
Top

Examples

CHGIPSIFC   INTNETADR('9.5.1.248')  SUBNETMASK('255.255.0.0')

This command changes the subnet mask of the interface with IP address 9.5.1.248 to 255.255.0.0.

Top

Error messages

*ESCAPE Messages

TCP8050
*IOSYSCFG authority required to use &1.
TCP9999
Internal system error in program &1.
Top