The Create Controller Description (Async) (CRTCTLASC) command creates a controller description for an asynchronous controller.

Restriction: You must have input/output system configuration (*IOSYSCFG) special authority to use this command.

Parameters

Keyword	Description	Choices	Notes
CTLD	Controller description	Name	Required, Positional 1
LINKTYPE	Link type	*ASYNC, *X25	Required, Positional 2
ONLINE	Online at IPL	*YES, *NO	Optional
SWITCHED	Switched connection	*NO, *YES	Optional
SNBU	Switched network backup	*NO, *YES	Optional
LINE	Attached nonswitched line	Name	Optional
SWTLINLST	Switched line list	Values (up to 64 repetitions): Name	Optional
INLCNN	Initial connection	*DIAL, *ANS	Optional
CNNNBR	Connection number	Character value, *ANY	Optional
ANSNBR	Answer number	*CNNNBR, *ANY	Optional
LGLCHLID	X.25 logical channel ID	Character value	Optional
TEXT	Text 'description'	Character value, *BLANK	Optional
DEV	Attached devices	Name	Optional
PREDIALDLY	Predial delay	0-254, 6	Optional
REDIALDLY	Redial delay	0-254, 120	Optional
DIALRTY	Dial retry	0-254, 2	Optional
SWTDSC	Switched disconnect	*NO, *YES	Optional
ACKTMR	File transfer ack timer	16-65535, 16	Optional
RETRY	File transfer retry	1-255, 7	Optional
RMTVFY	Remote verify	*NO, *YES	Optional
LCLLOCNAME	Local location	Name	Optional
LCLID	Local identifier	Name	Optional
PADEML	PAD Emulation	*NO, *YES	Optional
SWTLINSLCT	X.25 switched line selection	*FIRST, *CALC	Optional
DFTPKTSIZE	X.25 default packet size	Element list	Optional
	Element 1: Transmit value	*LIND, 64, 128, 256, 512, 1024, 2048, 4096
	Element 2: Receive value	*LIND, *TRANSMIT, 64, 128, 256, 512, 1024, 2048, 4096
DFTWDWSIZE	X.25 default window size	Element list	Optional
	Element 1: Transmit value	1-15, *LIND
	Element 2: Receive value	1-15, *LIND, *TRANSMIT
USRGRPID	X.25 user group identifier	Character value	Optional
RVSCRG	X.25 reverse charging	*NONE, *REQUEST, *ACCEPT, *BOTH	Optional
USRFCL	User facilities	Character value	Optional
CMNRCYLMT	Recovery limits	Single values: *SYSVAL Other values: Element list	Optional
	Element 1: Count limit	0-99, 2
	Element 2: Time interval	0-120, 5
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.

Link type (LINKTYPE)

Specifies the type of line to which this controller is attached.

This is a required parameter.

*ASYNC

This controller is attached to an asynchronous line.

*X25

This controller is attached to an X.25 line.

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.

Switched connection (SWITCHED)

Specifies whether this controller is attached to a switched line, a token-ring network, Ethernet LAN, or an X.25 switched virtual circuit (SVC). *NO must be specified for APPC controllers attached to a TDLC line.

*NO

This controller is attached to a nonswitched line. Specify this value for controllers attaching to an X.25 permanent virtual circuit (PVC).

*YES

This controller is attached to a switched line. Specify this value for controllers attached to an X.25 switched virtual circuit (SVC). Also specify this value for controllers attached to a local area network.

Note: If LINKTYPE is *LAN, the SWITCHED parameter value must be *YES or must not be specified.

Switched network backup (SNBU)

Specifies whether the remote system modem has the switched network backup (SNBU) feature. The backup feature is used to bypass a broken nonswitched (leased line) connection by establishing a switched connection. To activate SNBU, you must change the controller description of the modem from nonswitched to switched by specifying *YES for the Activate swt network backup (ACTSNBU) parameter.

Note: If the modem model you are using is an IBM 386x, 586x, or 786x, you should not change the controller description. Instead, manually switch the modem to the unswitched mode, and manually dial the connection.

Both the local and remote modems must support the SNBU feature to perform a valid activation.

*NO

The remote system modem does not have the SNBU feature.

*YES

The remote system modem has the SNBU feature.

Attached nonswitched line (LINE)

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

Note: The associated line must be varied off before this command is entered. Specify this parameter for controllers attaching to an X.25 permanent virtual circuit (PVC).

