Create Line Desc (PPP) (CRTLINPPP)

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, SC41-5401.

Start of change

Notes:

End of change

Restriction: You must have input/output system configuration (*IOSYSCFG) special authority to use this command.

Parameters

Keyword Description Choices Notes
LIND Line description Name Required, Key, Positional 1
RSRCNAME Resource name Name, *ETHDEVSVR Required, Key, Positional 2
CNN Connection type *SWTPP, *NONSWTPP, *NONSWTCAL, *NONSWTANS Optional, Key
FRAMING Framing type *ASYNC, *SYNC Optional
INTERFACE Physical interface Character value, *RS232V24, *RS449V36, *V35, *X21, *INTMODEM Optional
ONLINE Online at IPL *NO, *YES Optional
VRYWAIT Vary on wait 15-180, *NOWAIT Optional
LINESPEED Line speed Character value, 115200 Optional
MDMINZCMD Modem init command string Character value, *NONE Optional
MAXFRAME Maximum frame size Character value, 2048 Optional
SWTCNN Switched connection type Character value, *BOTH, *ANS, *DIAL Optional
CLOCK Clocking *MODEM, *INVERT, *LOOP Optional
DIALCMD Dial command type Character value, *ATCMD, *V25BIS Optional
SETMDMASC Set modem to ASYNC command Character value, *NONE, END Optional
CALLNBR Calling number Character value, *NONE Optional
RMTINTNETA Remote internet address Character value Optional
RMTPORT Remote port 1-65535 Optional
FLOWCNTL Flow control Character value, *HARDWARE, *NO Optional
NETCTL Network controller Name Optional
CTSTMR Clear To Send timer 10-60, 25 Optional
INACTTMR Inactivity timer Character value, *NOMAX Optional
RMTANSTMR Remote answer timer Character value, 60 Optional
NRZI NRZI data encoding *YES, *NO Optional
TEXT Text 'description' Character value, *BLANK Optional
ACCM Async control character map Hexadecimal value, 00000000 Optional
LCPAUT LCP authentication values Element list Optional
Element 1: Remote peer challenge timer Integer, *NONE
Element 2: Max authentication attempts 1-255, 5
LCPCFG LCP configuration values Element list Optional
Element 1: Configuration retry timer 0.1-60.0, 3.0
Element 2: Max configuration failures 1-255, 5
Element 3: Max configuration requests 1-255, 10
Element 4: Max terminatation requests 1-255, 2
COMPRESS Compression Character value, *STACLZS, *NONE Optional
CMNRCYLMT Recovery limits Single values: *SYSVAL
Other values: Element list
Optional
Element 1: Count limit 0-99, 2
Element 2: Time interval 0-120, 5
MSGQ Message queue Single values: *SYSVAL, *SYSOPR
Other values: Qualified object name
Optional
Qualifier 1: Message queue Name
Qualifier 2: Library Name
AUT Authority Name, *CHANGE, *ALL, *USE, *EXCLUDE, *LIBCRTAUT Optional

Line description (LIND)

Start of change

Specifies the name of the line description.End of change

This is a required parameter.

Resource name (RSRCNAME)

Specifies the resource name that identifies the hardware this description represents. Use the WRKHDWRSC command to determine the resource name if this line description does not use an external Ethernet device server.

*ETHDEVSVR
This line description uses an external Ethernet device server which supports RFC 2217. These servers are sometimes known as Ethernet serial servers or Ethernet terminal servers.
name
Specify the resource name of the communications port.

Connection type (CNN)

Specifies the type of line connection used.

Start of changeNote: *NONSWTCAL and *NONSWTANS valid only when INTERFACE(*INTMODEM).End of change

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

Framing type (FRAMING)

Specifies whether the line uses asynchronous or synchronous framing.

*ASYNC
Asynchronous frames are used.
*SYNC
Synchronous frames are used.

Physical interface (INTERFACE)

Specifies the type of physical interface on the input/output adapter (IOA) port.

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

Online at IPL (ONLINE)

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

*YES
The line is automatically varied on at initial program load (IPL).
*NO
This line is not automatically varied on at IPL.

Vary on wait (VRYWAIT)

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

*NOWAIT
The system does not wait for vary on completion. 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.

Line speed (LINESPEED)

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

