CHGLINETH (Change Line Description (Ethernet))

CHGLINETH Command syntax diagram

 

Purpose

The Change Line Description (Ethernet) (CHGLINETH) command changes a line description for an Ethernet Local Area Network (LAN) line. More information about using this command is in the Communications Configuration Link to PDF book.

 

Required Parameters

LIND
Specifies the name of the line description being changed.

 

Optional Parameters

RSRCNAME
Specifies the resource name of the communications port. The resource name consists of the input/output adapter (IOA) resource name and the port number on the IOA. For example, if the resource name of the IOA is LIN01 and the port on the IOA is 1, the resource name is LIN011.

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

*SAME: The value does not change.

*NWID: The resource name is determined by the network interface used.

*NWSD: The resource name is determined by the network server description used.

resource-name: Specify the resource name of the communications port.

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.

ADPTADR
Specifies the 12-character hexadecimal adapter address.

*SAME: The value does not change.

*ADPT: The preset Ethernet adapter address is used as the local adapter address. The adapter address can be displayed by using the DSPLIND command after the line description has been successfully varied on.

 

Notes

  1. This value is not valid when RSRCNAME(*NWID) and NWITYPE(*FR) is specified, or when RSRCNAME(*NWSD) is specified with a Network server port of 1 or 2.

  2. When RSRCNAME(*NWSD) is specified and the Network server port is *VRTETHn where 'n' has a value of 0 through 9, the value must be *ADPT.

  3. When RSRCNAME(*NWSD) is specified and the Network server port is *VRTETHPTP, the value must be *ADPT.

local-adapter-address: Specify the local Ethernet adapter address to override the preset local address. The local adapter address must be an individual address (it cannot be a group address). Valid values range from 020000000000 through FEFFFFFFFFFF in hexadecimal. The second digit (from the left) of the address must be 2, 6, A, or E.

GRPADR
Specifies whether an Ethernet group address is used.

*SAME: The value does not change.

*NONE: A group address is not used.

group-address: Specify the address to which a subset of units on the Ethernet line respond in addition to their local adapter address. Valid values range from 010000000000 through FDFFFFFFFFFF in hexadecimal form. All group addresses must be unique.

MAXCTL
Specifies the maximum number of controllers that the line supports.

*SAME: The value does not change.

maximum-controllers: Specify the maximum number of controllers supported by the line, a number large enough to account for all of the controllers that are currently attached to this line, and for those controllers that will be attached in the near future. Valid values range from 1 through 256.

SSAP
Specifies source service access points (SSAPs). This is the hexadecimal logical address used to route incoming data from the ethernet bus to the proper user. A maximum frame size can be specified for each SSAP.

Note: Ethernet Version 2 (specified as *ETHV2 on the ETHSTD parameter) does not allow the SSAP values of 06 and AA.

The destination service access point (DSAP), specified by the remote controller, must match one of the SSAPs specified in order for communication to occur. All SSAP values must be unique.

Note: It is recommended that SSAPs F0, F8 and FC are not used for lines attached to network server descriptions.

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

Element 1: SSAPs

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 an SSAP value of 12 and an SSAP type of *NONSNA.

Element 2: Frame Size for SSAPs

*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 the maximum frame size for each SSAP. Valid values for the maximum frame size range from 265 through 8996.

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

Element 3: SSAP Type

*CALC: The system determines the SSAP type based on the following values:

  • 04 through 9C, divisible by 4 (for SNA)

  • 02 through FE, divisible by 2 (for non-SNA)

*SNA: The SSAP is used for SNA communications. Only SSAP values of 04 through 9C that are divisible by 4 are supported.

*NONSNA: The SSAP is used for non-SNA Communications. Only SSAP values of 02 through FE and must be divisible by 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.

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.

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

*SAME: The value does not change.

Element 1: Virtual Path Identifier

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

Element 2: Virtual Circuit Identifier

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

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.

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

