Change Line Desc (X.25) (CHGLINX25)

Where allowed to run: All environments (*ALL)
Threadsafe: No

The Change Line Description (X.25) (CHGLINX25) command changes a line description for an X.25 line.

Restriction: You must have input/output system configuration (*IOSYSCFG) special authority to use this command.

Parameters

Keyword	Description	Choices	Notes
LIND	Line description	Name	Required, Key, Positional 1
RSRCNAME	Resource name	Name, *SAME	Optional
LGLCHLE	Logical channel entries	Single values: SAME, PROMPT Other values (up to 256 repetitions): Element list	Optional
	Element 1: Logical channel identifier	Character value
	Element 2: Logical channel type	PVC, SVCIN, SVCBOTH, SVCOUT
NETADR	Local network address	Character value, *SAME	Optional
CNNINIT	Connection initiation	SAME, LOCAL, REMOTE, WAIT, *CALLER	Optional
ONLINE	Online at IPL	SAME, YES, *NO	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	1-30, *CALC
X25DCE	X.25 DCE support	SAME, YES, NO, NEG	Optional
VRYWAIT	Vary on wait	15-180, SAME, NOWAIT	Optional
LINESPEED	Line speed	SAME, CALC, 600, 1200, 2400, 4800, 7200, 9600, 12000, 14400, 19200, 48000, 56000, 57600, 64000, 128000, 192000, 256000, 320000, 384000, 448000, 512000, 576000, 640000, 704000, 768000, 832000, 896000, 960000, 1024000, 1088000, 1152000, 1216000, 1280000, 1344000, 1408000, 1472000, 1536000, 1600000, 1664000, 1728000, 1792000, 1856000, 1920000, 1984000, 2048000	Optional
SWTCTLLST	Switched controller list	Single values: SAME, NONE, *ALL Other values (up to 64 repetitions): Name	Optional
PKTMODE	Packet mode	SAME, YES, *NO	Optional
INFTRFTYPE	Information transfer type	Character value, SAME, UNRESTRICTED, V110, DOV, *SYNCMODEM	Optional
EXNNETADR	Extended network addressing	SAME, YES, *NO	Optional
MAXFRAME	Maximum frame size	*SAME, 1024, 2048, 4096	Optional
DFTPKTSIZE	Default packet size	Element list	Optional
	Element 1: Transmit value	*SAME, 64, 128, 256, 512, 1024, 2048, 4096
	Element 2: Receive value	SAME, TRANSMIT, 64, 128, 256, 512, 1024, 2048, 4096
MAXPKTSIZE	Maximum packet size	Element list	Optional
	Element 1: Transmit value	SAME, DFTPKTSIZE, 64, 128, 256, 512, 1024, 2048, 4096
	Element 2: Receive value	SAME, DFTPKTSIZE, *TRANSMIT, 64, 128, 256, 512, 1024, 2048, 4096
MODULUS	Modulus	*SAME, 8, 128	Optional
DFTWDWSIZE	Default window size	Element list	Optional
	Element 1: Transmit value	1-15, *SAME
	Element 2: Receive value	1-15, SAME, TRANSMIT
ADRINSERT	Insert net address in packets	SAME, YES, *NO	Optional
NETUSRID	Network user ID	Character value, SAME, NONE	Optional
IDLTMR	Idle timer	3-600, *SAME	Optional
FRAMERTY	Frame retry	0-64, *SAME	Optional
THRESHOLD	Error threshold level	SAME, OFF, MIN, MED, *MAX	Optional
CNNNBR	Connection number	Character value, *SAME	Optional
CALLNBR	Calling number	Character value, SAME, NONE	Optional
MODEM	Modem type supported	SAME, NORMAL, V54, IBMWRAP	Optional
MODEMRATE	Modem data rate select	SAME, FULL, *HALF	Optional
SWTCNN	Switched connection type	SAME, BOTH, ANS, DIAL	Optional
CNNLSTOUT	Outgoing connection list	Name, *SAME	Optional
CNNLSTOUTE	Connection list entry	Name, *SAME	Optional
CNNLSTIN	Incoming connection list	Name, SAME, NETATR	Optional
AUTOANS	Autoanswer	SAME, YES, *NO	Optional
AUTODIAL	Autodial	SAME, NO, *YES	Optional
DIALCMD	Dial command type	SAME, NONE, *V25BIS	Optional
MDMINZCMD	Modem init command string	Character value, SAME, NONE	Optional
CALLIMMED	Call immediate	SAME, NO, *YES	Optional
ACRSRCNAME	Autocall resource name	Name, *SAME	Optional
PREDIALDLY	Predial delay	0-254, *SAME	Optional
REDIALDLY	Redial delay	0-254, *SAME	Optional
DIALRTY	Dial retry	0-254, *SAME	Optional
SWTDSC	Switched disconnect	SAME, YES, *NO	Optional
SWTDSCTMR	Disconnect timers	Single values: *SAME Other values: Element list	Optional
	Element 1: Minimum connect timer	0-65535, 170
	Element 2: Disconnection delay timer	0-65535, 0
