CHGLINWLS

CHGLINWLS (Change Line Description (Wireless))

CHGLINWLS Command syntax diagram

Purpose

The Change Line Description (Wireless) (CHGLINWLS) command changes a line description for a wireless local area network (LAN) line.

Note: Extended wireless line configuration data is contained in the source file and member specified on the INZFILE and INZMBR parameters, respectively. When the line is varied on, this configuration data is downloaded to the wireless adapter. It is recommended that INZPGM(QZXCINZ) and INZFILE(QEWLSRC) be used, and that a source member containing configuration initialization data be specified on the INZMBR parameter. For more information about downloading extended wireless line configuration data, see the LAN, Frame-Relay and ATM Support
book.

More information about using this command is in the Communications Configuration
book.

Required Parameters

LIND

Specifies the name of the line description being changed.

Optional Parameters

RSRCNAME

Specifies the resource name of 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 a "Token-ring port".
The value specified on the RSRCNAME parameter cannot be changed from *NWID to another value or from another value to *NWID.

*SAME: The value does not change.
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

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.

ADPTADR

Specifies the 12-character hexadecimal adapter address.
*SAME: The value does not change.
*ADPT: The preset wireless 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.
local-adapter-address: Specify the local wireless 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 format. The second digit (from the left) of the address must be 2, 6, A, or E.

GRPADR

Specifies whether to include the adapter as part of a wireless group address. This address is used to identify all adapters on the wireless network that have the same group address.
*SAME: The value does not change.
*NONE: A group address is not used.
group-address: Specify the address of the group of adapters to which the local adapter is added. 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. This should be a number large enough to account for all of the controllers that are currently attached to this line, and for those controllers that are to 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.
*SAME: The value does not change.
*SYSGEN: For ETHSTD(*ALL or *IEEE8023), the iSeries 400 creates three SSAPs: hex 04 for SNA applications, and hex AA and 06 for TCP/IP applications. For ETHSTD(*ETHV2), the system creates hex 04 for SNA.
Element 1: SSAPs
source-service-access-point: Specify up to 20 SSAPs. Valid values are hex AA and hex 06 for TCP/IP applications, and any hexadecimal number ranging from 04 through 9C that is divisible by 4 for SNA applications.
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) is specified, *CALC produces a frame size of 1496 for TCP/IP and SNA SSAPs. If ETHSTD(*ETHV2) is specified, *CALC produces a frame size of 1493 for SNA SSAPs.
SSAP-maximum-frame: Specify the maximum frame size for each SSAP.
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 communications other than 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 communications other than SNA communications. Valid SSAP values range from 02 through FE and must be divisible by 2.

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: A link speed of 4 million bps is used.
*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.

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.
*ENCRYPTED: Data flowing on the line is encrypted.

PRPDLY

Specifies the level of propagation delay on the line. This parameter is valid only if APPN support is used on the system.
*SAME: The value does not change.
*LAN: The local area network propagation delay is used.
*MIN: The minimum 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.

Note: Information about the values that are specified for this parameter is provided in the Communications Configuration book.

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

Note: Information about the values that are specified for this parameter is provided in the Communications Configuration book.

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

Note: Information about the values that are specified for this parameter is provided in the Communications Configuration book.

*SAME: The value does not change.
user-defined-3: Specify a value ranging from 0 through 255.

AUTOCRTCTL

Specifies whether the system automatically creates controller descriptions when calls are received from adjacent systems on the local area network (LAN).
*SAME: The value does not change.
*NO: The system does not automatically create a controller description when incoming calls are received.
*YES: The system automatically creates 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 does 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 through 10000 (in minutes).

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.

INZFILE

Specifies the name of a source file containing configuration initialization data.

Note: The INZFILE and INZMBR parameters are required when downloading extended wireless line configuration data to the wireless adapter as discussed at the beginning of this command description.

*SAME: The value does not change.
*NONE: No line is specified.
The name of the initialization file can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

initialization-file-name: Specify the name of a source file containing the initialization data. A value of *NONE is accepted for this parameter. If a source file name has not been added prior to varying on this line description, then the current IOP defaults are used for initialization.

INZMBR

Specifies the name of a source file member containing configuration initialization data.

Note: The INZFILE and INZMBR parameters are required when downloading extended wireless line configuration data to the wireless adapter as discussed at the beginning of this command description.

*SAME: The value does not change.
*NONE: No source file member is specified.
initialization-member-name: Specify the name of a source file member containing the initialization data. A value of *NONE is accepted for this parameter. If a source member name has not been added prior to varying on this line description, then the current IOP defaults are used for initialization.

INZPGM

Specifies the name of a program to manage configuration initialization data.

Note: For 2663 wireless adapters, it is recommended that INZPGM(QZXCINZ) be specified. This results in the values of INZFILE and INZMBR being passed to the Change Extended Wireless Line Member (CHGEWLM) command when the line is varied on.

*SAME: The value does not change.
*NONE: No initialization file is specified.
The name of the initialization program can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

initialization-program-name: Specify the name of a program to manage configuration initialization data. If a program name is specified, it is called whenever this line description is changed. The names of the source file and member containing configuration initialization data are passed to this program as parameters.

TEXT

Specifies the text that briefly describes the line description. 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 CHGLINWLS
CHGLINWLS LIND(MYLINE) INZFILE(*LIBL/MYFILE) INZMBR(MBR1)

This command adds a source file and source member, containing configuration initialization data to a wireless line description named MYLINE.
Error messages for CHGLINWLS
None