Add Point-to-Point Profile (ADDTCPPTP)

The Add Point-to-Point Profile (ADDTCPPTP) command is used to create a simple PPP (point-to-point protocol) connection profile. Profiles can be created to answer incoming calls by specifying OPRMODE(*ANS), or to dial remote systems by specifying OPRMODE(*DIAL).

Note: The preferred method of creating point-to-point profiles is through Systems Director Navigator, since it supports all features of PPP. In cases where it is not feasible to create a point-to-point profile using Systems Director Navigator, the ADDTCPPTP command can be used to create a simple point-to-point profile.

Restrictions:

• You must have input/output system configuration (*IOSYSCFG) special authority to run this command.

Parameters

Configuration profile (CFGPRF)

Specifies the point-to-point configuration profile to be added.

This is a required parameter.

character-value

Specify the name of a point-to-point configuration profile to add.

Operating mode (OPRMODE)

Specifies the mode of operation for this point-to-point connection profile.

This is a required parameter.

*ANS

The profile is defined to answer calls from a remote system.

*DIAL

The profile is defined to dial a remote system.

Resource name (RSRCNAME)

Specifies the communications hardware resource to be used by this profile.

*CALC

The resource name will be determined as follows:

• Look for resources being used by the 2771 integrated modem. If only one 2771 is defined, use that resource for this PPP line. *CALC is not valid if more than one 2771 modem is defined.
• If a 2771 cannot be used, determine if any resources are defined for use by ECS (Electronic Customer Support). If an ECS resource is available, use that resource for this PPP line.
• If neither a single 2771 integrated modem or ECS resource is available, the resource cannot be calculated and it will have to be explicitly defined.

name

Specify the name of the hardware resource.

Note: You can use the Work With Hardware Resources (WRKHDWRSC) command with *CMN specified for the TYPE parameter to help determine the resource name.

Modem (MODEM)

Specifies the modem description to use for this point-to-point profile. The list of currently supported modem descriptions can be seen by using the *SELECT value in interactive mode or by using option 11 from the Configure Point-to-Point TCPIP (CFGTCPPTP) command.

*RSRCNAME

The modem name will be determined based on the value defined for the RSRCNAME parameter. If the resource does not have a pre-defined modem description, MODEM(*RSRCNAME) cannot be used and the modem description will have to be explicitly defined.

*SELECT

A list of modems is shown from which you will select the modem to use. This option is only valid when running the ADDTCPPTP command in interactive mode, otherwise an error will occur. If you are running interactively, it is recommended that you use the *SELECT value to help ensure that you properly select the modem to use.

character-value

Specify the name of the modem to use. Note that modem names are case sensitive and must match exactly to the modems defined for the system.

You can also specify a generic name of the modem you wish to use. A generic modem name is a character string of one or more characters followed by an asterisk (*); for example, 'abc*'. If a generic name is specified, then the first modem name that matches the generic name will be used. It is recommended that you include as many characters in the modem name string as possible to avoid any ambiguity. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete modem name. The actual modem name chosen will be posted in a message in the job log.

Calling number (CALLNBR)

Specifies the telephone number of the remote system to call. This parameter is only used when OPRMODE(*DIAL) is defined.

*NONE

No telephone number is defined. If OPRMODE(*DIAL) is specified, a value other then *NONE must be defined for this parameter.

character-value

Specify the telephone number to call to connect to the remote system. If additional numbers are required to establish an outside call, they must also be specified. Special character ',' (comma) may be used to signify if a delay is required before dialing the next number. Typically this delay is one second for most modems.

Enable PPP authentication (ENBPPPAUT)

Specifies whether PPP authentication will be enabled for this profile.

*NO

No PPP authentication will be required to either connect to the remote system or to allow the remote system to connect to the local system.

*YES

PPP authentication will be required to either connect to the remote system or to allow the remote system to connect to the local system.

PPP authentication (PPPAUT)