Switched line list (SWTLINLST)

Specifies the names of the switched lines to which this controller attaches. The line descriptions must already exist. Up to 64 switched line names can be specified.

switched-line-name

Specify the names of up to 64 lines that are connected to this controller. The same line name can be used more than once. For each line name specified, a line description by that name must already exist.

Initial connection (INLCNN)

Specifies the method used to establish a connection with this controller.

*DIAL

The system initiates outgoing calls and answers incoming calls.

*ANS

The connection is made by the IBM System i5 when it answers an incoming call from this controller. If a call is received from the remote controller and all necessary conditions are met, the incoming call is answered by the system.

For X.25 connections, the line attached to the controller requires switched virtual circuits (SVCs) configured on the LGLCHLE parameter of type OUT or BOTH(*SVCOUT or *SVCBOTH) for the connection to succeed.

The line can be changed using the Change Line Description (X.25) (CHGLINX25) command.

Connection number (CNNNBR)

Specifies the telephone number to dial to connect to this controller.

This could be a telephone number, an X.25 network address, or an X.21 connection number depending on the type of line the controller is attached to.

*ANY

The system accepts calls from any network address.

connection-number

Specify the connection number.

Answer number (ANSNBR)

Specifies the X.25 network address from which calls are accepted.

*CNNNBR

Calls from the X.25 network address specified on the CNNNBR parameter are accepted.

*ANY

Calls are accepted from any X.25 network address.

X.25 logical channel ID (LGLCHLID)

Specifies the logical channel identifier used for the X.25 permanent virtual circuit (PVC) to this controller. The valid entry is xyy. Where:

• x = the logical group number, derived from your network subscription.
• yy = the logical channel number, derived from your subscription. The logical channel identifier must be one of the PVC logical channel identifiers that was defined in the X.25 line description. There is no default for this parameter.

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.

Asynchronous communications supports only one device attached to each controller. The device name must be the same as that specified when the associated device description was created. The device description must already exist.

Predial delay (PREDIALDLY)

Specifies the time interval to wait (in 0.5 second intervals) before dialing a number.

Note: This parameter can be specified only if switched line or switched network backup is *YES and the link type is *ASYNC for asychronous controllers.

6

The default value of 6 provides a 3-second delay.

predial-delay

Specify a value ranging from 0 to 254 units. Each unit represents 0.5 second. To indicate no delay, specify a value of 0.

Redial delay (REDIALDLY)

Specifies the time interval to wait (in 0.5 second intervals) before re-dialing when the call attempt is unsuccessful.

Note: This parameter can be specified only if switched line or switched network backup is *YES and the link type is *ASYNC for asychronous controllers.

120

The default value of 120 provides a 60-second delay.

redial-delay

Specify a value from 0 to 254 units. Each unit represents 0.5 second. To indicate no delay, specify a value of 0.

Dial retry (DIALRTY)

Specifies the number of re-dial attempts made by the system before considering the dialing unsuccessful.

Note: This parameter can be specified only if switched line or switched network backup is *YES and the link type is *ASYNC for asychronous controllers.

2

The default number of retries is 2.

dial-retry

Specify a value from 0 to 254 in 0.5-second intervals, for the number of times the dialing will be tried.

Switched disconnect (SWTDSC)

Specifies whether the switched connection to this controller is dropped when the last device is varied off.

*NO

The switched connection is not dropped when the last device is varied off.

*YES

The switched connection is varied off when the last device is varied off.

File transfer ack timer (ACKTMR)

Specifies the time period allowed for an acknowledgement when using file transfer support.

Valid values range from 16 to 65535 in one-second intervals.

File transfer retry (RETRY)

Specifies the number of retries when using file transfer support.

Valid values range from 1 to 255.

7

Seven is the default for number of retries.

Remote verify (RMTVFY)

Specifies whether the remote system requires verification of local location NAME and local ID. The remote system requires verification if a generic controller and device are configured to accept calls from any X.25 network address.

*NO

The remote system does not require verification of local location name and local ID.

*YES

The remote system does require verification of the local location name and local ID.

Local location (LCLLOCNAME)

Specifies the name that, when combined with the local ID, identifies your controller to a remote system. This name must be the same as the name specified by the remote system in its remote location list.

Local identifier (LCLID)

Specifies the ID that, when combined with the local location NAME, identifies your controller to a remote system. This ID must be the same as the ID specified by the remote system in its remote location list.

local-identifier

