CHGLINIDLC (Change Line Description (IDLC))

CHGLINIDLC Command syntax diagram

 

Purpose

The Change Line Description (IDLC) (CHGLINIDLC) command changes a line description for an Integrated Services Digital Network (ISDN) Data Link Controller (IDLC) line.

 

Required Parameters

LIND

Specifies the name of the line description being changed.

 

Optional Parameters

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

*NO: This line is not 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.

*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

1. 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.
   
2. 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.

SWTNWILST

Specifies, for ISDN switched connections, a list of network interface descriptions to which this line can be attached. The first available network description is chosen from the list when an incoming or outgoing call is processed.

*SAME: The list does not change.

*NONE: A network interface description is not specified for this line.

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 the channel number (based on availability) defined for the network interface description when an incoming or outgoing call is processed.

nwi-channel-number: Specify the channel number. Valid values are 1 and 2.

SWTCNN

Specifies whether the switched 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.

CNNLSTIN

Specifies the name of the connection list that is used to retrieve call or connection information 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). Use the Display Network Attributes (DSPNETA) command to see the name of the default ISDN connection list (DFTCNNLST) parameter that is used.

connection-list-name: Specify the name of the connection list used for this line description.

LINESPEED

Specifies the line speed in bits per second (bps).

*SAME: The value does not change.

line-speed: Specify the line speed. Valid values are: 56000 and 64000 bps.

THRESHOLD

Specifies the threshold for the number of errors beyond which a message is sent informing the user that errors have occurred. All error threshold parameters are set to the value specified, unless *SELECT is specified, in which case each error threshold parameter is set individually. The next five parameters are the threshold parameters. They are: CRCRCV, OVERRUN, UNDERRUN, ABORTS, and SHORTFRAME.

*SAME: The value does not change.

*OFF: No monitoring of errors occurs.

*MIN: The error threshold is set at a minimum monitoring level.

*MED: The system performs a medium amount of error threshold monitoring for all types of errors.

*MAX: The error threshold is set at a maximum monitoring level.

*SELECT: The threshold for the number of errors beyond which a message is sent informing the user that errors have occurred is set individually for each parameter.

CRCRCV

Specifies the level of error threshold monitoring done by the system for Cyclic Redundancy Check (CRC) errors.

*SAME: The value does not change.

*OFF: No monitoring of errors occurs.

*MIN: The system performs a minimum amount of error threshold monitoring for CRC errors: 6 errors in the first 30 seconds or 180 errors in any 15 minutes. The system is more tolerant of errors than if *MED or *MAX is specified.

*MED: The system performs a medium amount of error threshold monitoring for CRC errors: 2 errors in the first 30 seconds or 60 errors in any 15 minutes.

*MAX: The system performs the maximum amount of error threshold monitoring for CRC errors received.

threshold-value: Specify a value ranging from 1 through 10000. The number represents the number of errors received in a 15-minute interval.

SHORTFRAME

Specifies the threshold for the level of errors for short frame errors received.

*SAME: The value does not change.

*OFF: No monitoring of errors occurs.

*MIN: A minimum of monitoring is done: 6 X.25 or SDLC frames received in the first 30 seconds or 1 received every second for 14 minutes. The system is more tolerant of errors than if *MED or *MAX is specified.

*MED: A medium amount of monitoring is done: 3 X.25 or SDLC frames received in the first 30 seconds or 1 received every 3 seconds for 10-14 minutes.

*MAX: A maximum amount of monitoring is done.

threshold-level: Specify a threshold level. Valid values range from 1 through 10000. The number represents the number of errors received in a 15-minute interval.

OVERRUN

Specifies the level of error threshold monitoring done by the system for overrun errors.

*SAME: The value does not change.

*OFF: No monitoring of errors occurs.

*MIN: The system performs a minimum amount of error threshold monitoring for buffer overrun errors: 2 errors in the first 90 seconds or 20 errors in any 15 minutes. The system is more tolerant of errors than if *MED or *MAX is specified.

*MED: The system performs a medium amount of error threshold monitoring for buffer overrun errors: 2 errors in the first 300 seconds or 6 errors in any 15 minutes.

*MAX: The system performs the maximum amount of error threshold monitoring for buffer overrun errors.

threshold-value: Specify a value ranging from 1 through 3000. The number represents the number of errors received in a 15-minute interval.

UNDERRUN

Specifies the level of error threshold monitoring done by the system for buffer underrun errors.

*SAME: The value does not change.

*OFF: No monitoring of errors occurs.

*MIN: The system performs a minimum amount of error threshold monitoring for buffer overrun errors: 2 errors in the first 90 seconds or 20 errors in any 15 minutes. The system is more tolerant of errors than if *MED or *MAX is specified.

*MED: The system performs a medium amount of error threshold monitoring for buffer overrun errors: 2 errors in the first 300 seconds or 6 errors in any 15 minutes.

*MAX: The system performs the maximum amount of error threshold monitoring for buffer underrun errors.

threshold-value: Specify a value ranging from 1 through 3000. The number represents the number of errors received in a 15-minute interval.

ABORTS

Specifies the level of error threshold monitoring done by the system for aborted frames.

*SAME: The value does not change.

*OFF: No monitoring of errors occurs.

