CL Command Reference - ADDTCPPTP
CL Command List > ADDTCPPTP Reference
Description:
The Add Point-to-Point TCP/IP 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 iSeries Navigator, since it supports all features of PPP. In cases where it is not feasible to create a point-to-point profile using iSeries 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.
Examples:
Example 1: Create an Answer Profile
ADDTCPPTP CFGPRF(ANSPROFILE) OPRMODE(*ANS)
This command will create answer PPP profile with the following properties
. The resource will be calculated and the modem description will be determined by the resource. Assuming a 2771 integrated modem is found then the ¡¯2771 Internal modem¡¯ modem description will be used.
. Line description ¡¯QPPPCMNxx¡¯ will be created, where CMNxx is the 2771 resource.
. An existing IP address on the local system will be defined as the local IP address. If there is an IP address associated with the local host name then this address will be used. If not, then the first local IP address found for the local system will be used.
. The remote IP address (address that is assigned to the remote system) will be defined as 169.254.x.x, where x.x is determined at runtime.
. Authentication is not enabled.
Example 2: Create a PPP Dial Profile
ADDTCPPTP CFGPRF(DIALPROF) OPRMODE(*DIAL) RSRCNAME(CMN14)
MODEM(¡¯2761 Internal Modem¡¯) CALLNBR(¡¯1,,9876543¡¯)
ENBPPPAUT(*YES)
PPPAUT(((dialuser dialpw)) *ENCRYPTED *CFGPRF)
FULLMASQ(*YES)
This command will create a dial PPP profile with the following properties:
. The profile will use a PPP line named ¡¯QPPPCMN14¡¯, defined to use communication resource CMN14.
. The 2761 internal modem will be used (Modem name as seen in CFGTCPPTP, option 11).
. When calling the remote system, a ¡¯1¡¯ will be dialed first (possibly to reach an outside line), then there will a 2 second delay (approximately), then telephone number ¡¯9875432¡¯ will be called.
. 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 IP traffic going out the PPP link will appear as if it originated from the local system¡¯s PPP IP address.
Example 3: Create 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)
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.