CRTLINPPP (Create Line Description (PPP))

CRTLINPPP Command syntax diagram

 

Purpose

The Create Line Description (Point-to-Point Protocol (PPP)) (CRTLINPPP) command creates a line description for a PPP line. More information about using this command is in the Communications Configuration book.

Restriction: You must have *IOSYSCFG special authority to use this command.

 

Required Parameters

LIND
Specifies the name of the line description being created.

RSRCNAME
Specifies the resource name that identifies the hardware that the description represents.

*NWID: The resource name specified on the attached network interface description is used.

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

 

Optional Parameters

FRAMING
Specifies whether the line uses asynchronous or synchronous framing.

Note: Not valid when RSRCNAME(*NWID).

*ASYNC: Asynchronous frames are used.

*SYNC: Synchronous frames are used.

CNN
Specifies the type of line connection used.

Note: *NONSWTCAL and *NONSWTANS valid only when INTERFACE(*INTMODEM), or INFTRFTYPE *FAXMODEM, *ASYNCMODEM or *SYNCMODEM.

*SWTPP: A switched point-to-point line is used.

*NONSWTPP: A nonswitched point-to-point line is used.

*NONSWTCAL: A nonswitched point-to-point line is used for call mode.

*NONSWTANS: A nonswitched point-to-point line is used for answer mode.

NWI
Specifies, for a nonswitched connection, the network interface description containing the channel to which this line permanently attaches.

Note: Valid only when RSRCNAME(*NWID) and CNN is not *SWTPP.

INTERFACE
Specifies the type of physical interface on the IOA port.

Note: Not valid when RSRCNAME(*NWID).

*RS232V24: The RS232/V.24 interface is used.

*RS449V36: The RS449/V.36 interface is used.

*X35: The X.35 interface is used.

*X21: The X.21 interface is used.

*INTMODEM: The integrated modem interface is used.

NWICHLNBR
Specifies, for a nonswitched connection, the channel number (1 through 30) of the network interface description that is used by this line description. 2, 23 or 30 channels are available for each network interface description, depending on whether the network interface is basic or primary rate and what the network type is, but only one line description can be permanently attached to a channel. The Display Network Interface Description (DSPNWID) command is used to display information about the channel numbers for a given NWID.

Note: Valid only when RSRCNAME(*NWID) and CNN(*NONSWTPP), CNN(*NONSWTCAL) or CNN(*NONSWTANS).

SWTNWILST
Specifies, for ISDN/T1 switched connections, a list of network interface descriptions to which this line can be attached. A network interface description is chosen from the list based on the value specified by the switched NWI selection parameter (SWTNWISLCT) at the time an incoming or outgoing call is processed.

Note: Valid only when RSRCNAME(*NWID) and CNN(*SWTPP).

*NONE: No network interface description is specified.

Element 1: Network Interface Description Name

NWI-description-name: Specify, for switched connections, the name of the network interface description to which this line attaches.

Element 2: Network Interface Channel Type

*B: The B channel is used.

Element 3: Network Interface Channel-Number

*CALC: The system selects one of the channel numbers (based on availability) defined for the network interface description when an incoming or outgoing call is processed.

NWI-channel-number: Specify a channel number (1 to 23). Specifying a channel number restricts the line description to that channel.

ONLINE
Specifies whether this object is automatically varied on at initial program load (IPL).

*NO: This line is not automatically varied on at IPL.

*YES: The line is automatically varied on at IPL.

VRYWAIT
Specifies whether the line is varied on asynchronously or synchronously. For a synchronous vary on, this parameter specifies how long the system waits for the vary on to complete.

Note: Valid only when CNN(*SWTPP).

*NOWAIT: The system does not wait for the vary on to complete. The line is varied on asynchronously.

vary-on-wait: Specify the time (in seconds) to wait. Valid values range from 15 through 180. The system waits until the line is varied on, or until the specified time passes, before completing the Vary Configuration (VRYCFG) command.

 

Notes

  1. When ONLINE(*YES) is used, specifying a wait time in the line description affects system IPL time. In such cases, system IPL time is influenced by the amount of time required to synchronously vary on the line or reach the wait-time value.

  2. The time required to vary on a line is the time it takes to:

    • Put tasks in place to manage the line

    • Activate the communications I/O processor (IOP), including downloading the IOP model-unique Licensed Internal Code

    • Establish the communications tasks and processes

    Normal vary-on time ranges from 5 through 45 seconds, but can be longer, depending on the system, line protocol, and other factors.

LINESPEED
Specifies the line speed in bits per second (bps).

115200: The default value is 115200 bps.