Specifies the PPP authentication values to use for PPP authentication. This parameter is only in effect if ENBPPPAUT(*YES) is defined.

User name and password

Specifies the user names and passwords to use for PPP authentication. Only one user name and password can be specified for OPRMODE(*DIAL) profiles. Up to ten user names and passwords can be specified for OPRMODE(*ANS) profiles. Additional entries can be added with Systems Director Navigator.

User name

character-value

Specify the user name to be used for PPP authentication. Each user name can be up to 64 characters in length. User names are case sensitive and will be stored exactly as they are entered.

User password

character-value

Specify the password associated with the user name. Each password can be up to 64 characters in length. Passwords are case sensitive and will be stored exactly as they are entered.

Authentication protocol

Specifies which authentication protocol to use for PPP authentication. This value also specifies which authentication protocol to associate with each specified user name and password.

*ENCRYPTED

Only PPP authentication methods using encrypted passwords will be used. This value will support both EAP (Extended Authentication Protocol) and CHAP (Challenge Handshake Authentication Protocol - using MD-5 hashing algorithm).

*UNENCRYPTED

Only PPP authentication methods using unencrypted passwords will be used. Currently this is limited to PAP (Password Authentication Protocol).

Note: This method of authentication is not as secure as CHAP or EAP since it allows user name and password information to flow over the link unprotected.

Validation list

Specifies the validation list used to store remote user name and password information for OPRMODE(*ANS) profiles. This element is ignored if OPRMODE(*DIAL) is specified. All validation lists defined for use by PPP must exist in library QUSRSYS.

*CFGPRF

The validation list to store user name and password information is the same name as the point-to-point profile. If the validation list does not exist, it will be created in library QUSRSYS.

name

Specify the name of the validation list in library QUSRSYS to store username and password information. If the validation list does not exist, it will be created.

Inactivity timer (INACTTMR)

Specifies the time (in seconds) that the system waits for user data activity for this profile before disconnecting. This timer is started once LCP (Link Control Protocol) and NCP (Network Control Protocol) negotiations have completed successfully, and restarted when user data is sent or received. LCP and NCP packets do not cause this timer to be restarted.

*NOMAX

The inactivity timer is disabled.

15-65535

Specify the number of seconds to use as the timer value.

Enable IPv4 (IP4)

Specifies whether Internet Protocol version 4 (IPv4) is enabled for this link.

*YES

IPv4 is enabled for this link.

*NO

IPv4 is not enabled for this link.

Local internet address (LCLINTNETA)

Specifies the local IPv4 internet address of the system to be used for this PPP connection.

*OPRMODE

The mode of operation will determine the local IP address. If OPRMODE(*DIAL) is specified, the local IP address will be defined as *DYNAMIC. If OPRMODE(*ANS) is specified, the local IP address will defined as *CURRENT.

*DYNAMIC

The IP address will be defined by the remote system during PPP negotiations.

*CURRENT

The current local IP address will be used. This address is determined as follows:

• If a local host name has been defined using the Change TCP/IP Domain (CHGTCPDMN) command, this host name will be resolved to an IP address (either defined in the local host table or by a domain name server). If this IP address is found to also exist on the local system, it will be used.
• If no local host name is defined, or could not be resolved to, the first valid local IP address found will be used.
• If no valid local IP addresses are found, *CURRENT will not be allowed.

character-value

Specify the internet address to use as the local IP address for this PPP profile. The address specified here can already exist on the system or a unique IP address can be defined.

Remote internet address (RMTINTNETA)

Specifies the IPv4 internet address of the remote system to use for this PPP connection.

*OPRMODE

The mode of operation will determine the remote IP address. If OPRMODE(*DIAL) is specified, the remote IP address will be defined as *DYNAMIC. If OPRMODE(*ANS) is specified, the remote IP address will be defined as '169.254.x.x' where 169.254.x.x is a reserved IANA LINKLOCAL network address. The actual host portion (x.x) of this address will be determined at run-time.

