Change Line Desc (Ethernet) (CHGLINETH)

The Change Line Description (Ethernet) (CHGLINETH) command changes a line description for an Ethernet line. More information about using this command is in the Communications Configuration book, SC41-5401.

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, *AGG, *NWID, *NWSD Optional
BRIDGE Bridge identifier Name, *SAME, *NONE Optional
ONLINE Online at IPL *SAME, *YES, *NO Optional
VRYWAIT Vary on wait 15-180, *NOWAIT, *SAME Optional
AGGPCY Aggregate policy Single values: *SAME
Other values: Element list
Optional
Element 1: Standard *ETHCHL, *LNKAGG
Element 2: Policy type *DFT, *SRCPORT, *DESTPORT, *SRCDESTP, *RNDRBN
AGGRSCL Aggregated resource list Values (up to 8 repetitions): Name, *SAME Optional
ASSOCPORT Associated port resource name Name, *SAME, *NONE Optional
ADPTADR Local adapter address Character value, *SAME, *ADPT Optional
GRPADR Group address Single values: *SAME, *NONE
Other values (up to 12 repetitions): 010000000000-FDFFFFFFFFFF
Optional
MAXCTL Maximum controllers 1-256, *SAME 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-8996, *MAXFRAME, 265, 521, 1033, 1466, 1493, 1496, 8996
Element 3: SSAP type *CALC, *NONSNA, *SNA, *HPR
THRESHOLD Error threshold level *SAME, *OFF, *MIN, *MED, *MAX Optional
GENTSTFRM Generate test frame *SAME, *YES, *NO Optional
PVCID PVC identifiers Single values: *SAME
Other values: Element list
Optional
Element 1: Virtual path identifier 0-7
Element 2: Virtual circuit identifier 32-4095
USELECSADR Use LECS address *SAME, *YES, *NO Optional
LESATMADR LES ATM address Single values: *SAME, *NONE
Other values: Element list
Optional
Element 1: Network prefix Hexadecimal value
Element 2: End system identifier Hexadecimal value
Element 3: Selector byte Hexadecimal value
EMLLANNAME Emulated LAN name Character value, *SAME, *NONE Optional
LECDSCTIMO LEC disconnect time out 1-30, *SAME, *NOMAX Optional
LINKSPEED Link speed 1200-603979776000, *MIN, *SAME, 4M, 10M, 16M, 100M, *MAX Optional
LINESPEED Line speed *SAME, 10M, 100M, 1G, 10G, *AUTO Optional
DUPLEX Duplex Character value, *SAME, *HALF, *FULL, *AUTO Optional
SRVOPT Serviceability options Character value, *SAME, *NONE Optional
MAXFRAME Maximum frame size 1496-8996, *SAME, 1496, 8996 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, *LAN, *MIN, *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
AUTOCRTCTL Autocreate controller *YES, *NO, *SAME Optional
AUTODLTCTL Autodelete controller 1-10000, *NONE, *SAME 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

Line description (LIND)

Specifies the name of the line description

This is a required parameter.

Resource name (RSRCNAME)

Specifies the resource name that identifies the communications port.

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.

Note: The value specified on the RSRCNAME parameter cannot be changed from *NWSD to another value or from another value to *NWSD.

Note: The value specified on the RSRCNAME parameter cannot be changed from *AGG to another value or from another value to *AGG.

*SAME
The value does not change.
*AGG
The resource name specified is an aggregate line. It represents one or more physical resources.
*NWID
The resource name specified on the attached frame relay network interface description is used.
*NWSD
The resource name is determined by the network server used.
name
Specify the resource name of the communications port.

This is a required parameter.

Bridge identifier (BRIDGE)

Specifies the bridge identifier this Ethernet line description is associated with.

A bridge identifier allows a server partition to effectively share a single physical Ethernet adapter with several client partitions, each of which has only a virtual Ethernet adapter. Not all Ethernet line descriptions support bridging.

*SAME
The value does not change.
*NONE
This line description is not associated with any bridge.
name
Specify the name of the bridge identifier that this Ethernet line description is associated with.

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.

Aggregate policy (AGGPCY)

Specifies the standard used to configure aggregated resource names, and what policy used for load-balancing outgoing Ethernet frames.

Note: This parameter is only valid when *AGG is specified on the Resource name (RSRCNAME) parameter to configure an aggregate line.

Single values:

*SAME
The value does not change.

Element 1: Standard

