Add IP over SNA Interface (ADDIPSIFC)

The Add IP over SNA Interface (ADDIPSIFC) command is used to define AF_INET Sockets over SNA interfaces. An interface is an IP address by which this local host is known on the SNA transport. The interfaces defined by the ADDIPSIFC command are logical interfaces. They are not physical interfaces and they are not associated with any line description or network interface. There may be multiple AF_INET Sockets over SNA logical interfaces defined on a host.

Note: When an interface is added it is activated by default if AF_INET Sockets over SNA communications is active and the user issuing the ADDIPSIFC command is authorized to start AF_INET Sockets over SNA interfaces. A user must have authority to the Start IP over SNA Interface (STRIPSIFC) CL command to have the authority to start AF_INET Sockets over SNA interfaces. If the interface should not be active, use the End IP over SNA Interface (ENDIPSIFC) CL command to deactivate it.

Only eight (8) AF_INET sockets over SNA interfaces can be active on a single host. If the maximum number of interfaces are already active, the interface being added will not be started. If you want the interface started, you must first end one or more active interfaces using the End IP over SNA interfaces (ENDIPSIFC) CL command and then use the Start IP over SNA interfaces (STRIPSIFC) CL command to start the interface.

Restriction: The user must have *IOSYSCFG authority to use this command.

Keyword	Description	Choices	Notes
INTNETADR	Internet address	Character value	Required, Positional 1
SUBNETMASK	Subnet mask	Character value	Required, Positional 2

Internet address (INTNETADR)

Specifies an internet address that the local system responds to on this interface. The internet address is specified in the form nnn.nnn.nnn.nnn, where nnn is a decimal number ranging from 0 through 255. An internet address is not valid if it has a value of all binary ones or all binary zeros for the network identifier (ID) portion or the host ID portion of the address. If the internet address is entered from a command line, the address must be enclosed in apostrophes.

This is a required parameter.

Restrictions:

The internet address cannot begin with 0 (for example, 0.nnn.nnn.nnn).
The internet address cannot begin with 127 (for example, 127.nnn.nnn.nnn). This address range is reserved for TCP/IP loopback addresses.
The internet address cannot be a class D or class E address. Class D addresses range from 224.nnn.nnn.nnn to 239.nnn.nnn.nnn. Class E addresses range from 240.nnn.nnn.nnn to 255.nnn.nnn.nnn.
Each interface must have a unique internet address and cannot be the same as any defined TCP/IP interface internet address.

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.

This is a required parameter.

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

The possible values are:

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. This means the subnet mask for a class A address must be 255.nnn.nnn.nnn, the subnet mask for a class B address must be 255.255.nnn.nnn, and the subnet mask for a class C address must be 255.255.255.nnn. For example, 255.255.255.0 could define a subnet mask for an interface with a class B internet address. In this example, the first two octets must be 1 bits because these octets define the network ID portion of the class B internet address. The third octet of this subnet mask defines the actual subnet mask ID portion of the interface's internet address. It is also all 1 bits. This leaves the fourth octet to define the host ID portion of the interface's internet address.

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.

Note: If the subnet mask is entered from a command line, the address must be enclosed in apostrophes.

Restriction: The subnet mask cannot be 255.255.255.255 for a class A, class B, or class C interface internet address.

Examples

ADDIPSIFC   INTNETADR('9.5.1.248')  SUBNETMASK('255.255.255.0')

This command designates an IP address for this local host on the SNA transport which is 9.5.1.248. The SUBNETMASK indicates that network 9 is subnetted using bytes 2 and 3 of the internet address as the subnetwork.