*MIN: The system performs a minimum amount of error threshold monitoring for aborted frames received: 6 errors in the first 30 seconds or 180 errors in any 15 minutes. The system is more tolerant of errors than if *MED or *MAX is specified.

*MED: The system performs a medium amount of error threshold monitoring for aborted frames received: 2 errors in the first 30 seconds or 60 errors in any 15 minutes.

*MAX: The system performs the maximum amount of error threshold monitoring for aborted frames received.

threshold-value: Specify a value ranging from 1 through 5000. The number represents the number of errors received in a 15-minute interval.

RETRANSMIT

Specifies the threshold for the number of frame retransmissions beyond which a message is sent informing the user that errors have occurred.

*SAME: The value does not change.

*OFF: Error threshold monitoring is turned off for retransmitted frames.

*MIN: The system performs the minimum amount of error threshold monitoring for retransmitted frames: 5 errors in the first 30 seconds or 150 errors in any 15 minutes. The system is more tolerant of errors than if *MED or *MAX is specified.

*MED: The system performs a medium amount of error threshold monitoring for retransmitted frames: 2 errors in the first 60 seconds or 30 errors in any 15 minutes.

*MAX: The error threshold is set at a maximum monitoring level.

threshold-value: Specify a number, ranging from 1 through 10000, that corresponds to the number of errors allowed in a 15-minute interval.

FRMSEQERR

Specifies the threshold for the number of frame sequence errors beyond which a message is sent informing the user that errors have occurred.

*SAME: The value does not change.

*OFF: Error threshold monitoring is turned off for frame sequence errors.

*MIN: The system performs the minimum amount of error threshold monitoring for frame sequence errors: 2 errors in the first 90 seconds or 20 errors in any 15 minutes. The system is more tolerant of errors than if *MED or *MAX is specified.

*MED: The system performs a medium amount of error threshold monitoring for frame sequence errors: 2 errors in the first 300 seconds or 6 errors in any 15 minutes.

*MAX: The system performs the maximum amount of error threshold monitoring for frame sequence errors.

threshold-value: Specify a number, ranging from 1 through 3000, that corresponds to the number of errors allowed in a 15-minute interval.

IDLCWDWSIZ

Specifies the default window size.

*SAME: The value does not change.

*CNN: The value is determined according to the value specified on the CNN parameter.

default-window-size: Specify a value ranging from 1 through 31.

IDLCFRMRTY

Specifies the maximum number of retransmissions before reporting an error.

*SAME: The value does not change.

*CNN: The value is determined according to the value specified on the CNN parameter.

frame-retry: Specify a value ranging from 0 through 100.

IDLCRSPTMR

Specifies the amount of time to wait before retransmitting a frame when an acknowledgement has not been received.

*SAME: The value does not change.

*CNN: The value is determined according to the value specified on the CNN parameter.

response-timer: Specify a value ranging from 10 through 100 tenths of seconds. For example, 100 tenths of seconds equals 10 seconds.

IDLCCNNRTY

Specifies the number of times a transmission can be retried at connection time. Specifying *NOMAX indicates to try until successful.

*SAME: The value does not change.

*CNN: The value is determined according to the value specified on the CNN parameter.

*NOMAX: There is no disconnect limit.

connect-retry-count: Specify a value ranging from 1 through 100.

MAXFRAME

Specifies the maximum frame size that can be transmitted and received on this line description.

*SAME: The value does not change.

max-frame: Specify a value ranging from 265 through 8196.

INFTRFTYPE

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

*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 bits per second (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.

LINKSPEED

Specifies the link speed in bits per second (bps). This parameter is valid only if APPN* support is used on the system.

*SAME: The value does not change.

*MIN: The minimum link speed is used.

*MAX: The maximum link speed is used.

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

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.

COSTCNN

Specifies the relative cost of being connected on the line. This parameter is required only if APPN* support is used on the system.

*SAME: The value does not change.

cost-per-connect-time: Specify a value ranging from 0 through 255.

COSTBYTE

Specifies the relative cost per byte for sending and receiving data on the line. This parameter is required only if APPN* support is used on the system.

*SAME: The value does not change.

cost-per-byte: Specify a value ranging from 0 through 255.

SECURITY

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

*SAME: The value does not change.

*NONSECURE: Normal priority is used.

*PKTSWTNET: A packet switched network is used. Data does not always follow the same path through the network.

*UNDGRDCBL: An underground cable is used.

*SECURECND: A secure, unguarded conduit (for example, a pressurized pipe) is used.

*GUARDCND: A guarded conduit, which is 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.

PRPDLY

Specifies the level of propagation delay on the line. This parameter is valid only if APPN* support 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: The local area network propagation delay is used.

*TELEPHONE: The telephone propagation delay is used.

*PKTSWTNET: The packet switched network propagation delay is used.

*SATELLITE: The satellite propagation delay is used.

*MAX: The maximum propagation delay is used.

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* support is used on the system.

*SAME: The value does not change.

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

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* support is used on the system.

*SAME: The value does not change.

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

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.

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

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.

Example for CHGLINIDLC

CHGLINIDLC   LIND(IDLCLINE)  ONLINE(*NO)

This command changes the online parameter to *NO. description named IDLCLINE to LIN011

Error messages for CHGLINIDLC

*ESCAPE Messages

CPF261E

Line description &1 not changed.