*DYNAMIC

The IP address will be defined by the remote system during PPP negotiations.

character-value

Specify the internet address to use as the remote IP address for this PPP profile. The address specified here must be an unique IP address for this system.

IP datagram forwarding (IPDTGFWD)

Specifies whether IPv4 datagrams received on this link are forwarded to other networks. This parameter is only in effect if IP4(*YES) and OPRMODE(*ANS) are specified. This parameter is also only in effect if system-wide IP datagram forwarding is enabled. System-wide IP datagram forwarding is controlled by the IPDTGFWD parameter on the Change TCP/IP Attributes (CHGTCPA) command.

*NO

IPv4 datagrams are not forwarded.

*YES

IPv4 datagrams are forwarded.

Enable IPv6 (IP6)

Specifies whether Internet Protocol version 6 (IPv6) is enabled for this link.

*YES

IPv6 is enabled for this link.

*NO

IPv6 is not enabled for this link.

Interface ID (IFCID)

Specifies the 64-bit interface identifier initially used in IPv6 Control Protocol (IPV6CP) negotiation on this link. IPV6CP may negotiate an interface identifier value different than what is specified here. The interface identifier negotiated by IPV6CP is used to autoconfigure an IPv6 link-local unicast address for this link.

*GEN

Generate a random interface ID.

0000000000000001-FFFFFFFFFFFFFFFF

Specify the interface ID to be used.

IPv6 datagram forwarding (IP6DTGFWD)

Specifies whether IPv6 datagrams received on this link are forwarded to other networks. Enabling IPv6 datagram forwarding also enables the system to perform router functions for this link, including sending Router Advertisement messages and responding to Router Solicit messages. This parameter overrides the system-wide IP datagram forwarding setting. System-wide IP datagram forwarding is controlled by the IPDTGFWD parameter on the Change TCP/IP Attributes (CHGTCPA) command. This parameter is only in effect if IP6(*YES) is specified.

*NO

IPv6 datagrams are not forwarded.

*YES

IPv6 datagrams are forwarded.

IPv6 prefix (ADRPFX)

Specifies a 64-bit IPv6 address prefix that will be included in Router Advertisement messages sent on this link.

An IPv6 address prefix is specified in the form x:x:x:x, where x is a hexadecimal number ranging from 0 through X'FFFF'. "::" may be used once in the address prefix to indicate one or more groups of 16 bits of zeros. The "::" may be used to compress leading, imbedded, or trailing zeros in the address.

Examples of address prefixes:

• 2001:DB8:0:0
• 2001:DB8::
• 2001:DB8::1234
• 2001:DB8:1234:5678

This parameter is only enabled if IP6DTGFWD(*YES) is specified.

*NONE

A 64-bit IPv6 address prefix is not included in Router Advertisement messages sent on this link.

*PROXY

Proxy Neighbor Discovery is enabled over this link. At least one Ethernet line description and associated VLAN ID must be specified for the PREFLIND parameter.

hexadecimal-value

A 64-bit IPv6 address prefix to include in Router Advertisement messages sent on this link.

Advertise default route (AVTDFTRTE)

Specifies whether the system will include a default route in Router Advertisement messages sent on this link.

This parameter is only enabled if IP6DTGFWD(*YES) is specified.

*YES

The system will advertise a default route.

*NO

The system will not advertise a default route.

Managed address configuration (MFLAG)

Specifies that the "Managed address configuration" flag (M flag) is set in Router Advertisement messages sent on this link. When the M flag is set, it indicates that addresses are available via Dynamic Host Configuration Protocol (DHCPv6).

This parameter is only enabled if IP6DTGFWD(*YES) is specified.

*NO

The M flag will not be sent in Router Advertisement messages on this link.

*YES

The M flag will be sent in Router Advertisement messages on this link.

Other configuration (OFLAG)