*ETHCHL
Specifies to use Etherchannel technology to allow several Ethernet adapters to be aggregated together to form a single psuedo Ethernet device.
*LNKAGG
Specifies to use IEEE 802.3ad Link Aggregation technology to allow several Ethernet adapters to be aggregated together to form a single psuedo Ethernet device.

Element 2: Policy type

*DFT
The adapter selection algorithm uses the last byte of the Destination IP address (for TCP/IP traffic) or MAC address (for ARP and other non-IP traffic). This mode is typically the best initial choice for a server with a large number of clients.
*SRCPORT
The adapter selection algorithm uses the source TCP/IP or UDP port value.
*DESTPORT
The outgoing adapter path is selected via an algorithm using the destination TCP/IP or UDP port value.
*SRCDESTP
The outgoing adapter path is selected via an algorithm using the combined source and destination TCP or UDP port values.
*RNDRBN
Outgoing traffic is spread evenly across all the adapter ports in the Etherchannel. This mode is the typical choice for two host connected back-to-back (i.e. without a intervening switch).

Aggregated resource list (AGGRSCL)

Specifies the aggregated resource names associated with the communication ports that compose an aggregate line (a line description that uses Etherchannel or IEEE802.3ad Link Aggregation). Up to 8 resource names may be specified.

Note: Use the Work with Hardware Resources (WRKHDWRSC) command with TYPE(*CMN) to help determine the resource name. The resource name is the name associated with the Ethernet port.

Note: This parameter is only valid when *AGG is specified on the Resource name (RSRCNAME) parameter to configure an aggregate line.

aggregated-resource
Specify the aggregated resource names to be used.
*SAME
The value does not change.

Associated port resource name (ASSOCPORT)

Specifies the resource name that describes the port that is used to establish a connection between a Windows network server and the network.

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.

Note: ASSOCPORT parameter is only valid when RSRCNAME(*NWSD) is specified.

*SAME
The value does not change.
*NONE
An associated port resource name is not associated with the line.
name
Specify the resource name.

Local adapter address (ADPTADR)

Specifies the 12-character hexadecimal adapter address.

*SAME
The value does not change.
*ADPT
The preset default address for this Ethernet adapter card is used.

Note: This value is not valid when RSRCNAME(*NWID) and NWITYPE(*FR) is specified.

Note: *ADPT must be specified when the NWS parameter specifies a virtual ethernet port number, *VRTETHPTP or *VRTETHn where n is 0-9.

local-adapter-address
Specify an adapter address of your choice to describe this system in the Ethernet network. The value specified must be an individual address that is locally administered. Valid values are *ADPT or hexadecimal 020000000000 through FEFFFFFFFFFF. The second digit must be 2, 6, A, or E.

Group address (GRPADR)

A group address is an address to which a subset of nodes on the Ethernet line will respond in addition to their local adapter addresses.

*SAME
The value does not change.
*NONE
No group addresses are defined.
group-address
Specify a group address of your choice to describe this system in the Ethernet network. Valid values are hexadecimal 010000000000 through FDFFFFFFFFFF. The second digit of the value specified must be 1, 3, 5, 7, 9, B, D, or F. Up to 12 addresses may be specified.

Maximum controllers (MAXCTL)

Specifies the maximum number of controllers that the line supports.

*SAME
The value does not change.
40
The number of controllers is 40.
maximum-controllers
Specify value ranging from 1 to 256. The number must be large enough to account for all of the SNA controllers that are currently active to this line, and for those controllers you know will be attached in the near future.

SSAP list (SSAP)

Specifies the source service access point (SSAP) information, including an SSAP value, a maximum frame size, and an SSAP type.

You can enter multiple values for this parameter.

The possible source service access point values are:

*SAME
The value does not change.
*SYSGEN
The system determines the source service access points.
  • If ETHSTD(*ALL) or ETHSTD(*IEEE8023) is specified, the system generates the SSAPs 04, 12, AA, and C8.
  • If ETHSTD(*ETHV2) is specified, the system generates the SSAPs 04 and 08
