CRTCTLASC (Create Controller Description (Async))

CRTCTLASC Command syntax diagram

 

Purpose

The Create Controller Description (Async) (CRTCTLASC) command creates a controller description for an asynchronous controller. More information about using this command is in the Communications Configuration Link to PDF book.

 

Required Parameters

CTLD
Specifies the name of the controller description being created.

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

*ASYNC: This controller is attached to an asynchronous line.

*X25: This controller is attached to an X.25 line.

 

Optional Parameters

ONLINE
Specifies whether this object is automatically varied on at initial program load (IPL).

*YES: The controller is automatically varied on at IPL.

*NO: This controller is not automatically varied on at IPL.

SWITCHED
Specifies whether this controller is attached to a switched line or to an X.25 switched virtual circuit (SVC).

*NO: The controller is attached to a nonswitched line or, for X.25, to a permanent virtual circuit (PVC).

*YES: The controller is attached to a switched line or, for X.25, to a switched virtual circuit (SVC).

SNBU
Specifies, for controllers supporting the switched network backup (SNBU) feature, whether the SNBU feature is activated or deactivated. Both the local and remote modems must support the SNBU feature to perform a valid activation.

*NO: The remote modem does not have the switched network backup (SNBU) feature.

*YES: The remote modem has the SNBU feature.

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

Note: This parameter can be specified only if the user specified *NO for the switched line (SWITCHED parameter) for asynchronous communications controllers. If this controller is attached to an X.25 permanent virtual circuit (PVC), specify the name of the line on which that PVC is configured.

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.

DEV
Specifies the name of a device attached to this controller. 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.

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

*DIAL: The connection is made by a call initiated from the iSeries 400.

For X.25 connection, 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.

*ANS: The connection is made by the iSeries 400 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 to which the controller attaches requires switched virtual circuits (SVC) configured on the LGLCHLE parameter of type IN or BOTH(*SVCIN or *SVCBOTH) for the connection to succeed. The line can be changed using the Change Line Description (X.25) (CHGLINX25) command.

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

*ANY: Any X.25 SVC incoming call can use this controller.

connection-number: Specify the connection number used to call this controller. This could be a telephone number or an X.25 network address.

ANSNBR
Specifies the X.25 network address from which to accept calls.

*CNNNBR: Calls from the X.25 network address specified by the connection number (CNNNBR) parameter are accepted.

*ANY: Calls are accepted from any X.25 network address.

PREDIALDLY
Specifies how long to wait (in 0.5 second intervals) before dialing.

Note: Predial delay can be specified only if switched line or switched network backup is *YES and the link type is *ASYNC for asynchronous controllers.

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

predial-delay: Specify a value ranging from 1 through 254 in 0.5-second intervals, or specify 0 to indicate no delay.

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

Note: Redial delay can be specified only if switched line or switched network backup is *YES and the link type is *ASYNC for asynchronous controllers.

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

redial-delay: Specify a number ranging from 1 through 254 in 0.5- second intervals, or specify 0 to indicate no delay.

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

Note: Dial retries can be specified only if switched line or switched network backup is *YES and the link type is *ASYNC for asynchronous controllers.

2: The LZ algorithm with the 12-bit code for repeated substrings in the data stream is used. These codes refer to entries in a common dictionary, created as the data flows between the sender and receiver. The LZ algorithms require storage and extra processing time. The LZ12 requires the most storage and processing time of the LZ algorithms; however, it compresses the data stream the most.

dial-retry: Specify a value ranging from 0 through 254 for the number of retries.

SWTDSC
Specifies whether the switched connection to this controller is made inoperative 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 disconnected when the last device is varied off.

ACKTMR
Specifies the time allowed for an acknowledgment on an asynchronous file transfer.

16: The default value is 16 seconds.

file-transfer-acknowledgment-timer: Specify a value ranging from 16 through 65535 seconds for an acknowledgment on an Async file transfer.

RETRY
Specifies the number of retries on an Async file transfer.

7: Seven is the default for number of retries.

file-transfer-retry: Specify a value ranging from 1 through 255 for the number of retries.

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 requires verification of the local location name and local ID.

LCLLOCNAME
Specifies the local location name.

Note: This name must be the same as that specified by the remote system in its remote location list.

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

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. PAD emulation is valid only for asynchronous controllers for which 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).

LGLCHLID
Specifies the logical channel ID used for the X.25 permanent virtual circuit (PVC) to this controller. Specify the logical channel ID.

The valid entry is xyy, where:

x = the logical group number, derived from the network subscription.

yy = the logical channel number, derived from the user's 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.

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

*FIRST: The lines are selected in the order in which they are specified.

*CALC: The system determines the value to use.

DFTPKTSIZE
Specifies the default packet size used by the X.25 network.

Element 1: Transmit Packet Size

*LIND: The value specified in the line description is used as the controller.

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 used as the controller.

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

DFTWDWSIZE
Specifies the default window size used by the X.25 network.

Element 1: Transmit Window Size

*LIND: The value specified in the line description is used as the controller.

transmit-window-size: Specify the appropriate default window size. Valid values range from 1 through 7 for networks that use modulus 8 packet numbering. Valid values range from 1 through 15 for networks that use 128 packet numbering.

Element 2: Receive Window Size

*LIND: The value specified in the line description is used as the controller.

*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. Valid values range from 1 through 7 for networks that use modulus 8 packet numbering. Valid values range from 1 through 15 for networks that use 128 packet numbering.

USRGRPID
Specifies the closed user-group ID for contacting this X.25 switched virtual circuit (SVC) controller. Specify a value ranging from 0 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.

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.

USRFCL
Specifies a string of hexadecimal digits sent to the X.25 network to request additional services. The iSeries 400 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.

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.

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: A 15-second time-out period is used.

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.

Other Single Values

*SYSVAL: The recovery limits specified in the QCMNRCYLMT system value are used.

MSGQ
Specifies the qualified name of the message queue to which messages are sent. More information about using this parameter is in the Communications Management Link to PDF book.

Single Values

*SYSVAL: Messages are sent to the message queue defined in the system value QCFGMSGQ.

*SYSOPR: Messages are sent to the system operator message queue (QSYS/QSYSOPR).

library-name/message-queue-name: Specify the library-qualified name of the message queue to which operational messages are sent.

AUT
Specifies the authority given to users who do not have specific authority to the controller description, who are not on an authorization list, and whose user group has no specific authority to the controller description.

*LIBCRTAUT: The authority for the object is the same as the create authority for QSYS. The create authority for QSYS can be displayed by using the Display Library Description (DSPLIBD) command. If the create authority is changed with the Change Library (CHGLIB) command, the new authority does not affect existing objects.

*CHANGE: The user can perform all operations on the object except those limited to the owner or controlled by object existence authority and object management authority. The user can change and perform basic functions on the object. Change authority provides object operational authority and all data authority.

*USE: The user can perform basic operations on the controller description, such as running a program or reading a file. The user cannot change the controller description. *USE authority provides object operational authority, read authority, and execute authority.

*ALL: The user can perform all operations except those limited to the owner or controlled by authorization list management 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 controller description.

*EXCLUDE: The user cannot access the controller description.

authorization-list-name: Specify the name of the authorization list used.

TEXT
Specifies the text that briefly describes the object and its function. More information on this parameter is in Commonly used parameters.

*BLANK: Text is not specified.

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

Example for CRTCTLASC 

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

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

Error messages for CRTCLTASC

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