Specifies that the "Other configuration" flag (O flag) is set in Router Advertisement messages sent on this link. When the O flag is set, it indicates that other configuration information is available via Dynamic Host Configuration Protocol (DHCPv6). Examples of such information are DNS-related information or information on other servers within the network.

This parameter is only enabled if IP6DTGFWD(*YES) is specified.

*NO

The O flag will not be sent in Router Advertisement messages on this link.

*YES

The O flag will be sent in Router Advertisement messages on this link.

Accept default route (ACPDFTRTE)

Specifies whether the system will accept a default route in a Router Advertisement message received on this link.

This parameter is only enabled if IP6DTGFWD(*NO) is specified.

*YES

The system will accept a default route.

*NO

The system will not accept a default route.

Preferred line descriptions (PREFLIND)

Specifies a list of Ethernet line descriptions and associated virtual LAN identifiers that will be used for proxy Neighbor Discovery with this PPP link. Up to 4 sets of line description/virtual LAN identifier pairs may be specified in order of preference -- the first being the most preferred, the second the next preferred, etc. Each Ethernet line description must be used by at least one IPv6 interface.

This parameter is only enabled if ADRPFX(*PROXY) is specified.

Single values

*NONE

No preferred line descriptions are specified.

Element 1: Line description

name

Specify the name of an Ethernet line description.

Element 2: Virtual LAN identifier Specifies the virtual LAN identifier of the associated line. This identifies the virtual LAN to which this interface belongs according to IEEE standard 802.1Q. This parameter is only valid for lines configured for Ethernet adapters that support the 802.1Q standard.

*NONE

The associated line is not part of a virtual LAN.

1-4094

Specify the virtual LAN identifier of the associated line.

Text 'description' (TEXT)

Specifies the text description for the point-to-point profile.

*BLANK

No text is specified.

character-value

Specify no more than 50 characters of text, enclosed in apostrophes.

Full masquerading (FULLMASQ)

Specifies whether full masquerading will be used. If enabled, all IP addresses will be hidden behind the remote IP address for the dial PPP connection. This parameter is only in effect if OPRMODE(*DIAL) is specified. This feature allows all outbound IP traffic to have its source IP address translated to the remote IP address defined for the PPP link. The source port is also modified, so that return IP traffic can be properly associated with the correct conversation and have its IP address and destination port changed back to the correct values.

This feature is particularly useful to allow other hosts on the same network as the local system to use the system as a gateway to the Internet. If the local system is connected to the Internet using an ISP (Internet Service Provider), the other hosts, such as PCs, could also gain access to the Internet and 'hide' behind the system's assigned PPP IP address.

*NO

No IP addresses will be hidden (masqueraded) behind the system's PPP IP address.

*YES

All IP addresses will be hidden (masqueraded) behind the system's PPP IP address when traffic flows out the PPP link.

Allow remote address override (ALWRMTOVR)

Specifies whether remote systems will be allowed to override the remote IP address defined in RMTINTNETA. This parameter is only in effect if OPRMODE(*ANS) is specified and RMTINTNETA(*DYNAMIC) is not specified.

*NO

If a specific remote IP address is defined for RMTINTNETA, remote systems will not be allowed to define their own address. The remote system must use the address defined by the local system or the PPP connection will be terminated.

*YES

If a specific remote IP address is defined for RMTINTNETA, remote systems will still be allowed to define their own address. This is useful if you want to allow more than one type of remote client to be able to dial into the system. Typically the remote system dialing in will request that it be told what its IPv4 address is. By specifying ALWRMTOVR(*YES), you tell remote clients what their IP address should be, but also allow other remote clients to specify their own address without the need for an additional profile or resource.

Add default route (ADDDFTRTE)

Specifies whether you want a default route added when this Point-to-Point Connection profile is started. This parameter is only in effect if OPRMODE(*DIAL) is specified.

*NO

A default route will NOT be automatically added.

*YES

