The Create Controller Description (Virtual Work Station) (CRTCTLVWS) command creates a controller description for a virtual work station (pass-through) controller. For more information about using this command, see the Communications Configuration book, SC41-5401.

Parameters

Keyword	Description	Choices	Notes
CTLD	Controller description	Name	Required, Positional 1
ONLINE	Online at IPL	*YES, *NO	Optional
TEXT	Text 'description'	Character value, *BLANK	Optional
DEV	Attached devices	Values (up to 255 repetitions): Name	Optional
DEVWAITTMR	Device wait timer	2-120, 20	Optional
MSGQ	Message queue	Single values: *SYSVAL, *SYSOPR Other values: Qualified object name	Optional
	Qualifier 1: Message queue	Name
	Qualifier 2: Library	Name
AUT	Authority	Name, *CHANGE, *ALL, *USE, *EXCLUDE, *LIBCRTAUT	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).

*YES

The controller is automatically varied on at IPL.

*NO

The controller is not automatically varied on at IPL.

Text 'description' (TEXT)

Specifies the text that briefly describes the object.

*BLANK

No text is specified.

character-value

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

Attached devices (DEV)

Specifies the names of the devices that are attached to this controller. The device descriptions must already exist.

A maximum of 255 devices can be specified.

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.

10

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.

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.

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

For more information about using this command, see the Communcations Management book, SC41-5406.

Authority (AUT)

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.

*CHANGE

The user can perform all operations on the object except those limited to the owner or controlled by object existence (*OBJEXIST) and object management (*OBJMGT) authorities. The user can change and perform basic functions on the object. *CHANGE authority provides object operational (*OBJOPR) authority and all data authority. If the object is an authorization list, the user cannot add, change, or remove users.

*ALL

The user can perform all operations except those limited to the owner or controlled by authorization list management (*AUTLMGT) authority. The user can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object. The user also can change ownership of the object.

*USE

The user can perform basic operations on the object, such as running a program or reading a file. The user cannot change the object. Use (*USE) authority provides object operational (*OBJOPR), read (*READ), and execute (*EXECUTE) authorities.

*EXCLUDE

The user cannot access the object.

*LIBCRTAUT

The system determines the authority for the object by using the value specified for the Create authority (CRTAUT) parameter on the Create Library (CRTLIB) command for the library containing the object to be created. If the value specified for the CRTAUT parameter is changed, the new value will not affect any existing objects.

name

Specify the name of an authorization list to be used for authority to the object. Users included in the authorization list are granted authority to the object as specified in the list. The authorization list must exist when the object is created.

Examples

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

This command creates a controller description named VRTCTL325.

Error messages

*ESCAPE Messages

CPF26BB

Extended wireless controller member not changed.

CPF26BC

Extended wireless controller member not displayed.

CPF26BD

Entry for barcode group not removed from extended wireless controller member.

CPF26BE

Entry for PTC group not removed from extended wireless controller member.

CPF26BF

Program QZXCINZ terminated abnormally. See previous messages.

CPF26B3

Extended wireless line member not added.

CPF26B4

Extended wireless line member not changed.

CPF26B5

Extended wireless line member not displayed.

CPF26B8

Extended wireless controller member not added.

CPF2716

Controller description &1 not created.