Change Ctl Desc (Local WS) (CHGCTLLWS)
Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
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.
Restriction: You must have input/output system configuration (*IOSYSCFG) special authority to use this command.
Top |
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 |
Controller description (CTLD)
This is a required parameter.
Specifies the name of the controller description.
Top |
Resource name (RSRCNAME)
Specifies the resource name that identifies the hardware this description represents. Use the WRKHDWRSC command to determine the resource name.
- *SAME
This value does not change.
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.
Top |
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).
Top |
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.
Top |
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.
Top |
Initialization source member (INZMBR)
Specifies the NAME of a source file member containing configuration initialization data (for a type 266A controller only).
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 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.
Top |
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.
Top |
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.
Top |
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.
Top |
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.
Top |
Top |