DSRDRPTMR	Data Set Ready drop timer	1-60, *SAME	Optional
AUTOANSTYP	Autoanswer type	SAME, DTR, *CDSTL	Optional
CTSTMR	Clear To Send timer	10-60, *SAME	Optional
RMTANSTMR	Remote answer timer	*SAME, 30, 35, 40, 45, 50, 55, 60, 65, 70, 75, 80, 85, 90, 95, 100, 105, 110, 115, 120	Optional
CLOCK	Clocking	SAME, MODEM, LOOP, INVERT	Optional
LINKSPEED	Link speed	SAME, INTERFACE, MIN, 1200, 2400, 4800, 7200, 9600, 14400, 19200, 48000, 56000, 64000, 128000, 192000, 256000, 320000, 384000, 448000, 499000, 576000, 614000, 691000, 768000, 845000, 922000, 998000, 1075000, 1152000, 1229000, 1382000, 1536000, 1690000, 1843000, 1997000, 4M, 10M, 16M, MAX	Optional
SWTNWISLCT	Switched NWI selection	SAME, FIRST, *CALC	Optional
COSTCNN	Cost/connect time	0-255, *SAME	Optional
COSTBYTE	Cost/byte	0-255, *SAME	Optional
SECURITY	Security for line	SAME, NONSECURE, PKTSWTNET, UNDGRDCBL, SECURECND, GUARDCND, ENCRYPTED, MAX	Optional
PRPDLY	Propagation delay	SAME, MIN, LAN, TELEPHONE, PKTSWTNET, SATELLITE, *MAX	Optional
USRDFN1	User-defined 1	0-255, *SAME	Optional
USRDFN2	User-defined 2	0-255, *SAME	Optional
USRDFN3	User-defined 3	0-255, *SAME	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
TEXT	Text 'description'	Character value, SAME, BLANK	Optional

Top

Line description (LIND)

Specifies the name of the line description

This is a required parameter.

Top

Resource names (RSRCNAME)

Note: Use the Work with Hardware Resources (WRKHDWRSC) command with *CMN specified for the TYPE parameter to help determine the resource name. The resource name is on the port. For example, the resource name may be CMN01 on an Ethernet port.

Specifies the resource name that identifies the hardware the description represents.

*SAME: The value does not change.

Top

Logical channel entries (LGLCHLE)

Specifies, when using the Create Line X.25 Description (CRTLINX25) or Change Line Description X.25 (CHGLINX25) command, up to 256 entries to be added, removed, or changed in the logical channel table. A channel entry consists of a channel identifier, a logical channel type, and a PVC controller.

Note: Logical channel entries with attached permanent virtual circuit (PVC) controllers cannot be added, removed, or changed.

The possible Logical Channel Identifier value is:

*SAME: Specify a three-character hexadecimal number ranging from 001 through FFF for the logical channel identifier. The first digit (from left to right) is the logical channel group number; the second and third digits make up the logical channel number.

The possible channel identifier values are:

*PROMPT: Specifying *PROMPT presents an interactive display that can be used to process current logical channel entries.
channel-identifier: Specify a three-character hexadecimal number ranging from 001 to FFF for the logical channel identifier. The first digit (from left to right) is the logical channel group number; the second and third digits make up the logical channel number. Specify a logical channel identifier. Valid values range from hexadecimal numeral 001 through FFF.

