Create Line Desc (PPP) (CRTLINPPP)

Parameters

Keyword	Description	Choices	Notes
LIND	Line description	Name	Required, Key, Positional 1
RSRCNAME	Resource name	Name	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
NWI	Attached nonswitched NWI	Name	Optional
NWICHLNBR	NWI channel number	Character value	Optional
SWTNWILST	Switched NWI list	Single values: NONE Other values (up to 64 repetitions): Element list*	Optional
	Element 1: NWI description	Name
	Element 2: NWI channel type	*B
	Element 3: NWI channel number	*CALC, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30
ONLINE	Online at IPL	NO, YES	Optional
VRYWAIT	Vary on wait	15-180, *NOWAIT	Optional
LINESPEED	Line speed	Character value, 115200	Optional
INFTRFTYPE	Information transfer type	Character value, UNRESTRICTED, V110, DOV, ASYNCMODEM, *SYNCMODEM	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
SWTNWISLCT	Switched NWI selection	Character value, FIRST, CALC	Optional
CNNLSTOUT	Outgoing connection list	Name	Optional
CNNLSTOUTE	Connection list entry	Name	Optional
CNNLSTIN	Incoming connection list	Name, *NETATR	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
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

Top

Note: This parameter is no longer supported. It exists solely for compatibility with releases earlier than Version 5 Release 3 Modification 0 of the operating system.

NWI channel number (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 not *SWTPP.

Note: This parameter is no longer supported. It exists solely for compatibility with releases earlier than Version 5 Release 3 Modification 0 of the operating system.

Switched NWI list (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).

The possible Network Interface Description Name values are:

*NONE: No network interface description is specified.
name: Specify, for switched connections, the name of the network interface description to which this line attaches.

The possible Network Interface Channel Type values are:

*B: The B channel is used.

The possible Network Interface Channel-Number values are:

*CALC: The system selects one of the 30 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 30) to which the line description is restricted.

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:

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

Note: This parameter is no longer supported. It exists solely for compatibility with releases earlier than Version 5 Release 3 Modification 0 of the operating system.

Information transfer type (INFTRFTYPE)

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

Note: Valid only when RSRCNAME(*NWID) and CNN 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.
*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.

Modem init command string (MDMINZCMD)

Specifies the modem initialization command string sent to set the modem

Note: Valid only when INTERFACE(*INTMODEM) or INFTRFTYPE(*ASYNCMODEM) or INFTRFTYPE(*SYNCMODEM) is specified.

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

Note: This parameter is no longer supported. It exists solely for compatibility with releases earlier than Version 5 Release 3 Modification 0 of the operating system.

Switched NWI selection (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.

Note: This parameter is no longer supported. It exists solely for compatibility with releases earlier than Version 5 Release 3 Modification 0 of the operating system.

Outgoing connection list (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).

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

Note: This parameter is no longer supported. It exists solely for compatibility with releases earlier than Version 5 Release 3 Modification 0 of the operating system.

Connection list entry (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).

name: Specify the entry name from the connection list.

Note: This parameter is no longer supported. It exists solely for compatibility with releases earlier than Version 5 Release 3 Modification 0 of the operating system.

Incoming connection list (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.
name: Specify the name of the connection list used for this line description.

Clocking (CLOCK)

Specifies how the clocking function for the line is provided.

Note: Not valid when RSRCNAME(*NWID).

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

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

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.

Note: Not valid when RSRCNAME(*NWID).

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

Note: Not valid when RSRCNAME(*NWID).

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

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.

Note: Not valid when RSRCNAME(*NWID).

NOTES:

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.

*YES: NRZI data encoding is used.
*NO: NRZI data encoding is not used.

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:

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.

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.

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.

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.