9600
9600 bps is used.
line-speed
Specify the line speeds. Valid lines speeds are: 600, 1200, 2400 4800, 7200, 9600, 14400, 19200, 48000, 56000, 57600, 64000, 112000, 128000, 168000, 192000, 224000, 256000, 280000, 320000, 336000, 384000, 392000, 448000, 504000, 512000, 560000, 576000, 616000, 640000, 672000, 704000, 728000, 768000, 784000, 832000, 840000, 896000, 952000, 960000, 1008000, 1024000, 1064000, 1088000, 1120000, 1152000, 1176000, 1216000, 1232000, 1280000, 1288000, 1344000, 1400000, 1408000, 1456000, 1472000, 1512000, 1536000, 1568000, 1600000, 1624000, 1664000, 1680000, 1728000, 1736000, 1792000, 1856000, 1920000, 1984000, or 2048000 bits per second.

Modem init command string (MDMINZCMD)

Specifies the modem initialization command string sent to set the modem

Start of changeNote: Valid only when INTERFACE(*INTMODEM)End of change

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

    Period
    Less than sign
    Left parenthesis
    Plus sign
    Ampersand
    Asterisk
    Right parenthesis
    Semicolon
    Minus sign
    Slash
    Comma
    Underline
    Greater than sign
    Question mark
    Colon
    Equal sign
    Spaces
    Number sign
    Double quote
    Exclamation point
    At sign
    Hat symbol
    Percent
    Left square bracket
    Right square bracket
    Back slash

Note: The modem initialization string must begin with the two characters 'AT'.