The possible channel type values are:

*PVC: The logical channel is a permanent virtual circuit.
*SVCIN: The logical channel is a switched virtual circuit for incoming calls.
*SVCBOTH: The logical channel is a switched virtual circuit for both incoming and outgoing calls.
*SVCOUT: The logical channel is a switched virtual circuit for outgoing calls.

Top

Local network address (NETADR)

Specifies the local network address for this system. Up to 17 characters can be specified if *YES is specified for the EXNNETADR parameter. Otherwise, up to 15 characters can be specified.

*SAME: The value does not change.

local-network-address: Specify the local network address.

Top

Connection initiation (CNNINIT)

Specifies the method used to establish the X.25 data link connection.

*SAME: The value does not change.

*LOCAL: The local system initiates the connection by issuing the set asynchronous balanced mode (SABM) communications command to establish the connection.
*REMOTE: The remote system initiates the connection issuing the SABM communications command. The local system waits for the connection to be established.
*WAIT: The local system waits for a disconnect (DISC) or disconnect mode (DM) from the DCE before attempting to activate the link.
*CALLER: The connection is initiated from either the local system or the remote system based on call direction.

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

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.

Top

X.25 DCE support (X25DCE)

Specifies whether the system communicates through the X.25 data circuit-terminating equipment (DCE) support. This allows a system to communicate with another system without going through an X.25 network.

*SAME: The value does not change.

*NO: The system does not communicate through the X.25 DCE support.
*YES: The system does communicate through the X.25 DCE support.

*NEG: The operating system negotiates with another system about whether to communicate through the X.25 DCE support. This value can only be specified for switched lines.

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.

*CALC: The system calculates the value to use.

line-speed

Specify one of the following values (in bps) for the line speed:

     600    57600    576000   1152000   1728000
    1200    64000    640000   1216000   1792000
    2400   128000    704000   1280000   1856000
    4800   192000    768000   1344000   1920000
    7200   256000    832000   1408000   1984000
   14400   320000    896000   1472000   2048000
   19200   384000    960000   1536000
   48000   448000   1024000   1600000
   56000   512000   1088000   1664000

Top

Switched controller list (SWTCTLLST)

Specifies the names of up to 64 switched asynchronous controllers or specify *ALL for an unlimited number of switched asynchronous X.25 controllers that can establish a connection with an X.25 switched virtual circuit (SVC). The controller descriptions must already exist. This parameter is valid only if the line is used to attach switched asynchronous X.25 controllers created by the Create Controller Description (Async) (CRTCTLASC) command. Attaching controllers that specify CNNNBR(*ANY) or ANSNBR(*ANY) may result in a reordering of this list.

You can enter multiple values for this parameter.

*SAME: The value does not change.

*ALL: All X.25 switched controllers that are created using the Create Controller Description (Async) (CRTCTLASC) command and list this line description on the Switched Line List (SWTLINLST) parameter can be used to establish a connection with an X.25 switched virtual circuit (SVC).
*NONE: No switched asynchronous controller is specified.
names: Specify the switched controller names. Up to 64 switched controllers can be specified.

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.

Packet mode (PKTMODE)

Specifies whether to access the ISDN or T1 virtual circuit service.

*SAME: The value does not change.

*NO: The ISDN/T1 network is used to provide transparent access to an X.25 packet switched network external to the ISDN/T1 (Case A).
*YES: The ISDN/T1 virtual circuit service is accessed (Case B).

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.

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/T1 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.
*SYNCMODEM: Allows data from the integrated synchronous modem to be transferred over an ISDN/T1 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.

Top

Extended network addressing (EXNNETADR)

Specifies whether network addressing is extended to permit the use of 17 characters in an address name.

*SAME: The value does not change.

*NO: Network addresses can be up to 15 characters.
*YES: Network addresses can be up to 17 characters.

Top

Maximum frame size (MAXFRAME)

Specifies the maximum frame size the controller can send or receive.

*SAME: The value does not change.
max-frame: Specify one of the following values: 1024, 2048, 4096, 8192, or 16384.

Top

Default packet size (DFTPKTSIZE)

Specifies the default packet sizes used for transmission and reception on this line. The values specified should match the default values used by the X.25 network.