A default route will be automatically added when this Point-to-Point profile is started. The next hop address will be the IP address of the remote system.

Wait for dial tone (DIALTONE)

Specifies whether or not the modem should wait for a dial tone before dialing out.

*WAIT

The modem will wait for a dial tone before dialing out.

*NOWAIT

The modem will dial out without waiting for a dial tone.

Examples

Example 1: Create an Answer Profile

ADDTCPPTP   CFGPRF(ANSPROFILE)  OPRMODE(*ANS)

This command will create a PPP answer profile with the following properties

• The resource will be calculated and the modem description will be determined by the resource. Assuming a 576C integrated modem is found then the '576C Internal modem' modem description will be used.
• Line description 'QPPPCMNxx' will be created, where CMNxx is the 576C resource.
• Authentication is not enabled.
• IPv4 is enabled and an existing IPv4 address on the local system will be defined as the local IPv4 address. If there is an IPv4 address associated with the local host name then this address will be used. If not, then the first local IPv4 address found for the local system will be used.
• The remote IPv4 address (address that is assigned to the remote system) will be defined as 169.254.x.x, where x.x is determined at runtime.
• IPv6 is enabled and a random interface identifier is used for IPV6CP negotiation. The system will attempt to negotiate an IPv6 interface identifier, and if successful, will use the interface identifier to autoconfigure an IPv6 link-local unicast address for this link.
• Since IPv6 datagram forwarding is not enabled, the remote system on this link must obtain a global address using a stafeful address assignment method such as DHCPv6.

Example 2: Create a Dial Profile

ADDTCPPTP   CFGPRF(DIALPROF)  OPRMODE(*DIAL)  RSRCNAME(CMN14)
            MODEM('2805 Internal Modem')  DIALTONE(*WAIT)
            CALLNBR('9,,555-1212')
            ENBPPPAUT(*YES)
            PPPAUT(((dialuser dialpw)) *ENCRYPTED *CFGPRF)
            FULLMASQ(*YES)

This command will create a PPP dial profile with the following properties:

• The profile will use a PPP line named 'QPPPCMN14', defined to use communication resource CMN14.
• The 2805 internal modem will be used (Modem name as seen in CFGTCPPTP, option 11).
• When calling the remote system, the system will wait to detect a dial tone before dialing. After dial tone is detected, a '9' will be dialed first (possibly to reach an outside line), then there will a 2 second delay (approximately), then telephone number '555-1212' will be dialed.
• Authentication is enabled and an authentication protocol using encryption will be used (EAP - extended authentication protocol or CHAP - Challenge authentication protocol (MD-5)). The user name and password defined will be used for authentication.
• The local and remote IP addresses will be defined as *DYNAMIC, which means the addresses will be defined by the remote system during the IPCP (Internet Protocol Control Protocol) negotiation phase of the PPP connection.
• All IPv4 traffic going out the PPP link will appear as if it originated from the local system's PPP IPv4 address.
• IPv6 is enabled and a random interface identifier is used for IPV6CP negotiation. The system will attempt to negotiate an IPv6 interface identifier, and if successful, will use the interface identifier to autoconfigure an IPv6 link-local unicast address for this link.

Example 3: Create an Answer Profile Using Predefined IP Addresses

ADDTCPPTP   CFGPRF(ANSPROFILE)  OPRMODE(*ANS)  RSRCNAME(CMN10)
            MODEM('USRobotics 56K*')  LCLINTNETA('10.9.8.1')
            RMTINTNETA('10.9.8.2')  ENBPPPAUT(*YES)
            PPPAUT(((RmtID1 RmtPW1) (RmtID2 RmtPW2))
                    *ENCRYPTED PPPVLDL)
            TEXT('PPP *ANS profile')  IPDTGFWD(*YES)  IP6(*NO)

This command will create an answer PPP profile with the following properties:

