Create Ctl Desc (Network) (CRTCTLNET)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The Create Controller Description (Network) (CRTCTLNET) creates a controller description for a network 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, Positional 1
ONLINE Online at IPL *YES, *NO Optional
LINE Attached line Name Optional
CNNRSPTMR Connection response timer 1-3600, 170 Optional
TEXT Text 'description' Character value, *BLANK Optional
DEV Attached devices Values (up to 255 repetitions): Name Optional
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.

Top

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.

Top

Attached line (LINE)

Specifies the name of the nonswitched line to which this controller is attached. The line description must already exist.

Top

Connection response timer (CNNRSPTMR)

Specifies the amount of time the system will wait before responding to an incoming connection request.

170

The system will wait 170 seconds before responding to an incoming connection request.

connection-response-timer

Specify the amount of time the system will wait before responding to an incoming connection request. The valid values range from 1 through 3600 seconds.

Top

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.

Top

Attached devices (DEV)

Specifies the NAMEs of up to 255 devices which are attached to this controller. The device descriptions must already exist.

Top

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

Examples

CRTCTLNET   CTLD(CTL0A)  LINE(LIN01)

This command creates a network controller description with the name CTL0A. An existing line, LIN01, is specified as the network line for the controller.

Top

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