line-speed: Specify the line speed (bps). Valid lines speeds range from 9600 to 2048000 bits per second for FRAMING(*SYNC). For FRAMING(*ASYNC), the valid values are 9600, 19200, 38400, 57600, and 115200 with INTERFACE(*RS232V24). With FRAMING(*ASYNC) and an interface value of *V35 or *RS449V36, line speeds of 157600 and 230400 may be specified.

INFTRFTYPE
Specifies the information transfer type. The information transfer type determines the layer 1 protocol.

Note: Valid only when RSRCNAME(*NWID) and CNN is not *SWTPP.

*UNRESTRICTED: The data-channel traffic appears as digital information; no physical transformation is required and each B-channel operates at capacity (64k bps).

*V110: The transfer type is V-series Recommendation 110. Each B-channel operates at 56k bps.

*DOV Allows Data Over Voice (DOV) digital data to be transferred over an ISDN voice call. Also, this is referred to as Data Over Voice Bearer Service (DOVBS), Data Over Speech Bearer Service (DOSBS), TollSaver, or TollMizer. This option should only be used if an ISDN voice call is less expensive than an ISDN data call or if a bearer service for data is not available. The remote location must also support this feature. Data is transferred at 56Kbps in each direction.

*FAXMODEM: Allows Facsimile (FAX) data from the integrated fax modem to be transferred over an ISDN voice call. This option should be used to connect to a remote location that is using a fax device on an analog telephone line or to another ISDN device that has Group 3 FAX modem capabilities. Data is transferred at fax speeds up to 14.4Kbps.

*ASYNCMODEM: Allows data from the integrated asynchronous modem to be transferred over an ISDN voice call. This option should be used to connect to a remote location that is using an asynchronous modem on an analog telephone line. Data is transferred at modem speeds up to 33.6Kbps from the remote analog device to this digital connection and up to 56Kbps from this digital connection to the remote analog device.

*SYNCMODEM: Allows data from the integrated synchronous modem to be transferred over an ISDN voice call. This option should be used to connect to a remote location that is using a synchronous modem on an analog telephone line. Data is transferred at modem speeds up to 33.6Kbps from the remote analog device to this digital connection and up to 56Kbps from this digital connection to the remote analog device.

MDMINZCMD
Specifies the command string to send to set the modem.

Note: Valid only when INTERFACE(*INTMODEM) or INFTRFTYPE *FAXMODEM, *ASYNCMODEM and *SYNCMODEM.

*NONE: No command string is sent to the modem.

command-string: Specifies up to 60 characters that represent the command string sent to the modem. Valid characters are upper case A thru Z, lower case a thru z, numbers 0 thru 9, and special characters:

Table 1. Special characters

Character Description
. Period
< Less than sign
( Left parenthesis
+ Plus sign
& Ampersand
* Asterisk
) Right parenthesis
; Semicolon
- Minus sign
/ Slash
, Comma
_ Underline
> Greater than sign
? Question mark
: Colon
= Equals sign

Spaces
# Number sign
" Double quote
! Exclamation point
@ At sign
^ Hat symbol
% Percent
[ Left square bracket
] Right square bracket
\ Back slash
$ Dollar sign

Note: The first two characters of the modem initialization command string must begin with 'AT'. These first two characters must be in uppercase.

MAXFRAME
Specifies the maximum length for the information field in a PPP frame, including padding, but not including the protocol field. It is also known as the Maximum Receive Unit (MRU). By negotiation, consenting PPP implementations may use other values for the MRU.

2048: The maximum frame size is 2048 bytes.

maximum-frame-size: Specify the maximum frame size (in bytes). Valid maximum frame sizes range from 1500 to 4096 bytes.

SWTCNN
Specifies, for the switched line, whether the line is used for incoming calls, outgoing calls, or both incoming and outgoing calls.

Note: Valid only when CNN(*SWTPP).

*BOTH: The line is used for both incoming and outgoing calls.

*ANS: The line is used for incoming calls only.

*DIAL: The local system starts the call.

SWTNWISLCT
Specifies the method used to select network interfaces from the switched network interface list.

Note: Valid only when RSRCNAME(*NWID) and CNN(*SWTPP).

*FIRST: Selection begins with the first network interface specified in the switched network interface list.

*CALC: The system calculates which network interface is selected.

CNNLSTOUT
Specifies, for ISDN/T1 switched connections, the name of a connection list object that contains the ISDN/T1 assigned numbers for a dial-out operation to the ISDN/T1.

Note: Valid only when RSRCNAME(*NWID) and CNN(*SWTPP).

