Create Line Desc (PPP) (CRTLINPPP)
|Where allowed to run: All environments (*ALL)
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.
- Parameters no longer supported as of V5R3M0: CNNLSTIN, CNNLSTOUT, CNNLSTOUTE, INFTRFTYPE, NWI, NWICHLNBR, SWTNWILST, SWTNWISLCT
Restriction: You must have input/output system configuration (*IOSYSCFG) special authority to use this command.
|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|
|FLOWCNTL||Flow control||Character value, *HARDWARE, *NO||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
|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
|Qualifier 1: Message queue||Name|
|Qualifier 2: Library||Name|
|AUT||Authority||Name, *CHANGE, *ALL, *USE, *EXCLUDE, *LIBCRTAUT||Optional|
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.
- 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.
- Specify the resource name of the communications port.
Connection type (CNN)
Specifies the type of line connection used.
Note: *NONSWTCAL and *NONSWTANS valid only when INTERFACE(*INTMODEM).
- A switched point-to-point line is used.
- A nonswitched point-to-point line is used.
- A nonswitched point-to-point line is used for call mode.
- A nonswitched point-to-point line is used for answer mode.
Framing type (FRAMING)
Specifies whether the line uses asynchronous or synchronous framing.
- Asynchronous frames are used.
- Synchronous frames are used.
Physical interface (INTERFACE)
Specifies the type of physical interface on the input/output adapter (IOA) port.
- The RS232/V.24 interface is used.
- The RS449/V.36 interface is used.
- The X.35 interface is used.
- The X.21 interface is used.
- The integrated modem interface is used.
Online at IPL (ONLINE)
Specifies whether this object is automatically varied on at initial program load (IPL).
- The line is automatically varied on at initial program load (IPL).
- 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.
- The system does not wait for vary on completion. The line is varied on asynchronously.
- 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.
- 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.
- 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 bps is used.
- 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
Note: Valid only when INTERFACE(*INTMODEM)
- No command string is sent to the modem.
- 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.
- The maximum frame size is 2048 bytes.
- 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.
- The line is used for both incoming and outgoing calls.
- The line is used for incoming calls only.
- The line is used for outgoing calls only.
Specifies how the clocking function for the line is provided.
- The modem supplies the clocking function.
- 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.
- 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.
- 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.
- 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.
- No V.25 bis command string is sent to the modem.
- 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.
- 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:
- Less than sign
- Left parenthesis
- Plus sign
- Right parenthesis
- Minus sign
- Greater than sign
- Question mark
- 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.
- The Call Request Normal (CRN) dial command is used by the V.25 bis line.
- 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.
- 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.
- Specify a value ranging from 1 through 65535.
Flow control (FLOWCNTL)
Specifies whether the system controls the data flow.
- 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 flow control is performed using the Request to Send (RTS) and Clear To Send (CTS) flow control signals.
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.
- The system waits up to 25 seconds for the CTS state to begin or end.
- 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.
- The inactivity timer is disabled.
- 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.
- The system waits 60 seconds before signaling an error.
- 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.
- All data communications equipment on the line must use the same data transmission coding method.
- Framing (FRAMING parameter) must be *SYNC to use NRZI data encoding.
- NRZI data encoding is used.
- NRZI data encoding is not used.
Text 'description' (TEXT)
Specifies text that briefly describes the line description.
- Text is not specified.
- 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.
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.
- No ASCII control characters between '00'X and '1F'X' are escaped.
- 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.
- The remote peer is authenticated only once when the PPP link is initially opened. No additional authentication challenges are issued.
- 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.
- 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).
- 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.
- If the remote peer does not respond after host system has sent five authentication challenges, host system terminates communication.
- 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.
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.
- Unacknowledged configuration requests are resent every 3 seconds.
- 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.
- If the configuration does not converge after 5 attempts, host system terminates communication.
- 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.
- If host system transmits ten configuration requests to the remote peer but does not receive a response, host system terminates communication.
- 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.
- If no response is received after sending two termination requests, host system terminates communication immediately.
- Specifies the maximum number of attempts made to notify the remote peer that communication will be terminated.
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.
- Host system is allowed to negotiate the use of STAC LZS data compression.
- 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:
- Two recovery attempts are made within the specified time interval.
- Specify the number of recovery attempts to be made. Valid values range from 0 through 99.
The possible Recovery Time Interval values are:
- The specified number of recovery attempts is made within a 5-minute 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:
- The recovery limits specified in the system value QCMNRCYLMT are used.
Message queue (MSGQ)
Specifies the message queue to which operational messages are sent.
- The value in the system value QCFGMSGQ is used.
- Messages are sent to the system operator message queue (QSYS/QSYSOPR).
Qualifier 1: Message queue
- Specify the name of the message queue to which operational messages are sent.
Qualifier 2: Library
- Specify the name of the library where the message queue is located.
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.
- 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.
- 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.
- 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.
- The user cannot access the object.
- 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.
- 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.
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.
- Line description &1 not created due to errors.