CHGLINPPP (Change Line Description (PPP))
CHGLINPPP Command syntax diagram
Purpose
The Change Line Description (Point-to-Point Protocol (PPP)) (CHGLINPPP) command changes a line description for a PPP line.
Restriction: You must have *IOSYSCFG special authority to use this command.
Required Parameters
- LIND
- Specifies the name of the line description being changed.
Optional Parameters
- RSRCNAME
- Specifies the resource name that identifies the hardware that the
description represents.
Note: Use the Work with Hardware Resources (WRKHDWRSC) command with *CMN specified for the TYPE parameter to help determine the resource name. *SAME: The value does not change.
*NWID: The resource name specified on the attached network interface description is used.
resource-name: Specify the resource name of the communications port.
- 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 on 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). *SAME: The value does not change.
*NONE: No network interface description is specified.
Element 1: Network Interface Description Name
nwi-description-name: Specify, for switched connections, the name of the network interface description to which this line attaches.
Element 2: Network Interface Channel Type
*B: The B channel is used.
Element 3: Network Interface Channel-Number
*CALC: The system selects one of the channel numbers (based on availability) defined for the network interface description when an incoming or outgoing call is processed.
nwi-channel-number: Specify a channel number (1 to 23) to which the line description is restricted.
- ONLINE
- Specifies whether this object is automatically varied on at initial program
load (IPL).
*SAME: The value does not change.
*NO: This line is not automatically varied on at IPL.
*YES: The line is automatically varied on at IPL.
- VRYWAIT
- Specifies whether the line is varied on asynchronously or synchronously.
For a synchronous vary on, this parameter specifies how long the system waits
for the vary on to complete.
*SAME: The value does not change.
Note: Valid only when CNN(*SWTPP). *NOWAIT: The system does not wait for the vary on to complete. The line is varied on asynchronously.
vary-on-wait: Specify the time (in seconds) to wait. Valid values range from 15 through 180. The system waits until the line is varied on, or until the specified time passes, before completing the Vary Configuration (VRYCFG) command.
Notes
- 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.
- Put tasks in place to manage the line
- 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.
- LINESPEED
- Specifies the line speed in bits per second (bps).
*SAME: The value does not change.
line-speed: Specify the line speed (bps). Valid lines speeds range from 9600 to 2048000 bits per second for FRAMING(*SYNC). For FRAMING(*ASYNC), the valid values are 9600, 19200, 38400, 57600, and 115200. For FRAMING(*ASYNC) and an interface of *V35 or *RS449V36, line speeds of 157600 and 230400 may be specified.
- INFTRFTYPE
- Specifies the information transfer type. The information transfer type
determines the layer 1 protocol.
Note: Valid only when RSRCNAME(*NWID) and CNN is not *SWTPP. *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.
*FAXMODEM: Allows Facsimile (FAX) data from the integrated fax modem to be transferred over an ISDN voice call. This option should be used to connect to a remote location that is using a fax device on an analog telephone line or to another ISDN device that has Group 3 FAX modem capabilities. Data is transferred at fax speeds up to 14.4Kbps.
*ASYNCMODEM: Allows data from the integrated asynchronous modem to be transferred over an ISDN voice call. This option should be used to connect to a remote location that is using an asynchronous modem on an analog telephone line. Data is transferred at modem speeds up to 33.6Kbps from the remote analog device to this digital connection and up to 56Kbps from this digital connection to the remote analog device.
*SYNCMODEM: Allows data from the integrated synchronous modem to be transferred over an ISDN voice call. This option should be used to connect to a remote location that is using a synchronous modem on an analog telephone line. Data is transferred at modem speeds up to 33.6Kbps from the remote analog device to this digital connection and up to 56Kbps from this digital connection to the remote analog device.
- MDMINZCMD
- Specifies the command string to send to set the modem.
Note: Valid only when INTERFACE(*INTMODEM), or INFTRFTYPE *FAXMODEM, *ASYNCMODEM and *SYNCMODEM. *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.
Note: The first two characters of the modem initialization command string must begin with 'AT'. These first two characters must be in uppercase.
- MAXFRAME
- Specifies the maximum length for the information field in a PPP frame,
including padding, but not including the protocol field. It is also known as
the Maximum Receive Unit (MRU). By negotiation, consenting PPP implementations
may use other values for the MRU.
*SAME: The value does not change.
maximum-frame-size: Specify the maximum frame size (in bytes). Valid maximum frame sizes range from 1500 to 4096 bytes.
- SWTCNN
- Specifies whether the switched line is used for incoming calls, for
outgoing calls, or for both.
Note: Valid only when CNN(*SWTPP). *SAME: The value does not change.
*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.
- 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.
- 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.
connection-list-name: Specify the connection list object name.
- 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.
connection-list-entry-name: Specify the entry name from the 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.
connection-list-name: Specify the name of the connection list used for this line description.
- MSGQ
- Specifies the qualified name of the message queue to which messages are
sent. More information about using this parameter is in the Communications Management
book.
Single Values
*SAME: The value does not change.
*SYSVAL: Messages are sent to the message queue defined in the system value QCFGMSGQ.
*SYSOPR: Messages are sent to the system operator message queue (QSYS/QSYSOPR).
library-name/message-queue-name: Specify the library-qualified name of the message queue to which operational messages are sent.
- CLOCK
- Specifies how the clocking function for the line is provided.
Note: Not valid when RSRCNAME(*NWID) or INTERFACE(*INTMODEM). *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 modem (DCE) on the system data terminal equipment (DTE) transmitting clock. This option can be used to improve high speed data transmission when the modem (DCE) supports such an option. The valid interfaces for *LOOP are *V35, *X21BISV35, and *RS449V36.
*INVERT: The transmit clock provided by the modem data circuit-terminating equipment (DCE) is inverted before use. This option can be used when having problems with high speed data transmission and the modem (DCE) does not support looped clocking. The valid interfaces for *INVERT are *V35, *X21, *X21BISV35, and *RS449V36.
- DIALCMD
- Specifies the type of dial command used to establish a switched connection
with a remote system.
Note: Not valid when RSRCNAME(*NWID). *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 nown as CCITT) V.25 bis standard for serial automatic calling.
- SETMDMASC
- Specifies the ASCII V.25 bis command that will set the modem to ASYNC mode.
Note: Not valid when RSRCNAME(*NWID) or INTERFACE(*INTMODEM). *SAME: The value does not change.
*NONE: No command string is sent to the modem.
END: The END command string is generally used as the command to set most modems to ASYNC mode. For cases that do not use the END command string, enter the command string appropriate for that modem to set it to ASYNC mode.
command-string: Specify up to 40 characters that represent the command issued. Valid characters are upper case A through Z, lower case a through z, numbers 0 thru 9, and special characters.
No embedded blanks are allowed.
- CALLNBR
- Specifies the local telephone number of the line used for the V.25 bis call
request with identification (CRI) dial command. This parameter is used when the
CRI function is needed for V.25 bis. When V.25 bis CRI dialing is used, the
system takes the called (connection) number from the CNNNBR parameter of the
controller description, adds a separator character (;), and concatenates the
calling number at the end. Specify the calling number only if the modem and the
network both support the CRI dial command.
Note: Not valid when RSRCNAME(*NWID) and CNN(*NONSWTPP), CNN(*NONSWTCAL) or CNN(*NONSWTANS). *SAME: The value does not change.
*NONE: The CRN (Call Request Normal) dial command is used by the V.25 bis line.
calling-number: Specify up to 32 characters that represent the local telephone number for V.25 bis CRI auto-dialing.
- FLOWCNTL
- Specifies whether the system controls the data flow.
*SAME: The value does not change.
*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.
- CTSTMR
- Specifies the amount of time the system waits for the modem to enter or
exit the Clear to Send (CTS) state before signaling an error.
Note: Not valid when RSRCNAME(*NWID). *SAME: The value does not change.
timer-value: Specify a value ranging from 10 through 60 seconds.
- INACTTMR
- Specifies the time (in seconds) that the system waits for user data
activity on a switched line before disconnecting. This timer is started once
LCP (Link Control Protocol) and NCP (Network Control Protocol) negotiations
have completed successfully and restarted when user data are sent or received.
LCP and NCP packets do not cause this timer to be restarted.
*NOMAX: The inactivity timer is disabled.
timer-value: Specify a value ranging from 15 through 65535 seconds.
- RMTANSTMR
- Specifies the amount of time the system waits for the modem to enter the
Data Set Ready (DSR) state after dialing before signaling an error.
Note: Not valid when RSRCNAME(*NWID). *SAME: The value does not change.
timer-value: Specify a value ranging from 30 through 120 seconds.
- NRZI
- Specifies whether non-return-to-zero-inverted (NRZI) data encoding is used
for modems that are sensitive to certain bit patterns in the data stream. This
ensures that the signal does not remain the same for an extended period of
time. For digital phone lines, *NO is suggested.
Notes
- 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.
- All data communications equipment on the line must use the same data
transmission coding method.
- TEXT
- Specifies the text that briefly describes the program and its function.
More information is in Commonly used
parameters.
*SAME: The value does not change.
*BLANK: Text is not specified.
'description': Specify no more than 50 characters of text, enclosed in apostrophes.
- ACCM
- Specifies a mapping for control characters in the transmitted data that may
be either removed or introduced by data communications equipment on the line.
Note: ACCM(00000000) must be specified unless FRAMING(*ASYNC) is specified. The iSeries 400 sends all characters specified by this map to the remote peer as a 2-byte escape sequence. Additionally, all characters specified by this map must be sent by the remote peer to iSeries 400 as a 2-byte escape sequence. Any characters specified in this map that are not escaped are discarded by iSeries 400.
ATTENTION:
The default value for this parameter does not normally need to be changed. Do not specify a different value for this parameter unless you are fully aware of the effect of the change.
*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.
- 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.
- LCPAUT
- Specifies values controlling how the Link Control Protocol layer of iSeries
PPP authenticates a remote peer.
Element 1: Remote peer challenge timer
Specifies the interval, in minutes, to periodically issue an authentication challenge to the remote peer.
*SAME: The value does not change.
challenge-interval: Specify the interval, in minutes, to re-validate the remote peer's authentication.
Element 2: Maximum authentication attempts
Specifies the maximum number of unacknowledged authentication challenges sent to a remote peer before assuming that the peer is unable to respond.
Notes
- A challenge is considered unacknowledged when iSeries 400 does not receive
a response within the interval specified by the configuration retry timer
(element 1 of parameter LCPCFG).
- This value does not affect how iSeries 400 responds when a peer fails authentication. iSeries 400 always terminates communication without any retry if a response from the remote peer fails authentication.
*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.
- A challenge is considered unacknowledged when iSeries 400 does not receive
a response within the interval specified by the configuration retry timer
(element 1 of parameter LCPCFG).
- LCPCFG
- Specifies values controlling how the Link Control Protocol layer of iSeries
PPP negotiates mutually acceptable link configuration values with a remote
peer.
Warning: The default values for this parameter do not normally need to be changed. Do not specify different values for this parameter unless you are fully aware of the effect of the change. Element 1: Configuration retry timer
Specifies the interval, in seconds, that iSeries 400 waits before resending an unacknowledged configuration, termination, or authentication challenge request to a remote peer.
*SAME: The value does not change.
retry-interval: Specify the time interval after which unacknowledged requests are resent.
Element 2: Maximum configuration failures
Specifies the maximum number of attempts that are made to negotiate a mutually acceptable configuration with a remote peer before assuming that configuration is not converging.
*SAME: The value does not change.
maximum-number-of-attempts: Specifies the maximum number of attempts made to negotiate a mutually acceptable configuration.
Element 3: Maximum configuration requests
Specifies the maximum number of unacknowledged configuration requests sent to a remote peer before assuming that the peer is unable to respond.
*SAME: The value does not change.
maximum-number-of-attempts: Specifies the maximum number configuration attempts made before iSeries 400 terminates communication.
Element 4: Maximum termination requests
Specifies the maximum number of unacknowledged termination request packets sent to a remote peer before assuming that the peer is unable to respond.
*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.
- COMPRESS
- Specifies the compression function is provided.
Note: This parameter allows you to enable a compression protocol, but does not guarantee that compression will be used. Data compression will not be activated unless both iSeries 400 and the remote peer iSeries 400 connects to agree to use the specified compression protocol. This parameter is ignored if RSRCNAME(*NWID) is not specified or when a INTERFACE is *INTMODEM, or INFTRFTYE is *FAXMODEM or *ASYNCMODEM or *SYNCMODEM.
*SAME: The value does not change.
*STACLZS: The iSeries 400 is allowed to negotiate the use of STAC LZS data compression.
*NONE: The iSeries 400 is not allowed to negotiate or use any Point-to-Point Compression protocol.
- CMNRCYLMT
- Specifies the number of recovery attempts made by the system before an
inquiry message is sent to the system operator. Also specifies the time (in
minutes) that must elapse before the system sends an inquiry message to the
system operator indicating that the recovery attempt count limit is reached.
*SAME: The value does not change.
*SYSVAL: The recovery limits specified in the QCMNRCYLMT system value are used.
Element 1: Maximum Recovery Limit
count-limit: Specify the number of second-level recovery attempts to be made. Valid values range from 0 through 99.
Element 2: Recovery Time Interval
time-interval: Specify the time interval (in minutes) at which the specified number of second-level recoveries are attempted. Valid values range from 0 through 120. If the value specified for count-limit is not 0, the value 0 specifies infinite recovery.
Example for CHGLINPPP
CHGLINPPP LIND(CHICAGO) LINESPEED(115200)
This command changes the line speed for line description CHICAGO to 115200 bits per second.
Error messages for CHGLINPPP