Change Line Desc (PPP) (CHGLINPPP)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Change Line Description (Point-to-Point Protocol (PPP)) (CHGLINPPP) command changes a line description for a PPP line.
Notes:
- Parameters no longer supported as of V5R3M0: CNNLSTIN, CNNLSTOUT, CNNLSTOUTE, INFTRFTYPE, SWTNWILST, SWTNWISLCT
Restriction: You must have input/output system configuration (*IOSYSCFG) special authority to use this command.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| LIND | Line description | Name | Required, Key, Positional 1 |
| RSRCNAME | Resource name | Name, *SAME, *ETHDEVSVR | 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 |
| ONLINE | Online at IPL | *SAME, *YES, *NO | Optional |
| VRYWAIT | Vary on wait | 15-180, *SAME, *NOWAIT | Optional |
| LINESPEED | Line speed | Character value, *SAME | 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 |
| 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 |
| RMTINTNETA | Remote internet address | Character value, *SAME | Optional |
| RMTPORT | Remote port | 1-65535, *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 |
| MSGQ |
Message queue | Single values: *SAME, *SYSVAL, *SYSOPR Other values: Qualified object name |
Optional |
| Qualifier 1: Message queue | Name | ||
| Qualifier 2: Library | Name | ||
| 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 |
| Top |
| Top |
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.
- *SAME
- The value does not change.
- *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.
| Top |
Connection type (CNN)
Specifies the type of line connection used.
Note: *NONSWTCAL and *NONSWTANS valid only when INTERFACE(*INTMODEM).
- *SAME
- The value does not 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.
| Top |
Framing type (FRAMING)
Specifies whether the line uses asynchronous or synchronous framing.
- *SAME
- The value does not change.
- *ASYNC
- Asynchronous frames are used.
- *SYNC
- Synchronous frames are used.
| Top |
Physical interface (INTERFACE)
Specifies the type of physical interface on the input/output adapter (IOA) port.
- *SAME
- The value does not change.
- *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.
| Top |
Online at IPL (ONLINE)
Specifies whether this object is automatically varied on at initial program load (IPL).
- *SAME
- The value does not change.
- *YES
- The line is automatically varied on at initial program load (IPL).
- *NO
- This line is not automatically varied on at IPL.
| Top |
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.
| Top |
Line speed (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.
| Top |
Modem init command string (MDMINZCMD)
Specifies the modem initialization command string sent to set the modem
Note: Valid only when INTERFACE(*INTMODEM)
- *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'.
| Top |
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.
- *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.
| Top |
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.
- *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.
| Top |
Clocking (CLOCK)
Specifies how the clocking function for the line is provided.
- *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.
| Top |
Dial command type (DIALCMD)
Specifies the type of dial command used to establish a switched connection with a remote system.
- *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
| Top |
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.
- *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
| Top |
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.
- *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.
| Top |
Remote internet address (RMTINTNETA)
Specifies the internet address of the Ethernet device server.
- *SAME
- The value does not change.
- 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).
| Top |
Remote port (RMTPORT)
Specifies the remote port for the TCP/IP connection to the Ethernet device server.
- *SAME
- The value does not change.
- port-number
- Specify a value ranging from 1 through 65535.
| Top |
Flow control (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.
| Top |
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.
- *SAME
- The value does not change.
- cts-timer
- Specify a value ranging from 10 through 60 seconds.
| Top |
Inactivity timer (INACTTMR)
Specifies the time (in seconds) that the system waits for activity on a switched line before disconnecting.
- *SAME
- The value does not change.
- *NOMAX
- The inactivity timer is disabled.
- timer-value
- Specify a value ranging from 15 through 65535 seconds.
| Top |
Remote answer timer (RMTANSTMR)
Specifies the amount of time that system waits for the modem to enter the Data Set Ready (DSR) state after dialing before signaling an error.
- *SAME
- The value does not change.
- answer-timer
- Specify a value ranging from 30 through 120 seconds in 5-second intervals.
| Top |
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.
| Top |
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.
| Top |
Text 'description' (TEXT)
Specifies text that briefly describes the line description.
- *SAME
- The value does not change.
- *BLANK
- Text is not specified.
- character-value
- Specify no more than 50 characters of text, enclosed in apostrophes.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
Examples
Example 1: Change a PPP Line Description
CHGLINPPP LIND(CHICAGO) LINESPEED(115200)
This command changes the line speed for line description CHICAGO to 115200 bits per second.
Example 2: Change the IP Address of a PPP Line Description Using an Ethernet Device Server
CHGLINPPP LIND(PPPDESVR) RMTINTNETA('10.5.13.1')
This command changes the line description PPPDEVSVR to specify an IP address of 10.5.13.1 for the Ethernet device server.
| Top |
| Top |