connection-list-name: Specify the name of the connection list for dial out operations.

CNNLSTOUTE
Specifies, for ISDN/T1 switched connections, the entry name from the connection list used to make a call to the ISDN/T1. The connection list must be specified on the CNNLSTOUT parameter.

Note: Valid only when RSRCNAME(*NWID) and CNN(*SWTPP).

connection-list-name: Specify the entry name of the connection list for dial out operations.

CNNLSTIN
Specifies for ISDN/T1 switched connections the name of the connection list that is used to retrieve call information (or connection) for identifying authorized incoming calls.

Note: Valid only when RSRCNAME(*NWID) and CNN(*SWTPP).

*NETATR: The connection list used by this line description is taken from the list of system default network attributes that were identified at IPL (Initial Program Load). The Display Network Attributes (DSPNETA) command can be used to see the name of the connection list.

connection-list-name: Specify the name of the connection list used for this line description.

MSGQ
Specifies the qualified name of the message queue to which messages are sent. More information about using this parameter is in the Communications Management Link to PDF book.

Single Values

*SYSVAL: Messages are sent to the message queue defined in the system value QCFGMSGQ.

*SYSOPR: Messages are sent to the system operator message queue (QSYS/QSYSOPR).

library-name/message-queue-name: Specify the library-qualified name of the message queue to which operational messages are sent.

CLOCK
Specifies how the clocking function for the line is provided.

Note: Not valid when RSRCNAME(*NWID) or INTERFACE(*INTMODEM).

*MODEM: The modem supplies the clocking function.

*LOOP: The receiving clock provided by the modem data circuit-terminating equipment (DCE) is looped back to the modem (DCE) on the system data terminal equipment (DTE) transmitting clock. This option can be used to improve high speed data transmission when the modem (DCE) supports such an option. The valid interfaces for *LOOP are *V35, *X21BISV35, and *RS449V36.

*INVERT: The transmit clock provided by the modem data circuit-terminating equipment (DCE) is inverted before use. This option can be used when having problems with high speed data transmission and the modem (DCE) does not support looped clocking. The valid interfaces for *INVERT are *V35, *X21, *X21BISV35, and *RS449V36.

DIALCMD
Specifies the type of dial command used to establish a switched connection with a remote system.

Note: Not valid when RSRCNAME(*NWID).

*ATCMD: The Attention (AT) command set (sometimes referred to as the Hayes command set) is a group of modem commands that allow an application program to control the modem while it is operating asynchronously. The application program must place all AT commands directly into the data stream. The AT commands supported are dependent on the specific modem being used.

*V25BIS: Uses the International Telecommunication Union - Telecommunication (ITU-T) (formerly known as CCITT) V.25 bis standard for serial automatic calling.

SETMDMASC
Specifies the ASCII V.25 bis command string to send to the modem to set the modem to ASYNC mode.

Note: Not valid when RSRCNAME(*NWID) or INTERFACE(*INTMODEM).

*NONE: No V.25 bis command string is sent to the modem.

END: The END command string is generally used as the command to set most modems to ASYNC mode. For cases that do not use the END command string, enter the command string appropriate for that modem to set it to ASYNC mode.

command-string: Specifies up to 40 characters that represent the command string sent to the modem. Valid characters are upper case A thru Z, lower case a thru z, numbers 0 thru 9, and special characters:

Table 2. Special characters

Character Description
. Period
< Less than sign
( Left parenthesis
+ Plus sign
& Ampersand
* Asterisk
) Right parenthesis
; Semicolon
- Minus sign
/ Slash
, Comma
_ Underline
> Greater than sign
? Question mark
: Colon
= Equals sign

CALLNBR
Specifies the local telephone number of the line used for the V.25 bis call request with identification (CRI) dial command. This parameter is used when the CRI function is needed for V.25 bis. When V.25 bis CRI dialing is used, the system takes the called (connection) number from the CNNNBR parameter of the controller description, adds a separator character (;), and concatenates the calling number at the end. Specify the calling number only if the modem and the network both support the CRI dial command.

Note: Not valid when RSRCNAME(*NWID) and CNN(*NONSWTPP), CNN(*NONSWTCAL) or CNN(*NONSWTANS).

*NONE: The Call Request Normal (CRN) dial command is used by the V.25 bis line.

calling-number: Specify up to 32 characters that represent the local telephone number for V.25 bis CRI auto-dialing.

FLOWCNTL
Specifies whether the system controls the data flow.

Note: Only valid when FRAMING(*ASYNC).

*HARDWARE: Hardware flow control is performed using the Request to Send (RTS) and Clear To Send (CTS) flow control signals.