Note: This parameter must be other than *NONE if USELECSADR(*NO) is specified.

*SAME: The value does not change.

Single Value

*NONE: ATM network address is not used.

Element 1: Network prefix

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

Element 2: End system identifier

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

Element 3: Selector byte

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

EMLLANNAME
Specifies the emulated LAN name.

*SAME: The value does not change.

*NONE: Emulated LAN name not used.

emulated-LAN-name: Specify the emulated LAN name. A maximum of 32 characters may be specified.

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

*SAME: The value does not change.

*NOMAX: The LE client will wait indefinitely.

LEC-disconnect-timeout: Specify the number of minutes the LE client will wait before disconnecting an idle virtual circuit connection to another client. The value must be in the range of 1 to 30 minutes.

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.

DUPLEX
Specifies whether the hardware can send and receive data simulateously. In half duplex mode, the hardware must alternate between sending data and receiving data. In full duplex mode, one cable is dedicated to send data and another cable is dedicated to receive data. Therefore, data can be sent and received simultaneously. A hub is required for full duplex.

*SAME: The value does not change.

*HALF: The line communicates using half duplex mode.

*FULL: The line communicates using full duplex mode.

Note: DUPLEX must be *FULL for NWS *VRTETHxxx ports.
>

*AUTO: The duplex value will be determined by the hardware using auto-negotiation.

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

*SAME: The value does not change.

maximum-frame-size: Specify the maximum frame size value to be used. The valid frame sizes (in bytes) range from 1496 through 8996 bytes.

Note: When RSRCNAME(*NWID) or RSRCNAME(*NWSD) is specified, the only valid value for this parameter is 1496 bytes. When ETHSTD(*ALL) or ETHSTD(*IEEE8023) is specified, the valid values can range from 1496 bytes to 8996 bytes. However, if the maximum frame size is greater than 1496 bytes, LINESPEED(1G), DUPLEX(*FULL) or DUPLEX(*AUTO) must be specified.

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

*SAME: The value does not change.

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). Gigabit ethernet will only run on the TCP/IP protocol.

Note: Line speed must be 1G for NWS *VRTETHxxx ports.
>

*AUTO: The line speed value will be determined by the hardware using auto-negotiation.

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.

4M: The link speed is 4M bits per second.

10M: The link speed is 10M bits per second.

100M: The link speed is 100M bits per second.

*MIN: The minimum link speed is used.

*MAX: The maximum link speed is used.

link-speed: Specify the link speed. Valid values range from 1200 to 603979776000.

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.

*LAN: The local area network propagation delay is used.

*MIN: The minimum 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.

AUTOCRTCTL
Specifies whether the system will automatically create controller descriptions when calls are received from adjacent systems on the local area network (LAN).

*SAME: The value does not change.

*NO: The system will not automatically create a controller description when incoming calls are received.

*YES: The system will automatically create a controller description when incoming calls are received.

AUTODLTCTL
Specifies the number of minutes an automatically created controller can remain in an idle state (switched from varied on to varied on pending) before the controller description and attached device descriptions are varied off and deleted.

*SAME: The value does not change.

*NONE: The system will not automatically delete or vary off the automatically configured, idle controller descriptions.

wait-time: Specify the number of minutes to wait before deleting the automatically configured, idle controller descriptions for this line. Valid values range from 1 to 10,000 minutes.

MSGQ
Specifies the qualified name of the message queue to which messages are sent. More information about using this parameter is in the Communications Management Link to PDF book.

Single Values

*SAME: The value does not change.

*SYSVAL: Messages are sent to the message queue defined in the system value QCFGMSGQ.

*SYSOPR: Messages are sent to the system operator message queue (QSYS/QSYSOPR).

library-name/message-queue-name: Specify the library-qualified name of the message queue to which operational messages are sent.

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.

Examples for CHGLINETH

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 for CHGLINETH

*ESCAPE Messages

CPF261E
Line description &1 not changed.