The Change Controller Description (Virtual Work Station) (CHGCTLVWS) command changes a controller description for a virtual work station (pass-through) controller.

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.

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

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

CHGCTLVWS   CTLD(VRTCTL325)  TEXT('S/325 virtual controller')

This command changes the controller description of controller VRTCTL325 to have a new text description.

Error messages

*ESCAPE Messages

CPF2652

Controller description &1 not changed.