Change Line Desc (PPP) (CHGLINPPP)

Parameters

Keyword	Description	Choices	Notes
LIND	Line description	Name	Required, Key, Positional 1
RSRCNAME	Resource name	Name, *SAME	Optional
CNN	Connection type	SAME, SWTPP, NONSWTPP, NONSWTCAL, *NONSWTANS	Optional
FRAMING	Framing type	SAME, ASYNC, *SYNC	Optional
INTERFACE	Physical interface	Character value, SAME, RS232V24, RS449V36, V35, X21, INTMODEM	Optional
SWTNWILST	Switched NWI list	Single values: SAME, 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	SAME, YES, *NO	Optional
VRYWAIT	Vary on wait	15-180, SAME, NOWAIT	Optional
LINESPEED	Line speed	Character value, *SAME	Optional
INFTRFTYPE	Information transfer type	Character value, SAME, UNRESTRICTED, V110, DOV, ASYNCMODEM, SYNCMODEM	Optional
MDMINZCMD	Modem init command string	Character value, SAME, NONE	Optional
MAXFRAME	Maximum frame size	Character value, *SAME	Optional
SWTCNN	Switched connection type	SAME, BOTH, ANS, DIAL	Optional
SWTNWISLCT	Switched NWI selection	Character value, SAME, FIRST, *CALC	Optional
CNNLSTOUT	Outgoing connection list	Name, *SAME	Optional
CNNLSTOUTE	Connection list entry	Name, *SAME	Optional
CNNLSTIN	Incoming connection list	Name, SAME, NETATR	Optional
CLOCK	Clocking	SAME, MODEM, LOOP, INVERT	Optional
DIALCMD	Dial command type	Character value, SAME, ATCMD, *V25BIS	Optional
SETMDMASC	Set modem to ASYNC command	Character value, *SAME, END	Optional
CALLNBR	Calling number	Character value, *SAME	Optional
FLOWCNTL	Flow control	SAME, NO, *HARDWARE	Optional
CTSTMR	Clear To Send timer	10-60, *SAME	Optional
INACTTMR	Inactivity timer	Character value, SAME, NOMAX	Optional
RMTANSTMR	Remote answer timer	Character value, *SAME	Optional
NRZI	NRZI data encoding	SAME, YES, *NO	Optional
TEXT	Text 'description'	Character value, SAME, BLANK	Optional
ACCM	Async control character map	0000000000-00FFFFFFFF, *SAME	Optional
LCPAUT	LCP authentication values	Element list	Optional
	Element 1: Remote peer challenge timer	Integer, NONE, SAME
	Element 2: Max authentication attempts	1-255, *SAME
LCPCFG	LCP configuration values	Element list	Optional
	Element 1: Configuration retry timer	0.1-60.0, *SAME
	Element 2: Max configuration failures	1-255, *SAME
	Element 3: Max configuration requests	1-255, *SAME
	Element 4: Max terminatation requests	1-255, *SAME
COMPRESS	Compression	Character value, SAME, STACLZS, *NONE	Optional
CMNRCYLMT	Recovery limits	Single values: SAME, SYSVAL Other values: Element list	Optional
	Element 1: Count limit	0-99
	Element 2: Time interval	0-120
MSGQ	Message queue	Single values: SAME, SYSVAL, SYSOPR Other values: Qualified object name*	Optional
	Qualifier 1: Message queue	Name
	Qualifier 2: Library	Name

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.

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:

*SAME: The value does not change.

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

*SAME: The value does not change.

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

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.

*SAME: The value does not change.

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

*SAME: The value does not 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'.

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

*SAME: The value does not change.

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

*SAME: The value does not change.

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

*SAME: The value does not change.

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

*SAME: The value does not change.

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

*SAME: The value does not change.

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

*SAME: The value does not change.

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

*SAME: The value does not change.

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

*SAME: The value does not change.

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

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.

*SAME: The value does not change.

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

*SAME: The value does not change.

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.

*SAME: The value does not change.

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.

*SAME: The value does not change.

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.

*SAME: The value does not change.

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.

*SAME: The value does not change.

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.

*SAME: The value does not change.

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.

*SAME: The value does not change.

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.

*SAME: The value does not change.

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

*SAME: The value does not change.

*SYSVAL: The DBCS-coded font specified in the system value QIGCCDEFNT is used.

The possible Maximum Recovery Limit values are:

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:

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.

Message queue (MSGQ)

Specifies the message queue to which operational messages are sent.

*SAME: The value does not change.

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

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