The possible transmission values are:

*SAME: The value does not change.

128: The default packet size is 128.
transmit-packet-size: Specify a default packet size for transmission to all controllers that will attach to this line. The controller commands can override this default with the DFTPKTSIZE parameter on the controller commands. The valid values for the packet size are 64, 128, 256, 512, 1024, 2048, and 4096.

The possible reception values are:

*SAME: The value does not change.

*TRANSMIT: The value specified as the default packet size for transmission is used as the default for reception.
receive-packet-size: Specify a default packet size for reception for all controllers that will attach to this line. The controller commands can override this default with the DFTPKTSIZE parameter on the controller commands. The valid values for the packet size are 64, 128, 256, 512, 1024, 2048, and 4096.

Top

Maximum packet size (MAXPKTSIZE)

Specifies the maximum packet sizes for transmission and reception on this line. These values should match the maximum packet sizes supported for transmission and reception by the X.25 network. The value specified must not be less than the default packet size specified.

The possible transmission values are:

*SAME: The value does not change.

*DFTPKTSIZE: The maximum packet size for transmission is the same as the default packet size for transmission.

max-transmit-packet-size: Specify a packet size for transmission to all controllers attached to this line. The valid values for the packet size are 64, 128, 256, 512, 1024, 2048, and 4096.

The possible reception values are:

*SAME: The value does not change.

*TRANSMIT: The maximum packet size for reception is the same as the maximum packet size for transmission.
*DFTPKTSIZE: The maximum packet size for reception is the same as the default packet size for reception.
max-receive-packet-size: Specify a default packet size for reception for all controllers attached to this line. The valid values for the packet size are 64, 128, 256, 512, 1024, 2048, and 4096.

Top

Modulus (MODULUS)

Specifies whether the extended sequence numbers are used.

*SAME: The value does not change.

8: Extended sequence numbers are not used (Modulus 8).
128: Extended sequence numbers are used (Modulus 128).

Top

Default window size (DFTWDWSIZE)

Specifies the default packet window size for transmission to and reception from controllers attached to this line. The controllers can override this default by specifying the X.25 default window size (DFTWDWSIZE) parameter on the controller commands.

The possible transmission values are:

*SAME: The value does not change.

2: The default packet window size is 2.
transmit-window-size: Specify the appropriate default window size. If you specified modulus 8, valid values range from 1 through 7. If you specified modulus 128, valid values range from 1 through 15.

The possible reception values are:

*SAME: The value does not change.

*TRANSMIT: The value specified as the default window size for transmission is used as the default for reception.
receive-window-size: Specify the appropriate default window size. If you specified modulus 8, valid values range from 1 through 7. If you specified modulus 128, valid values range from 1 through 15.

Top

Insert net address in packets (ADRINSERT)

Specifies whether the system inserts the local network address in call request packets.

*SAME: The value does not change.

*YES: The local network address is inserted in packets.
*NO: The local network address is not inserted in packets.

Top

Network user ID (NETUSRID)

For switched lines, this parameter allows the network subscriber to request network user identification (NUI) information be encoded in the NUI Selection Facility for all call request packets sent by the local system on this line.

*SAME: The value does not change.

network-user-identification: Specify a NUI up to 214 hexadecimal characters in length.

Top

Idle timer (IDLTMR)

Specifies the maximum amount of time (in 0.1 second intervals) that the system waits for acknowledgment from the network for each frame sent before re-transmission.

*SAME: The value does not change.

idle-timer: Specify a value ranging from 3 through 600. Each unit represents 0.1 seconds, which provides a timeout value ranging from 0.3 through 60 seconds.

Top

Frame retry (FRAMERTY)

Specifies, for a primary, negotiable, or X.25 line, the number of retries for an unanswered command frame or unacknowledged information frame before indicating the error.

*SAME: The value does not change.

frame-retry: Specify a value from 0 to 64 for the number of retries.

Top

Error threshold level (THRESHOLD)

Specifies the temporary error threshold level being monitored by the system. A permanent error is reported only if the errors occurred consecutively and exceeded the retry limit.

Note: Specifying the THRESHOLD parameter affects all threshold errors. They cannot be specified individually.