Maximum frame size (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.

Switched connection type (SWTCNN)

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

*BOTH
The line is used for both incoming and outgoing calls.
*ANS
The line is used for incoming calls only.
*DIAL
The line is used for outgoing calls only.

Clocking (CLOCK)

Specifies how the clocking function for the line is provided.

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

Dial command type (DIALCMD)

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

*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

Set modem to ASYNC command (SETMDMASC)

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

*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, you should 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:
.
Period
<
Less than sign
(
Left parenthesis
+
Plus sign
&
Ampersand
*
Asterisk
)
Right parenthesis
;
Semicolon
-
Minus sign
/
Slash
,
Comma
_
Underline
>
Greater than sign
?
Question mark
:
Colon
=
Equal sign

Calling number (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.

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

Remote internet address (RMTINTNETA)

Specifies the internet address of the Ethernet device server.

Note: This parameter is required when *ETHDEVSVR is specified for the resource name (RSRCNAME) parameter.

character-value
Specify the internet address of the Ethernet device server.

An IPv4 internet address is specified in the form, nnn.nnn.nnn.nnn, where nnn is a decimal number ranging from 0 through 255. Leading zeros in each part of the dotted decimal internet address are invalid and will be removed. An internet address is not valid if it has a value of all binary ones or zeros for the network identifier (ID) or host portion of the address. If the internet address is entered from the command line, the address must be enclosed in apostrophes.

An IPv6 internet address is specified in the form x:x:x:x:x:x:x:x, where x is a hexadecimal number ranging from 0 through X'FFFF'. "::" may be used once in the IPv6 address 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. An IPv6 internet address must be a unicast address and must not contain an imbedded IPv4 address (compatibility or mapped).

Remote port (RMTPORT)

Specifies the remote port for the TCP/IP connection to the Ethernet device server.

Note: This parameter is required when *ETHDEVSVR is specified for the resource name (RSRCNAME) parameter.

port-number
Specify a value ranging from 1 through 65535.

Flow control (FLOWCNTL)

Specifies whether the system controls the data flow.

*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.
*HARDWARE
Hardware flow control is performed using the Request to Send (RTS) and Clear To Send (CTS) flow control signals.

Network controller (NETCTL)

Specifies the name of an existing network controller.

Clear To Send timer (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.

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.

Inactivity timer (INACTTMR)

Specifies the time (in seconds) that the system waits for activity on a switched line before disconnecting.

*NOMAX
The inactivity timer is disabled.
timer-value
Specify a value ranging from 15 through 65535 seconds.

Remote answer timer (RMTANSTMR)

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

60
The system waits 60 seconds before signaling an error.
timer-value
Specify a value ranging from 30 through 120 seconds.

NRZI data encoding (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.
*YES
NRZI data encoding is used.
*NO
NRZI data encoding is not used.

Text 'description' (TEXT)

Specifies text that briefly describes the line description.

*BLANK
Text is not specified.
character-value
Specify no more than 50 characters of text, enclosed in apostrophes.

Async control character map (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.

Host system 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 host system as a 2-byte escape sequence. Any characters specified in this map that are not escaped are discarded by host system.

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.

LCP authentication values (LCPAUT)

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

The Remote peer challenge timer value 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.

The Maximum authentication attempts value 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 host system 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 host system responds when a peer fails authentication. Host system always terminates communication without any retry if a response from the remote peer fails authentication.
5
If the remote peer does not respond after host system has sent five authentication challenges, host system terminates communication.
maximum-number-of-attempts
Specifies the maximum number of unacknowledged challenges sent to a remote peer before communication is terminated.

LCP configuration values (LCPCFG)

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

Attention:

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.

The Configuration retry timer value specifies the interval, in seconds, that host system 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.

The Maximum configuration failures value 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, host system terminates communication.
maximum-number-of-attempts
Specifies the maximum number of attempts made to negotiate a mutually acceptable configuration.

The Maximum configuration requests value specifies the maximum number of unacknowledged configuration requests sent to a remote peer before assuming that the peer is unable to respond.

10
If host system transmits ten configuration requests to the remote peer but does not receive a response, host system terminates communication.
maximum-number-of-attempts
Specifies the maximum number configuration attempts made before host system terminates communication.

The Maximum termination requests value 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, host system terminates communication immediately.
maximum-number-of-attempts
Specifies the maximum number of attempts made to notify the remote peer that communication will be terminated.

Compression (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 the local system and the remote peer system connects to agree to use the specified compression protocol.

*STACLZS
Host system is allowed to negotiate the use of STAC LZS data compression.
*NONE
Host system is not allowed to negotiate or use any Point-to-Point Compression protocol.

Recovery limits (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.

The possible Maximum Recovery Limit values are:

2
Two recovery attempts are made within the specified time interval.
count-limit
Specify the number of recovery attempts to be made. Valid values range from 0 through 99.

The possible Recovery Time Interval values are:

5
The specified number of recovery attempts is made within a 5-minute interval.
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, then the value 0 specifies infinite recovery.

The possible Other Single Value: is:

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

Message queue (MSGQ)

Specifies the message queue to which operational messages are sent.

*SYSVAL
The value in the system value QCFGMSGQ is used.
*SYSOPR
Messages are sent to the system operator message queue (QSYS/QSYSOPR).

Qualifier 1: Message queue

name
Specify the name of the message queue to which operational messages are sent.

Qualifier 2: Library

name
Specify the name of the library where the message queue is located.

Authority (AUT)

Specifies the authority you are giving to users who do not have specific authority for the object, who are not on an authorization list, and whose group profile or supplemental group profiles do not have specific authority for the object.

*CHANGE
The user can perform all operations on the object except those limited to the owner or controlled by object existence (*OBJEXIST) and object management (*OBJMGT) authorities. The user can change and perform basic functions on the object. *CHANGE authority provides object operational (*OBJOPR) authority and all data authority. If the object is an authorization list, the user cannot add, change, or remove users.
*ALL
The user can perform all operations except those limited to the owner or controlled by authorization list management (*AUTLMGT) 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 object.
*USE
The user can perform basic operations on the object, such as running a program or reading a file. The user cannot change the object. Use (*USE) authority provides object operational (*OBJOPR), read (*READ), and execute (*EXECUTE) authorities.
*EXCLUDE
The user cannot access the object.
*LIBCRTAUT
The system determines the authority for the object by using the value specified for the Create authority (CRTAUT) parameter on the Create Library (CRTLIB) command for the library containing the object to be created. If the value specified for the CRTAUT parameter is changed, the new value will not affect any existing objects.
name
Specify the name of an authorization list to be used for authority to the object. Users included in the authorization list are granted authority to the object as specified in the list. The authorization list must exist when the object is created.

Examples

Example 1: Create a PPP Line Description

CRTLINPPP   LIND(PPP01)  RSRCNAME(LIN031)

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

Example 2: Create a PPP Line Description Using an Ethernet Device Server

CRTLINPPP LIND(PPPEDSVR) RSRCNAME(*ETHDEVSVR)
          RMTINTNETA('fe80::1234') RMTPORT(6025)

This command creates an PPP line description named PPPEDSVR which uses an Ethernet device server. The IPv6 address of the Ethernet device server is fe80::1234, and the port for the connection to the server is 6025.

Error messages

*ESCAPE Messages

CPF261E
Line description &1 not created due to errors.