Change Ctl Desc (Virtual WS) (CHGCTLVWS)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Change Controller Description (Virtual Work Station) (CHGCTLVWS) command changes a controller description for a virtual work station (pass-through) controller.
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 |
| ONLINE | Online at IPL | *SAME, *YES, *NO | Optional |
| DEVWAITTMR | Device wait timer | 2-120, *SAME | Optional |
| 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 |
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 |
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
CHGCTLVWS CTLD(VRTCTL325) TEXT('S/325 virtual controller')
This command changes the controller description of controller VRTCTL325 to have a new text description.
| Top |
| Top |