*SAME: The value does not change.

*OFF: No threshold errors are reported.

*MIN: The threshold for errors is set to a minimum monitoring level.

*MED: The threshold for errors is set to a medium monitoring level.

*MAX: The threshold for errors is set to a maximum monitoring level.

Top

Connection number (CNNNBR)

Specifies the number used to connect to this line. This is the telephone number to be dialed by the modem. A maximum of 32 characters can be specified.

*SAME: The value does not change.

connection-number: Specifies the connection number.

Top

Calling number (CALLNBR)

Specifies the local telephone number of the line that is used for the V.25 bis Call Request with Identification (CRI) dial command. When V.25 bis CRI dialing is used, the system takes the called (connection) number (CNNNBR parameter ), adds a separator character (;), and puts the calling number at the end. The default, *NONE, indicates that Call Request Normal (CRN) is used.

Specify the calling number only when the modem and network support the CRI dial command.

*SAME: The value does not change.

*NONE: Call Request Normal (CRN) is used. CRN dialing sends only the connection number to the V.25 bis modem.

calling-number: Specify the local telephone number if V.25 bis CRI dialing is required. The number can be up to 32 characters in length. See your modem documentation to determine the values allowed by the modem.

Note: Specify the calling number only if both the modem and network support the V.25 bis CRI dial command.

Top

Modem type supported (MODEM)

Specifies the type of modem supported on the communications line. Refer to the modem manual to determine the appropriate value to select.

*SAME: The value does not change.

*NORMAL: No attempt is made to run a diagnostic test to your modem.
*V54: A certain type of diagnostic test (as defined by the CCITT recommendations) is run to your modem. This system supports CCITT V.54 loop 3, local loop back, and loop 2, which is a remote loop back.
*IBMWRAP: An IBM modem with wrap test capabilities is used on the communications line.

Top

Modem data rate select (MODEMRATE)

Specifies the speed at which the line operates if the modem has the data rate select feature.

*SAME: The value does not change.

*FULL: The line operates at the full rate of the modem.
*HALF: The line operates at half the full rate of the modem.

Top

Switched connection type (SWTCNN)

Specifies whether the switched (Async, BSC, SDLC, or IDLC) line or switched network backup (Async, BSC, or SDLC) line is used for incoming calls, outgoing calls, or both.

*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

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 switched connections, the name of a connection list object that contains the ISDN assigned numbers for a dial-out operation to the ISDN.

*SAME: The value does not change.

*NONE: A user specified connection list for dial-out operations is not used. The connection list is automatically configured if OSI Communications Subsystems is installed.
name: Specify the name of the connection list for dial out operations.

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.

Connection list entry (CNNLSTOUTE)

Specifies, for ISDN switched connections, the entry name from the connection list used to make a call to the ISDN. The connection list must be specified on the CNNLSTOUT parameter.

*SAME: The value does not change.
name: Specify the entry name from the connection list.

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.

Incoming connection list (CNNLSTIN)

Specifies for ISDN switched connections the name of the connection list that is used to retrieve call information (or connection) for identifying authorized incoming calls.

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

Top

Autoanswer (AUTOANS)

Specifies, for switched or switched network backup lines (Async, BSC, SDLC, or X.25 line), whether the system automatically answers a call from a remote system to establish the connection, or whether the system operator manually answers the call and places the modem in data mode.

Note: *YES is a valid option only if the modem has the automatic answer feature.

*SAME: The value does not change.

*YES: The incoming call is automatically answered by the automatic answer feature.
*NO: The incoming call must be manually answered.

Top

Autodial (AUTODIAL)

Specifies, for switched lines, whether the system automatically calls a remote system to establish a connection or if the system operator must manually place the call.

*SAME: The value does not change.

*NO: The line connection is made by manually dialing the X.25 network.
*YES: The line connection is made by the system automatically dialing the X.25 network.

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.

*NONE: No dial command is used. (An automatic call unit is used to establish the connection.)

*V25BIS: V.25 bis is a recommendation which allows the use of one physical interface for call establishment and data transmission. It is referred to as a serial automatic call interface because the digits are presented serially on the link from the system to the modem.

Top

Modem init command string (MDMINZCMD)