• The profile will use a PPP line named 'QPPPCMN10', defined to use communication resource CMN10.
• Modem name of 'USRobotics 56K V.90 Sportster' will be used assuming it is the first modem name found starting with the string 'USRobotics 56K'. The actual modem selected will be posted to the joblog in a message.
• Authentication is enabled and an authentication protocol using encryption will be used (EAP - extended authentication protocol or CHAP - Challenge authentication protocol (MD-5)). Both user RmtID1 and RmtID2 are authorized to connect using this profile.
• Validation list PPPVLDL in library QUSRSYS will be used to store the user names and passwords.
• The local IP address will be 10.9.8.1 and the remote IP address will be 10.9.8.2. The 10.9.8.1 local address is an existing IP address on the system and is attached to the 10.9.8.0 network.
• The remote system will be allowed to directly access the 10.9.8.0 network.
• IPv6 is not enabled for this link.

Example 4: Create a Dial Profile Using Predefined IPv4 Addresses and IPv6 Stateless Autoconfiguration

ADDTCPPTP   CFGPRF(DIALPROF)  OPRMODE(*DIAL)  RSRCNAME(CMN11)
            CALLNBR('9,,555-1212') IP4(*YES)
            LCLINTNETA('10.9.8.1')  RMTINTNETA('10.9.8.2')
            IP6(*YES)  IFCID(*GEN)  ACPDFTRTE(*YES)

This command will create a PPP dial profile with the following properties:

• The profile will use a PPP line named 'QPPPCMN11', defined to use communication resource CMN11.
• A 2805 internal modem will be used (Modem name as seen in CFGTCPPTP, option 11).
• When calling the remote system, a '9' will be dialed first (possibly to reach an outside line), then there will a 1 second delay (approximately), then telephone number '555-1212' will be called.
• Authentication is not enabled.
• IPv4 is enabled on the link.
• The local IPv4 address will be 10.9.8.1 and the remote IPv4 address will be 10.9.8.2. The 10.9.8.1 local address is an existing IP address on the system and is attached to the 10.9.8.0 network.
• The remote system will be allowed to directly access the 10.9.8.0 network.
• IPv6 is enabled on the link.
• A random IPv6 interface identifier will be generated and used for IPV6CP negotiation.
• The local system will accept a default route if it is received in a Router Advertisement packet.

Example 5: Create an Answer Profile Using Predefined IPv4 Addresses and IPv6 Stateless Autoconfiguration

ADDTCPPTP   CFGPRF(ANSPROF)  OPRMODE(*ANS)  RSRCNAME(CMN11)
            IP4(*YES)  LCLINTNETA('10.9.8.1')  RMTINTNETA('10.9.8.2')
            IP6(*YES)  IFCID(*GEN)  IP6DTGFWD(*YES)
            ADRPFX('2001:db8::')

This command will create a PPP answer profile with the following properties:

• The profile will use a PPP line named 'QPPPCMN11', defined to use communication resource CMN11.
• A 2805 internal modem will be used (Modem name as seen in CFGTCPPTP, option 11).
• When calling the remote system, a '9' will be dialed first (possibly to reach an outside line), then there will a 1 second delay (approximately), then telephone number '555-1212' will be called.
• Authentication is not enabled.
• IPv4 is enabled on the link.
• The local IPv4 address will be 10.9.8.1 and the remote IPv4 address will be 10.9.8.2. The 10.9.8.1 local address is an existing IP address on the system and is attached to the 10.9.8.0 network.
• The remote system will be allowed to directly access the 10.9.8.0 network.
• IPv6 is enabled on the link.
• A random IPv6 interface identifier will be generated and used for IPV6CP negotiation.
• Forwarding of IPv6 datagrams is allowed. This also means that the local system will act as a router, and send the configured IPv6 address prefix and a default route in Router Advertisement messages. The local system will also respond to a Router Solicit message with a unicast Router Advertisement message.

Error messages

*ESCAPE Messages

TCP83D0

Point-to-point profile &1 not added.