source-service-access-point
Specify a service access point for receiving and transmitting data. The SSAP must be hexadecimal 06 or AA for TCP/IP applications if ETHSTD is *ALL or *IEEE8023 (06 and AA are not allowed when ETHSTD is *ETHV2; however, TCP/IP can still be run). For SNA applications, specify a value ranging from 04 through 9C in multiples of four. For example, 7C is a valid choice. For non-SNA applications, specify a value ranging from 02 through FE in multiples of 2.

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 Transmission Control Protocol/Internet Protocol (TCP/IP) applications, the SSAP must be AA.

    Note: If ETHSTD(*ETHV2) is specified, AA cannot be specified. However, TCP/IP can be run.

    For Systems Network Architecture (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 high-performance routing (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).
  • For LAN printing applications, specify a SSAP value of 12 with SSAP type of *NONSNA.

The possible SSAP maximum frame size values are:

*MAXFRAME
The system determines the maximum frame size (data field size) that can be transmitted or received. If ETHSTD(*ALL or *IEEE8023) was specified, *CALC produces a frame size of 1496 for TCP/IP and SNA SSAPs. If ETHSTD(*ETHV2) was specified, *CALC produces a frame size of 1493 for SNA SSAPs.
SSAP-maximum-frame
Specify a maximum frame size for this SSAP. Valid values range from 265 through 8996 (265 through 1493 for SNA SSAPs when *ETHV2 is specified on the Ethernet standard (ETHSTD) parameter).

Note: When *NWID is specified on the Resource name (RSRCNAME) parameter and *ETHV2 is specified on the ETHSTD parameter, the valid values for this parameter range from 265 through 1486 bytes. When *NWID is specified on the RSRCNAME parameter, and *ALL or *IEEE8023 is specified on the ETHSTD parameter, the valid values for this parameter range from 265 through 1489 bytes. Maximum frame size larger than 1486 or 1489 is valid only when AA SSAP for TCP/IP is specified.

The possible SSAP type values are:

*CALC
The system determines the SSAP type based on the SSAP value specified.
*SNA
The system uses IBM's Systems Network Architecture for communication. Only SSAP values of 04 through 9C in multiples of 4 are supported.
*NONSNA
The system does not use SNA communications. Only SSAP values of 02 through FE in multiples of 2 are supported.
*HPR
The SSAP is used for HPR communications. It also can be used for SNA applications. The valid value is hex C8.

Error threshold level (THRESHOLD)

This parameter, and its values *SAME, *OFF, *MIN, *MED, and *MAX, can be specified but it is not used by the system starting in release V2R3M0. The parameter may be removed in a later release.

*SAME
The value does not change.

Generate test frame (GENTSTFRM)

Specifies whether the system will automatically generate test frames to determine network availability.

*SAME
The value does not change.
*YES
The system will generate test frames.
*NO
The system will not generate test frames.

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.

PVC identifiers (PVCID)

Specifies the virtual path identifier and virtual circuit identifier pairs associated with this permanent virtual circuit.

*SAME
The value does not change.

The possible Virtual Path Identifier value is:

virtual-path-id
Specify a number that represents the virtual path identifier. This number must be in the range of 0 to 7.

The possible Virtual Circuit Identifier value is:

virtual-circuit-id
Specify a number that represents the virtual circuit identifier. This number must be in the range of 32 to 4095.

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.

Use LECS address (USELECSADR)

Specifies whether the LAN emulation configuration server (LECS) should be connected to request the remote LAN emulation server (LES) address.

*SAME
The value does not change.
*YES
The LECS address is used.
*NO
The LECS address is not used.

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.

LES ATM address (LESATMADR)

Specifies the ATM network address of the remote LAN emulation server.

Note: This parameter cannot be *NONE if USELECSADR(*NO) is specified.

*SAME
The value does not change.

The possible Single Value is:

*NONE
The ATM network address is not used.

The possible Network prefix value is:

network-prefix
Specify the network prefix of the ATM address of the remote server. This is a 26 digit hexadecimal value.

The possible End system identifier value is:

end-system-identifier
Specify the end system identifier of the remote server. This is a 12 digit hexadecimal value.

The possible Selector byte value is:

selector byte
Specify the selector byte of the remote server. This is a two digit hexadecimal value.

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.

Emulated LAN name (EMLLANNAME)

Specifies the emulated LAN name.

*SAME
The value does not change.
*NONE
The emulated LAN name not used.
emulated-LAN-name
Specify the emulated LAN name. A maximum of 32 characters can be specified.

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.

LEC disconnect time out (LECDSCTIMO)

Specifies the amount of time in minutes a LAN emulation (LE) client waits before disconnecting an idle virtual circuit connection to another client.

*SAME
The value does not change.
*NOMAX
The LE client waits indefinitely.
LEC-disconnect-timeout
Specify the number of minutes the LE client waits before disconnecting an idle virtual circuit connection to another client. The value must be in the range of 1 to 30 minutes.

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.
10M
The link speed is 10 million bits per second.
4M
The link speed is 4 million bits per second.
16M
The link speed is 16 million bits per second.
100M
The link speed is 100 million bits per second.
*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 range from 1200 to 603979776000 bps.

Line speed (LINESPEED)

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

*SAME
The value does not change.
*AUTO
The line speed value will be determined by the hardware using auto-negotiation.
10M
The line speed is 10 million bits per second.
100M
The line speed is 100 million bits per second.
1G
The line speed is 1 gigabit per second(1000 million bits per second).
10G
The line speed is 10 gigabits per second(10000 million bits per second).

Note: The values 1G and 10G specify gigabit Ethernet. Gigabit Ethernet is only available when running strictly TCP/IP protocol. 1G or 10G must be specified when the NWS parameter specifies a virtual Ethernet port number, *VRTETHPTP or *VRTETHn where n is 0-9.

Note: When specifying *AGG for the Resource name (RSRCNAME) parameter to configure an aggregate line, all aggregated resources must be capable of running at the specified speed.

Duplex (DUPLEX)

Specifies whether the hardware can send and receive data simultaneously. In half duplex mode, the hardware must alternate between sending data and receiving data. In full duplex mode, data can be sent and received simultaneously.

Note: For optimum performance, this setting should match the setting on the switch or hub this line is connected to. Refer to IBM i Information Center at http://www.ibm.com/systems/i/infocenter/ for more information.

*SAME
The value does not change.
*AUTO
The duplex value will be determined by the hardware using auto-negotiation.
*HALF
The line communicates using half duplex mode.
*FULL
The line communicates using full duplex mode.

Note: *FULL must be specified when the NWS parameter specifies a virtual ethernet port number, *VRTETHPTP or *VRTETHn where n is 0-9.

Note: *HALF cannot be specified when specifying *AGG for the Resource name (RSRCNAME) parameter to configure an aggregate line.

Serviceability options (SRVOPT)

Specifies serviceability options. This parameter allows serviceability options to be provided and is intended to be used under the direction of a service provider.

*SAME
The value does not change.
*NONE
No serviceability options provided.
character-value
Specify a value as directed by your service provider.

Maximum frame size (MAXFRAME)

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

*SAME
The value does not change.
1496
The maximum frame size is 1496 bytes.
maximum-frame-size
Specify the maximum frame size value to be used. The valid frame sizes (in bytes) range from 1496 through 8996.

Note: When RSRCNAME(*NWID) specified, the only valid value for this parameter is 1496 bytes. If the maximum frame size is greater than 1496 bytes, LINESPEED(1G) or LINSPEED(*AUTO) and DUPLEX(*FULL) or DUPLEX(*AUTO) must be specified. 8996 is recommended when the NWS parameter specifies a virtual ethernet port number, *VRTETHPTP or *VRTETHn where n is 0-9.

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

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.
*LAN
Propagation delay using a local area network.
*MIN
The minimum propagation delay is used.
*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.

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.

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.

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

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-3
Specify a value ranging from 0 through 255.

Autocreate controller (AUTOCRTCTL)

Specifies whether the system automatically creates an advanced program-to-program communications (APPC) controller description when an incoming advanced peer-to-peer networking (advanced peer-to-peer networking (APPN)) call is received from an adjacent system on the Local Area Network (LAN).

*SAME
The value does not change.
*NO
A controller description is not automatically created for this line.
*YES
A controller description is automatically created for this line.

Autodelete controller (AUTODLTCTL)

Specifies how many minutes the system waits before automatically varying off and deleting automatically created advanced program-to-program communications (APPC) controller descriptions (associated with this line) which have gone to an idle state.

*SAME
The value does not change.
*NONE
The controller descriptions for this line are not automatically deleted.
auto-delete-controller
Specify a value ranging from 1 through 10000 minutes. The value 1440 is 24 hours.

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.

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

Example 1: Changing an Ethernet Line Description

CHGLINETH   LIND(BOSTON)  RSRCNAME(LIN041)

This command changes the resource name of an Ethernet line description named BOSTON to LIN041.

Example 2: Changing an Ethernet Line Description

CHGLINETH   LIND(LINETH)  MAXFRAME(1496)

This command changes the maximum frame size of the Ethernet line description to 1496 bytes.

Error messages

*ESCAPE Messages

CPF261E
Line description &1 not changed.