CHGIPSIFC (Change IP over SNA Interface)

CHGIPSIFC Command syntax diagram

 

Purpose

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 through the network associated with the IP over SNA interface to be changed.

 

Required Parameters

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. If the internet address is entered from a command line, the address must be enclosed in apostrophes.

 

Optional Parameters

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.

Note:

The network portion must be equal to one bits in the subnetmask. The host portion of an address must be at least two bits wide.

Note:

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.

*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.

Example for CHGIPSIFC

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.

Error messages for CHGIPSIFC

*ESCAPE Messages

TCP8050

*IOSYSCFG authority required to use &1.

TCP9999

Internal system error in program &1.