*NO: Prevents the hardware from generating or recognizing flow control characters, and prevents the use of Request To Send (RTS) and Clear To Send (CTS) flow control signals.

NETCTL
Specifies the name of an existing network controller to which this line is attached.

CTSTMR
Specifies the amount of time the system waits for the modem to enter or exit the Clear to Send (CTS) state before signaling an error.

Note: Not valid when RSRCNAME(*NWID) or INTERFACE(*INTMODEM).

25: The system waits up to 25 seconds for the CTS state to begin or end.

timer-value: Specify a value ranging from 10 through 60 seconds.

INACTTMR
Specifies the time (in seconds) that the system waits for user data activity on a switched line 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 are sent or received. LCP and NCP packets do not cause this timer to be restarted.

*NOMAX: The inactivity timer is disabled.

timer-value: Specify a value ranging from 15 through 65535 seconds.

RMTANSTMR
Specifies the amount of time the system waits for the modem to enter the DSR state after dialing before signaling an error.

Note: Not valid when RSRCNAME(*NWID) and CNN(*NONSWTPP), CNN(*NONSWTCAL) or CNN(*NONSWTANS).

60: The system waits 60 seconds before signaling an error.

timer-value: Specify a value ranging from 30 through 120 seconds.

NRZI
Specifies whether non-return-to-zero-inverted (NRZI) data encoding is used for modems that are sensitive to certain bit patterns in the data stream. This ensures that the signal does not remain the same for an extended period of time. For digital phone lines, *NO is suggested.

 

Notes

  1. All data communications equipment on the line must use the same data transmission coding method.

  2. Framing (FRAMING parameter) must be *SYNC to use NRZI data encoding.

*NO: NRZI data encoding is not used.

*YES: NRZI data encoding is used.

TEXT
Specifies the text that briefly describes the line description. More information on this parameter is in Commonly used parameters.

*BLANK: Text is not specified.

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

ACCM
Specifies a mapping for control characters in the transmitted data that may be either removed or introduced by data communications equipment on the line.

Note: ACCM(00000000) must be specified unless FRAMING(*ASYNC) is specified.

The iSeries 400 sends all characters specified by this map to the remote peer as a 2-byte escape sequence. Additionally, all characters specified by this map must be sent by the remote peer to iSeries 400 as a 2-byte escape sequence. Any characters specified in this map that are not escaped are discarded by iSeries 400.

ATTENTION:

The default value for this parameter does not normally need to be changed. Do not specify a different value for this parameter unless you are fully aware of the effect of the change.

00000000: No ASCII control characters between '00'X and '1F'X' are escaped.

control-character-map: Specifies a 32-bit value as a 8-digit hexadecimal number. Each bit in this 32-bit value indicates whether a character is escaped or not. If the bit value is set to 1, the corresponding character is escaped. If the bit is set to 0, the control character is not escaped.

The ordinal number of a bit in the 32-bit value determines the character affected. The leftmost bit (number 0) corresponds to the character '00'X. The rightmost bit (number 31) corresponds to the character '1F'X. For example,

  • Specifying ACCM(80000000) requires character '00'X be sent and received as the 2-byte escape sequence '7D20'X. Characters '01'X to '1F'X are not mapped.

  • Specifying ACCM(00000001) requires character '1F'X be sent and received as the 2-byte escape sequence '7D3F'X. Characters '00'X to '1E'X are not mapped.

  • Specifying ACCM(0000A000) requires characters '11'X and '13'X be sent and received as the 2-byte escape sequence '7D31'X and '7D33'X, respectively.


LCPAUT
Specifies values controlling how the Link Control Protocol layer of iSeries 400 PPP authenticates a remote peer.

Element 1: Remote peer challenge timer

Specifies the interval, in minutes, to periodically issue an authentication challenge to the remote peer.

*NONE: The remote peer is authenticated only once when the PPP link is initially opened. No additional authentication challenges are issued.

challenge-interval: Specify the interval, in minutes, to re-validate the remote peer's authentication.

Element 2: Maximum authentication attempts

Specifies the maximum number of unacknowledged authentication challenges sent to a remote peer before assuming that the peer is unable to respond.

 

Notes

  1. A challenge is considered unacknowledged when iSeries 400 does not receive a response within the interval specified by the configuration retry timer (element 1 of parameter LCPCFG).

  2. This value does not affect how iSeries 400 responds when a peer fails authentication. iSeries 400 always terminates communication without any retry if a response from the remote peer fails authentication.

5: If the remote peer does not respond after iSeries 400 has sent five authentication challenges, iSeries 400 terminates communication.