Specifies the modem initialization command string sent to set the modem.

Note: Valid only when INTERFACE(*INTMODEM) 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'.

Top

Call immediate (CALLIMMED)

Specifies, for switched lines, whether a call (using the number specified in the CNNNBR parameter) is made immediately after varying on the line.

*SAME: The value does not change.

*NO: The system does not try to immediately call after varying on.
*YES: The system does try to immediately call after varying on.

Top

Autocall resource name (ACRSRCNAME)

Specifies the automatic call resource name that describes the automatic call unit port that is used to establish a connection with a remote system. Use the Work with Hardware Resources (WRKHDWRSC) command to determine the resource name.

*SAME: The value does not change.

Top

Predial delay (PREDIALDLY)

Specifies the time interval to wait before dialing a number.

*SAME: The value does not change.

6: The default value of six provides a 3-second delay.
predial-delay: Specify a value ranging from 0 through 254 units. Each unit represents 0.5 second. To indicate no delay, specify a value of 0.

Top

Redial delay (REDIALDLY)

Specifies the time interval to wait (in 0.5 second intervals) before re-dialing when the call attempt is unsuccessful.

*SAME: The value does not change.

120: The default value of 120 provides a 60-second delay.
redial-delay: Specify a value ranging from 0 through 254 units. Each unit represents 0.5 second. To indicate no delay, specify a value of 0.

Top

Dial retry (DIALRTY)

Specifies the number of re-dial attempts made by the system before considering the dialing unsuccessful.

*SAME: The value does not change.

2: The default number of retries is 2.
dial-retry: Specify a value ranging from 0 through 254.

Top

Switched disconnect (SWTDSC)

Specifies whether the line is dropped when the last switched virtual circuit (SVC) is cleared and the switched disconnect timers (SWTDSCTMRs) have expired.

*SAME: The value does not change.

*YES: The switched connection is dropped.
*NO: The switched connection is not dropped.

Top

Disconnect timers (SWTDSCTMR)

Specifies the timers used for disconnecting switched X.25 lines from the network or remote system. The minimum connect timer specifies the minimum length of time the system keeps the connection active. This timer is started when the connection is established. The disconnect delay timer specifies the length of time the system waits before attempting to disconnect the switched connection when no SVCs are active on the line or the last SVC completes and the minimum-connect-timer has expired.

The possible minimum-connect-timer values are:

*SAME: The value does not change.

min-connect-timer: Specify a value ranging from 0 through 65535 seconds.

The possible disconnect-delay-timer values are:

disconnect-delay-timer: Specify a value ranging from 0 through 65535 seconds.

Top

Data Set Ready drop timer (DSRDRPTMR)

Specifies the amount of time that the system waits for the modem to exit the Data Set Ready (DSR) state before signaling an error.

*SAME: The value does not change.

drop-timer: Specify a value ranging from 1 through 60 seconds.

Top

Autoanswer type (AUTOANSTYP)

Specifies the method that the system uses to answer incoming calls.

*SAME: The value does not change.

*DTR: The system enters the Data Terminal Ready state, signals the modem to answer calls, and waits for the modem to enter the Data Set Ready (DSR) state.
*CDSTL: The system enters the Connect Data Set to Line (CDSTL) state after monitoring the Ring Indicator to signal the modem to answer the call.

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

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

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 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.
*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 *X21, *X21BISV35, and *RS449V36.

Top

Link speed (LINKSPEED)

Specifies the link speed in bits per second (bps). This parameter is valid only if advanced peer-to-peer networking (APPN) is used on the system.

*SAME: The value does not change.

*INTERFACE (SDLC and X.25 only): The link speed is based on the physical interface type: 9600 bps for RS-232/V.24 and X.21 bis/V.24, 48000 bps for V.35 and X.21 bis/V.35, and 64000 bps for X.21.

*MIN: A link speed of less than 1200 bps is used.

*MAX: A link speed greater than 100M bps is used.

link-speed: Specify the link speed. Valid values are: 1200, 2400, 4800, 7200, 9600, 14400, 19200, 48000, 56000, 64000, 128000, 192000, 256000, 320000, 384000, 448000, 499000, 576000, 614000, 691000, 768000, 845000, 922000, 998000, 1075000, 1152000, 1229000, 1382000, 1536000, 1690000, 1843000, 1997000, 4M, 10M, and 16M.

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 selection (SWTNWISLCT)

