| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Create Controller Description (Local Work Station) (CRTCTLLWS) command creates 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.
More information about using this command is in the Local Device Configuration book, SC41-5121 book.
Restriction: You must have input/output system configuration (*IOSYSCFG) special authority to use this command.
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| CTLD | Controller description | Name | Required, Positional 1 |
| TYPE | Controller type | Character value | Required, Positional 2 |
| MODEL | Controller model | Character value, 1, 0001, 2, 0002 | Required, Positional 3 |
| RSRCNAME | Resource name | Name | Required, Positional 4 |
| ONLINE | Online at IPL | *YES, *NO | Optional |
| INZFILE | Initialization source file | Qualified object name | Optional |
| Qualifier 1: Initialization source file | Name, *NONE | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| INZMBR | Initialization source member | Name, *NONE | Optional |
| INZPGM | Initialization program | Qualified object name | Optional |
| Qualifier 1: Initialization program | Name, *NONE | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| TEXT | Text 'description' | Character value, *BLANK | Optional |
| DEV | Attached devices | Values (up to 120 repetitions): Name | Optional |
| DEVWAITTMR | Device wait timer | 2-600, 10 | Optional |
| AUTOCFG | Auto-configuration controller | *NO, *YES | Optional |
| AUT | Authority | Name, *CHANGE, *ALL, *USE, *EXCLUDE, *LIBCRTAUT | Optional |
| MSGQ | Message queue | Single values: *SYSVAL, *SYSOPR Other values: Qualified object name |
Optional |
| Qualifier 1: Message queue | Name | ||
| Qualifier 2: Library | Name |
| Top |
This is a required parameter.
Specifies the name of the controller description.
| Top |
This is a required parameter.
Specifies the type of controller for this description.
The ASCII local work station controller on a 9402 system.
The twinaxial local work station controller on a 9402 system.
The twinaxial local work station controller on a 9402 system.
The local work station controller for wireless devices is used.
Local work station controller.
Local work station controller.
Twinaxial work station controller.
Twinaxial work station controller.
The twinaxial local work station controller on a 9406 system.
The ASCII local work station controller on a 9406 system.
The twinaxial local work station controller on a 9402, 9404, or a 9406 system.
The twinaxial local work station controller on a 9402, 9404, or a 9406 system.
The twinaxial local work station controller on a 9402, 9404, or a 9406 system.
The twinaxial local work station controller on a 9402, 9404, or a 9406 system.
The twinaxial local work station controller on a 9404 system.
The ASCII local work station controller on a 9404 system.
Local work station controller.
The local work station controller on a 9401, 9402, 9404, or 9406 system.
The local work station controller on a 9401, 9402, 9404, or 9406 system.
The local work station controller for the 9406-3XX system is used.
The local work station controller for the 9406-3XX system is used.
The LocalTalk work station adapter for the 9402-2xx system is used.
| Top |
This is a required parameter.
Specifies the model of the work station controller. For controller types 6A58 and 6A59, model 0001 is for the local work station controller and model 0002 is for the operations console. All other controller types use only model 0001.
| Top |
Specifies the resource name that identifies the hardware this description represents. Use the WRKHDWRSC command to determine the resource name.
This is a required parameter.
| Top |
Specifies whether this object is automatically varied on at initial program load (IPL).
The controller is automatically varied on at IPL.
The controller is not automatically varied on at IPL.
| Top |
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.
No initialization file name is specified.
The NAME of the initialization file NAME can be qualified by one of the following library values:
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.
Specify the name of the library to be searched.
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 |
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.
No source file member is specified.
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 |
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.
No initialization program name is specified.
The NAME of the initialization program NAME can be qualified by one of the following library values:
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.
Specify the name of the library to be searched.
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 |
Specifies the text that briefly describes the object.
No text is specified.
Specify no more than 50 characters of text, enclosed in apostrophes.
| Top |
Specifies the names of the devices that are attached to this controller. The device descriptions must already exist.
The following list shows the maximum number of device descriptions that can be attached to each controller and the number of devices that can be active for each controller.
| Top |
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.
For local controllers, the subsystem waits a maximum of 10 seconds for the completion of the input/output of each work station attached to this controller.
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 |
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.
This is not an automatic configuration controller.
This is an automatic configuration controller.
| Top |
Specifies the authority you are giving to users who do not have specific authority for the object, who are not on an authorization list, and whose group profile or supplemental group profiles do not have specific authority for the object.
| Top |
Specifies the message queue to which operational messages are sent.
Qualifier 1: Message queue
Qualifier 2: Library
For more information about using this command, see the Communcations Management book, SC41-5406.
| Top |
CRTCTLLWS CTLD(MYCTLR) TYPE(6050) MODEL(1) RSRCNAME(CTL02)
INZFILE(*LIBL/MYFILE) INZMBR(MBR2)
This command creates a 6050 Model 1 local work station controller description with the name MYCTLR, and a resource name of CTL02. The source member MBR2, in source file MYFILE, will contain configuration initialization data.
| Top |
*ESCAPE Messages
| Top |