maximum-number-of-attempts: Specifies the maximum number of unacknowledged challenges sent to a remote peer before communication is terminated.

LCPCFG
Specifies values controlling how the Link Control Protocol layer of iSeries 400 PPP negotiates mutually acceptable link configuration values with a remote peer.

Warning: The default values for this parameter do not normally need to be changed. Do not specify different values for this parameter unless you are fully aware of the effect of the change.

Element 1: Configuration retry timer

Specifies the interval, in seconds, that iSeries 400 waits before resending an unacknowledged configuration, termination, or authentication challenge request to a remote peer.

3.0: Unacknowledged configuration requests are resent every 3 seconds.

retry-interval: Specify the time interval after which unacknowledged requests are resent.

Element 2: Maximum configuration failures

Specifies the maximum number of attempts that are made to negotiate a mutually acceptable configuration with a remote peer before assuming that configuration is not converging.

5: If the configuration does not converge after 5 attempts, iSeries 400 terminates communication.

maximum-number-of-attempts: Specifies the maximum number of attempts made to negotiate a mutually acceptable configuration.

Element 3: Maximum configuration requests

Specifies the maximum number of unacknowledged configuration requests sent to a remote peer before assuming that the peer is unable to respond.

10: If iSeries 400 transmits ten configuration requests to the remote peer but does not receive a response, iSeries 400 terminates communication.

maximum-number-of-attempts: Specifies the maximum number configuration attempts made before iSeries 400 terminates communication.

Element 4: Maximum termination requests

Specifies the maximum number of unacknowledged termination request packets sent to a remote peer before assuming that the peer is unable to respond.

2: If no response is received after sending two termination requests, iSeries 400 terminates communication immediately.

maximum-number-of-attempts: Specifies the maximum number of attempts made to notify the remote peer that communication will be terminated.

COMPRESS
Specifies the compression function is provided.

Note: This parameter allows you to enable a compression protocol, but does not guarantee that compression will be used. Data compression will not be activated unless both iSeries 400 and the remote peer iSeries 400 connects to agree to use the specified compression protocol.

This parameter is ignored if RSRCNAME(*NWID) is not specified or when a INTERFACE is *INTMODEM, or INFTRFTYPE is *FAXMODEM or *ASYNCMODEM or *SYNCMODEM.

*STACLZS: The iSeries 400 is allowed to negotiate the use of STAC LZS data compression.

*NONE: The iSeries 400 is not allowed to negotiate or use any Point-to-Point Compression protocol.

CMNRCYLMT
Specifies the number of recovery attempts made by the system before an inquiry message is sent to the system operator. Also specifies the time (in minutes) that must elapse before the system sends an inquiry message to the system operator indicating that the recovery attempt count limit is reached.

Element 1: Maximum Recovery Limit

2: Two recovery attempts are made within the interval specified.

count-limit: Specify the number of second-level recovery attempts to be made. Valid values range from 0 through 99.

Element 2: Recovery Time Interval

5: A 15-second time-out period is used.

time-interval: Specify the time interval (in minutes) at which the specified number of second-level recoveries are attempted. Valid values range from 0 through 120. If the value specified for count-limit is not 0, the value 0 specifies infinite recovery.

Other Single Values:

*SYSVAL: The recovery limits specified in the QCMNRCYLMT system value are used.

AUT
Specifies the authority given to users who do not have specific authority to the line description, who are not on an authorization list, and whose user group has no specific authority to the line description.

*LIBCRTAUT: The authority for the object is the same as the create authority for QSYS. The create authority for QSYS can be displayed by using the Display Library Description (DSPLIBD) command. If the create authority is changed with the Change Library (CHGLIB) command, the new authority does not affect existing objects.

*CHANGE: The user can perform all operations on the object except those limited to the owner or controlled by object existence authority and object management authority. The user can change and perform basic functions on the object. Change authority provides object operational authority and all data authority.

*ALL: The user can perform all operations except those limited to the owner or controlled by authorization list management authority. The user can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object. The user also can change ownership of the line description.

*USE: The user can perform basic operations on the line description, such as running a program or reading a file. The user cannot change the line description. *USE authority provides object operational authority, read authority, and execute authority.

*EXCLUDE: The user cannot access the line description.

authorization-list-name: Specify the name of the authorization list used.

Example for CRTLINPPP 

CRTLINPPP   LIND(PPP01)  RSCRNAME(LIN031)

This command creates a PPP line description named PPP01 with a resource name of LIN031.

Error messages for CRTLINPPP

*ESCAPE Messages

None.