The Change Line Description (Frame-Relay Network) (CHGLINFR) command changes a line description for a frame-relay network (FR) line. More information about using this command is in the Communications Configuration book, SC41-5401.

Parameters

Keyword	Description	Choices	Notes
LIND	Line description	Name	Required, Key, Positional 1
ONLINE	Online at IPL	*SAME, *YES, *NO	Optional
VRYWAIT	Vary on wait	15-180, *SAME, *NOWAIT	Optional
MAXCTL	Maximum controllers	1-256, *SAME, 40	Optional
MAXFRAME	Maximum frame size	265-8182, *SAME, 1590	Optional
LINKSPEED	Link speed	*SAME, 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	Optional
EXCHID	Exchange identifier	05600000-056FFFFF, *SAME, *SYSGEN	Optional
SSAP	SSAP list	Single values: *SAME, *SYSGEN Other values (up to 24 repetitions): Element list	Optional
	Element 1: Source service access point	02-FE
	Element 2: SSAP maximum frame	265-8182, *MAXFRAME, 265, 502, 1014, 2038, 4086, 8182
	Element 3: SSAP type	*CALC, *NONSNA, *SNA, *HPR
COSTCNN	Cost/connect time	0-255, *SAME, 0	Optional
COSTBYTE	Cost/byte	0-255, *SAME, 0	Optional
SECURITY	Security for line	*SAME, *PKTSWTNET, *NONSECURE, *UNDGRDCBL, *SECURECND, *GUARDCND, *ENCRYPTED, *MAX	Optional
PRPDLY	Propagation delay	*SAME, *PKTSWTNET, *MIN, *LAN, *TELEPHONE, *SATELLITE, *MAX	Optional
USRDFN1	User-defined 1	0-255, *SAME, 128	Optional
USRDFN2	User-defined 2	0-255, *SAME, 128	Optional
USRDFN3	User-defined 3	0-255, *SAME, 128	Optional
CMNRCYLMT	Recovery limits	Single values: *SAME, *SYSVAL Other values: Element list	Optional
	Element 1: Count limit	0-99, 2
	Element 2: Time interval	0-120, 5
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.

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.

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:

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.

Maximum controllers (MAXCTL)

Specifies the maximum number of controllers supported by a line.

*SAME

The value does not change.

40

The line supports 40 controllers.

maximum-controllers

Specify a number large enough to account for all controllers currently active to this network, and the controllers that will be attached in the near future. Valid values range from 1 through 256.

Maximum frame size (MAXFRAME)

Specifies the maximum frame (path information unit (PIU)) size that the controller can send or receive. This value is used to calculate request unit (RU) sizes. Since the maximum PIU size that the controller can send or receive is negotiated at exchange identifier time, the maximum PIU size used at run time may be different. This value matches the corresponding value on the host system. The recommended MAXFRAME values are: 502, 1014, 1590, 2038, 4086, and 8182 bytes.

*SAME

The value does not change.

1590

The maximum frame size is 1590 bytes.

maximum-frame-size

Specify the maximum frame size value to be used. Valid values range from 265 through 8182.

Link speed (LINKSPEED)

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

*SAME

The value does not change.

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.

Exchange identifier (EXCHID)

Specifies the hexadecimal exchange identifier that is used to identify the local system to the remote system. The 8-digit hexadecimal exchange identifier contains three digits for the block number and five digits for the identifier of this system.

*SAME

The value does not change.

*SYSGEN

The operating system generates the exchange identifier.

exchange-identifier

Specify (if the *SYSGEN value is not specified) an exchange identifier composed of eight hexadecimal digits starting with 056.

SSAP list (SSAP)

Specifies the source service access point (SSAP). The most commonly used SNA SSAP is hex 04. All SSAP values must be unique.

*SAME

The value does not change.

*SYSGEN

The system automatically creates three SSAPs: hex 04 for Systems Network Architecture (SNA) applications, hex C8 for high-performance routing (HPR) applications, and hex AA for Transmission Control Protocol/Internet Protocol (TCP/IP) applications.

The possible SSAPs value is:

source-service-access-point

Specify a source service access point for receiving and transmitting data. A maximum of 24 SSAP values can be specified.

• For TCP/IP applications, the SSAP must be AA.
• For SNA applications, the SSAP must be a hex value ranging from 04 through 9C in multiples of four (04, 08, 0C, and so on).
• For HPR applications, the SSAP must be hex C8.
• For non-SNA applications, the SSAP must be a hex value ranging from 02 through FE in multiples of two (02, 04, 06, and so on).

The possible Frame Size for SSAPs values are:

*MAXFRAME

The frame size specified on the MAXFRAME parameter is used.

SSAP-maximum-frame

Specify the maximum SSAP frame size (the maximum size of the data field that can be transmitted or received). Valid values for this parameter range from 265 through 8182 bytes.

Note: This value cannot be larger than the value specified on the MAXFRAME parameter.

The possible SSAP Type values are:

*CALC

The system determines the SSAP type based on the following hex values:

• 04 through 9C, divisible by 4 (for SNA)
• C8 (for HPR)
• 02 through FE, divisible by 2 (for non-SNA)

*SNA

The SSAP is used for SNA communications. Valid values range from hex 04 through hex 9C in multiples of four (04, 08, 0C, and so on).

*NONSNA

The SSAP is used for non-SNA communications. Valid values range from hex 02 through hex FE in multiples of two (02, 04, 06, and so on).

*HPR

The SSAP is used for HPR communications. It also can be used for SNA applications. The valid value is hex C8.

Cost/connect time (COSTCNN)

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

*SAME

The value does not change.

0

The cost per connect time is 0.

cost-per-connect-time

Specify a value ranging from 0 through 255.

Cost/byte (COSTBYTE)

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

*SAME

The value does not change.

0

The cost per byte is 0.

cost-per-byte

Specify a value ranging from 0 through 255.

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.

*PKTSWTNET

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

*NONSECURE

Normal priority is used.

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

Propagation delay (PRPDLY)

Specifies the level of propagation delay on the line. This parameter is valid only if 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.

*PKTSWTNET

The packet switched network propagation delay is used.

*LAN

The local area network propagation delay is used.

*MIN

The minimum propagation delay is used.

*TELEPHONE

The telephone propagation delay is used.

*SATELLITE

The satellite propagation delay is used.

*MAX

The maximum propagation delay is used.

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.

*SAME

The value does not change.

128

A value 128 is used.

user-defined-1

Specify a value ranging from 0 through 255.

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.

128

A value 128 is used.

user-defined-2

Specify a value ranging from 0 through 255.

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.

128

A value 128 is used.

user-defined-3

Specify a value ranging from 0 through 255.

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.

2

Two recovery attempts are made within the interval specified.

count-limit

Specify the number of recovery attempts to be made. Valid values range from 0 through 99.

5

A 15-second time-out period is used.

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.

*SYSVAL

The recovery limits specified in the QCMNRCYLMT system value are used.

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.

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.

Examples

CHGLINFR   LIND(FR2)  ONLINE(*NO)  MAXFRAME(4444)
           LINKSPEED(1536000)

This command changes frame relay line FR2 so it does not vary on automatically at initial program load (IPL). The maximum frame size is set to 4444 bytes and the link speed is set to 1536000 bits per second (bps).

Error messages

*ESCAPE Messages

CPF261E

Line description &1 not changed.