Specifies the method used to select network interfaces from the switched network interface list.

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

Top

Cost/connect time (COSTCNN)

Specifies the relative cost of being connected on the line. Zero implies a low cost while 255 indicates a high cost. This parameter is valid only if APPN is used on the system.

*SAME: The value does not change.

*CNN (SDLC and IDLC only): The cost per connection time is based on the connection type: Zero for nonswitched connections and 128 for switched connections.
cost-per-connect-time: Specify a value ranging from 0 through 255.

Top

Cost/byte (COSTBYTE)

Specifies the relative cost per byte for sending and receiving data on the line. Zero implies a low cost while 255 indicates a high cost. This parameter is valid only if APPN is used on the system.

*SAME: The value does not change.

*CNN (SDLC and IDLC only): The cost per byte is based on the connection type: Zero for nonswitched connections and 128 for switched connections.
cost-per-byte: Specify a value ranging from 0 through 255.

Top

Security for line (SECURITY)

Specifies the security level of the physical line. This parameter is valid only if APPN is used on the system.

*SAME: The value does not change.

*NONSECURE: There is no security on the line.
*PKTSWTNET: A packet switched network is used. Data does not always follow the same path through the network.
*UNDRGRDCBL: An underground cable is used.
*SECURECND: A secure, but unguarded, conduit is used.
*GUARDCND: A guarded conduit, protected against physical tapping, is used.
*ENCRYPTED: Data flowing on the line is encrypted.

*MAX: A guarded conduit, protected against physical and radiation tapping is used.

Top

Propagation delay (PRPDLY)

Specifies the level of propagation delay on the line. This parameter is valid only if advanced peer-to-peer networking (APPN) is used on the system. The order of the values from shortest to longest delay is *MIN, *LAN, *TELEPHONE, *PKTSWTNET, and *SATELLITE.

*SAME: The value does not change.

*MIN: The minimum propagation delay is used.

*LAN: Propagation delay using a local area network.
*TELEPHONE: Propagation delay using telephone lines.
*PKTSWTNET: Propagation delay using a packet switched network.
*SATELLITE: Propagation delay using satellite communications.

*MAX: The maximum propagation delay is used.

Top

User-defined 1 (USRDFN1)

Specifies the first of the three user-defined fields. This field is used to describe unique characteristics of the line that is controlled. This parameter is valid only if APPN is used on the system.

Note: Information about the values that are specified for this parameter is provided in the APPN information in the Networking category in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/.

*SAME: The value does not change.

user-defined-1: Specify a value ranging from 0 through 255.

Top

User-defined 2 (USRDFN2)

Specifies the second of the three user-defined fields. This field is used to describe unique characteristics of the line that is controlled. This parameter is valid only if APPN is used on the system.

*SAME: The value does not change.

user-defined-2: Specify a value ranging from 0 through 255.

Top

User-defined 3 (USRDFN3)

Specifies the third of the three user-defined fields. This field is used to describe unique characteristics of the line that is controlled. This parameter is valid only if APPN is used on the system.

*SAME: The value does not change.

user-defined-3: Specify a value ranging from 0 through 255.

Top

Recovery limits (CMNRCYLMT)

Specifies the second-level communications recovery limits to be used for this line description.

The possible count-limit values are:

*SAME: The value does not change.

*SYSVAL: The value in the QCMNRCYLMT system value is used.

count-limit: Specify the number of recovery attempts to be performed by the system. Valid values range from 0 through 99.

The possible time-interval values are:

*SAME: The value does not change.

time-interval: Specify the number of minutes within which recovery attempts are made. Valid values range from 0 through 120 in 1-minute intervals.

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

Examples

CHGLINX25   LIND(X251)  LGLCHLE(*PROMPT)  MAXPKTSIZE(512)

This command shows an interactive display listing all current logical channel entries and allows changes to be made to these entries. Maximum packet size will be changed to 512 bytes.

Top

Error messages

*ESCAPE Messages

CPF261E: Line description &1 not changed.

Top