Specify the local identifier.

PAD Emulation (PADEML)

Specifies whether this controller emulates an X.25 packet assembler/disassembler (PAD). This PAD emulation follows CCITT recommendations for X.3, X.28, and X.29. This parameter is valid only if *X25 is specified for the Link type (LINKTYPE) parameter, SWITCHED is *YES, and the initial connection (INLCNN) is set to *DIAL.

*NO

This controller does not emulate an X.25 packet assembler/disassembler (PAD).

*YES

This controller emulates an X.25 packet assembler/disassembler (PAD).

X.25 switched line selection (SWTLINSLCT)

Specifies the method that is used to select lines from an X.25 switched line list.

*FIRST

Lines are selected beginning with the first line in the switched line list.

*CALC

The system determines which line in the switched line list will be selected.

X.25 default packet size (DFTPKTSIZE)

Specifies the default packet size used by the X.25 network for transmission and reception.

Element 1: Transmit Packet Size

*LIND

The value specified in the line description is the default value.

transmit-packet-size

Specify a default packet size for transmission. The valid values for the packet size are 64, 128, 256, 512, 1024, 2048, and 4096.

Element 2: Receive Packet Size

*LIND

The value specified in the line description is the default value.

*TRANSMIT

The value specified as the default packet size for transmission is used as the default for reception.

receive-packet-size

Specify a default packet size for reception. The valid values for the packet size are 64, 128, 256, 512, 1024, 2048, and 4096.

X.25 default window size (DFTWDWSIZE)

Specifies the default window size for transmission and reception.

Element 1: Transmit Window Size

*LIND

The value specified in the line description is used as the default window size.

transmit-window-size

Specify the appropriate default window size. If you specified modulus 8, valid values range from 1 through 7. If you specified modulus 128, valid values range from 1 through 15. For switched virtual circuit (SVC) incoming calls, the system accepts the window size indicated in the Incoming Call packet facilities field.

Element 2: Receive Window Size

*LIND

The value specified in the line description is used as the default window size.

*TRANSMIT

The value specified as the default window size for transmission is used as the default for reception.

receive-window-size

Specify the appropriate default window size. If you specified modulus 8, valid values range from 1 through 7. If you specified modulus 128, valid values range from 1 through 15.

X.25 user group identifier (USRGRPID)

Specifies the closed user-group ID for contacting this switched virtual circuit (SVC) controller on the X.25 network.

Specify the 2-digit decimal value, from 00 through 99, as provided by the network subscription. This parameter is not valid for permanent virtual circuit (PVC) connections. It is valid only for SVC circuit outgoing call operations and is ignored for SVC incoming call connections.

X.25 reverse charging (RVSCRG)

Specifies whether reverse charges are accepted or requested when contacting this controller.

*NONE

No reverse charging for network tariff billing is accepted.

*REQUEST

Charges are requested on outgoing call request packets.

*ACCEPT

Reverse charging for network tariff billing is accepted on incoming requests.

*BOTH

Both incoming and outgoing requests are accepted.

User facilities (USRFCL)

Specifies a string of hexadecimal characters sent to the X.25 network to request additional services. The system allows up to 218 hexadecimal characters.

Note: Values entered in this field are determined by the supplier of the network subscription. Do not include coding of facilities shown through keywords: packet size, window size, user group identifier, and reverse charging.

Recovery limits (CMNRCYLMT)

Specifies the number of recovery attempts made by the system before an inquiry message is sent to the system operator. Also specifies the time (in minutes) that must elapse before the system sends an inquiry message to the system operator indicating that the recovery attempt count limit is reached.

Element 1: Maximum Recovery Limit

2

Two recovery attempts are made within the interval specified.

*SYSVAL

The value in the QCMNRCYLMT system value is used.

count limit

Specify the number of second-level recovery attempts to be made. Valid values range from 0 through 99.

Element 2: Recovery Time Interval

5

The specified number of recovery attempts is made within a 5-minute interval.

time-interval

Specify the time interval (in minutes) at which the specified number of second-level recoveries are attempted. Valid values range from 0 through 120. If the value specified for count-limit is not 0, the value 0 specifies infinite recovery.

More information on communication recovery is in the Communcations Management book, SC41-5406.

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

CRTCTLASC   CTLD(ASCCTL)  LINKTYPE(*ASYNC)  LINE(ASCLIN)

This command creates an asynchronous controller attached to a nonswitched asynchronous line.

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.