Change Ctl Desc (Local WS) (CHGCTLLWS)

The Change Controller Description (Local Work Station) (CHGCTLLWS) command changes a controller description for a local work station controller.

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

Parameters

Keyword	Description	Choices	Notes
CTLD	Controller description	Name	Required, Key, Positional 1
RSRCNAME	Resource name	Name, *SAME	Optional
ONLINE	Online at IPL	SAME, YES, *NO	Optional
DEVWAITTMR	Device wait timer	2-600, *SAME	Optional
AUTOCFG	Auto-configuration controller	SAME, YES, *NO	Optional
INZFILE	Initialization source file	Qualified object name	Optional
	Qualifier 1: Initialization source file	Name, SAME, NONE
	Qualifier 2: Library	Name, LIBL, CURLIB
INZMBR	Initialization source member	Name, SAME, NONE	Optional
INZPGM	Initialization program	Qualified object name	Optional
	Qualifier 1: Initialization program	Name, SAME, NONE
	Qualifier 2: Library	Name, LIBL, CURLIB
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

Online at IPL (ONLINE)

Specifies whether this object is automatically varied on at initial program load (IPL).

*SAME

This value does not change.

*YES

The controller is automatically varied on at IPL.

*NO

The controller is not automatically varied on at IPL.

Device wait timer (DEVWAITTMR)

Specifies the device wait timeout value. This is used to limit the amount of time that a subsystem takes for the work station input/output to complete. The timeout value that is used for each device is obtained from the controller that it is attached to at vary on time. A change in this parameter value takes effect for attached devices when they are next varied on.

*SAME

This value does not change.

device-wait-timer

Specify a value ranging from 2 through 600 that specifies the maximum number of seconds that the subsystem waits for work station input/output to complete for all work stations attached to this controller.

When selecting a value for this parameter, the types of devices attached to the controller should be taken into account. Locally attached work stations should have a low value for this parameter (10 seconds or less).

Auto-configuration controller (AUTOCFG)

Specifies whether this controller description is the one which should have devices attached when they are automatically configured. Although there can be more than one controller description for each controller, only one description can be an automatic configuration controller. When new devices are automatically configured on that controller, they are attached to the automatic configuration controller description.

*SAME

This value does not change.

*NO

This is not an automatic configuration controller.

*YES

This is an automatic configuration controller.

Initialization source file (INZFILE)

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

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

*SAME

This value does not change.

*NONE

No initialization file name is specified.

The NAME of the initialization file NAME can be qualified by one of the following library values:

*LIBL: All libraries in the library list for the current thread 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 controller description then the current IOP defaults are used for initializaion.

Initialization source member (INZMBR)

Specifies the NAME of a source file member containing configuration initialization data (for a type 266A controller only).

*SAME

This 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 controller description, then the current IOP defaults are used.

Initialization program (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

This value does not change.

*NONE

No initialization program name is specified.

The NAME of the initialization program NAME can be qualified by one of the following library values:

*LIBL: All libraries in the library list for the current thread 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 when this controller description is created. The name of the source file and member containing configuration initialization data are passed to this program as parameters.

Message queue (MSGQ)

Specifies the message queue to which operational messages are sent.

*SAME

This 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 the text that briefly describes the object.

*SAME

This value does not change.

*BLANK

No text is specified.

character-value

Specify no more than 50 characters of text, enclosed in apostrophes.

Examples

CHGCTLLWS   CTLD(MYCTLR)  INZMBR(MBR3)

This command changes the controller description MYCTLR so that configuration initialization data is now contained in member MBR3 of the same source file as originally specified for this controller.