Create Ctl Desc (APPC) (CRTCTLAPPC)

The Create Controller Description (APPC) (CRTCTLAPPC) command creates a controller description for an advanced program-to-program communications (APPC) controller. For more information about this command, see the Communications Configuration book, SC41-5401.

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, Key, Positional 1
LINKTYPE Link type *ANYNW, *FAX, *FR, *HPRIP, *ILAN, *LAN, *LOCAL, *OPC, *SDLC, *TDLC, *VRTAPPN, *X25 Required, Key, Positional 2
ONLINE Online at IPL *YES, *NO Optional
SWITCHED Switched connection *NO, *YES Optional
SHM Short hold mode *NO, *YES Optional
SNBU Switched network backup *NO, *YES Optional
APPN APPN-capable *YES, *NO Optional
RMTINTNETA Remote internet address Character value Optional
LCLINTNETA Local internet address Character value, *SYS Optional
LDLCTMR LDLC timers Element list Optional
Element 1: LDLC retry count 0-255, 3
Element 2: LDLC retry timer 0-65535, 15
Element 3: LDLC liveness timer 0-65535, 10
LDLCLNKSPD LDLC link speed 1200-603979776000, *CAMPUS, *WAN, 4M, 10M, 16M, 100M, *MIN, *MAX Optional
LDLCTMSGRP LDLC transmission group Element list Optional
Element 1: Cost/connect time 0-255, 0
Element 2: Cost/byte 0-255, 0
Element 3: Security *NONSECURE, *PKTSWTNET, *UNDGRDCBL, *SECURECND, *GUARDCND, *ENCRYPTED, *MAX
Element 4: Propagation delay *LAN, *MIN, *TELEPHONE, *PKTSWTNET, *SATELLITE, *MAX
TYPE Controller type *BLANK, *FBSS, 3174, 3274, 3651, 3684, 3694, 4680, 4684, 4701, 4702, 4730, 4731, 4732, 4736 Optional
LINE Attached nonswitched line Name Optional
SWTLINLST Switched line list Values (up to 64 repetitions): Name Optional
MAXFRAME Maximum frame size 265-16393, 256, 265, 512, 521, 1024, 1033, 1496, 1994, 2048, 2057, 4060, 4096, 8156, 16393, *LINKTYPE Optional
RMTNETID Remote network identifier Communications name, *NETATR, *NONE, *ANY Optional
RMTCPNAME Remote control point Communications name, *ANY Optional
RMTSYSNAME Remote system name Character value Optional
EXCHID Exchange identifier 00000000-FFFFFFFF Optional
INLCNN Initial connection *DIAL, *ANS Optional
DIALINIT Dial initiation *LINKTYPE, *IMMED, *DELAY Optional
CNNNBR Connection number Character value, *DC, *ANY Optional
ANSNBR Answer number *CNNNBR, *ANY Optional
CNNLSTOUT Outgoing connection list Name Optional
CNNLSTOUTE Connection list entry Name Optional
ROLE Data link role *NEG, *PRI, *SEC Optional
SHMDSCLMT SHM disconnect limit 1-254, 10, *NOMAX Optional
SHMDSCTMR SHM disconnect timer 2-3000, 50 Optional
STNADR Station address 00-FE Optional
ADPTADR LAN remote adapter address 000000000001-FFFFFFFFFFFF Optional
DSAP LAN DSAP 04, 08, 0C, 10, 14, 18, 1C, 20, 24, 28, 2C, 30, 34, 38, 3C, 40, 44, 48, 4C, 50, 54, 58, 5C, 60, 64, 68, 6C, 70, 74, 78, 7C, 80, 84, 88, 8C, 90, 94, 98, 9C Optional
SSAP LAN SSAP 04, 08, 0C, 10, 14, 18, 1C, 20, 24, 28, 2C, 30, 34, 38, 3C, 40, 44, 48, 4C, 50, 54, 58, 5C, 60, 64, 68, 6C, 70, 74, 78, 7C, 80, 84, 88, 8C, 90, 94, 98, 9C Optional
NETLVL X.25 network level 1980, 1984, 1988 Optional
LINKPCL X.25 link level protocol Character value, *QLLC, *ELLC, *LLC2 Optional
LGLCHLID X.25 logical channel ID Character value Optional
CNNPWD X.25 connection password Character value, X'' Optional
CPSSN APPN CP session support *YES, *NO Optional
NODETYPE Remote APPN node type *ENDNODE, *LENNODE, *NETNODE, *CALC Optional
BEXROLE Branch extender role *NETNODE, *ENDNODE Optional
HPR APPN/HPR capable *YES, *NO Optional
HPRPTHSWT HPR path switching *NO, *YES Optional
TMSGRPNBR APPN transmission group number 1-20, 1, *CALC Optional
MINSWTSTS APPN minimum switched status *VRYONPND, *VRYON Optional
AUTOCRTDEV Autocreate device *ALL, *NONE Optional
AUTODLTDEV Autodelete device 1-31680, 31680, *NO Optional
USRDFN1 User-defined 1 0-255, *LIND Optional
USRDFN2 User-defined 2 0-255, *LIND Optional
USRDFN3 User-defined 3 0-255, *LIND Optional
MDLCTL Model controller description *NO, *YES Optional
CNNNETID Connection network ID Communications name, *NETATR, *NONE Optional
CNNCPNAME Connection network CP Communications name Optional
TEXT Text 'description' Character value, *BLANK Optional
DEV Attached devices Values (up to 254 repetitions): Name Optional
CODE Character code *EBCDIC, *ASCII Optional
SSCPID SSCP identifier 000000000001-FFFFFFFFFFFF Optional
IDLCWDWSIZ IDLC window size 1-31, *LIND Optional
IDLCFRMRTY IDLC frame retry 0-100, *LIND Optional
IDLCRSPTMR IDLC response timer 10-100, *LIND Optional
IDLCCNNRTY IDLC connect retry 1-100, *LIND, *NOMAX 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 *YES, *NO Optional
DSCTMR Disconnect timer Element list Optional
Element 1: Minimum connect timer 0-65535, 170
Element 2: Disconnection delay timer 0-65535, 30
POLLPTY SDLC poll priority *NO, *YES Optional
POLLLMT SDLC poll limit 0-4, 0 Optional
OUTLMT SDLC out limit *POLLLMT, 0, 1, 2, 3, 4 Optional
CNNPOLLRTY SDLC connect poll retry 0-65534, *CALC, *NOMAX Optional
NDMPOLLTMR SDLC NDM poll timer 0-3000, *CALC Optional
LANFRMRTY LAN frame retry 0-254, *CALC Optional
LANCNNRTY LAN connection retry 0-254, *CALC Optional
LANRSPTMR LAN response timer 0-254, *CALC Optional
LANCNNTMR LAN connection timer 0-254, *CALC Optional
LANACKTMR LAN acknowledgement timer 0-254, *CALC Optional
LANINACTMR LAN inactivity timer 0-255, *CALC Optional
LANACKFRQ LAN acknowledgement frequency 0-127, *CALC Optional
LANMAXOUT LAN max outstanding frames 1-127, *CALC Optional
LANACCPTY LAN access priority 0-3, *CALC Optional
LANWDWSTP LAN window step 1-127, *NONE 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
X25FRMRTY X.25 frame retry 0-21, 7 Optional
X25CNNRTY X.25 connection retry 0-21, 7 Optional
X25RSPTMR X.25 response timer 1-2550, 300 Optional
X25CNNTMR X.25 connection timer 1-2550, 300 Optional
X25DLYTMR X.25 delayed connection timer 1-32767, *CALC Optional
X25ACKTMR X.25 acknowledgement timer 0-2550, 20 Optional
X25INACTMR X.25 inactivity timer 1-2550, 1050 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

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.

*ANYNW

This controller is not directly attached to a line. It is being used to run APPC applications over a transport other than the native transport (SNA). RMTCPNAME and RMTNETID are required when *ANYNW is specified. The following parameters are allowed:

*FAX

This controller is attached to a local fax line. If *FAX is specified, the following criteria must be met:

*FR

This controller is attached to a frame relay line.

*HPRIP

This controller will allow HPR (High Performance Routing) to use the Internet as a link layer, allowing HPR data to be transported over Internet networks.

Note: If *HPRIP is specified, a value must be specified for the RMTINTNETA parameter.

*ILAN

This controller does not use a communication line since all communications are within the system. This link type allows multiple operating systems (running on one physical system) to communicate without requiring a physical communications link.

Note: If LINKTYPE(*ILAN) is specified, the value specified for NODETYPE must be *LENNODE or *NETNODE and the value specified on the SSAP parameter must be different than the value specified on the DSAP parameter.

*LAN

This controller is attached to a distributed data interface (DDI), Ethernet, or token-ring local area network line.

*LOCAL

This controller uses no communication lines since all communications are local. If *LOCAL is specified, the following criteria must be met:

*OPC

This controller is attached to the optical bus (OptiConnect).

*SDLC

This controller is attached to a synchronous data link control (SDLC) line.

*TDLC

This controller is attached to a twinaxial data link control (TDLC) line.

*VRTAPPN

This controller is used for APPN communications. It is not attached to any specific communications line. If *VRTAPPN is specified, the following criteria must be met:

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

Short hold mode (SHM)

Specifies whether this controller is to be used for X.21 short hold mode. To specify *YES, you must also specify *SDLC for the Link type (LINKTYPE) parameter, and *YES for the Switched connection (SWITCHED) parameter.

*NO

This controller is not used for X.21 short hold mode.

*YES

This controller is used for X.21 short hold mode.

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.

APPN-capable (APPN)

Specifies whether the local system uses advanced peer-to-peer networking (APPN) functions when communicating with this controller. *YES must be specified for APPC controllers attached to a TDLC line.

*YES

This controller is for APPN.

*NO

This controller is not for APPN.

Remote internet address (RMTINTNETA)

Specifies the TCP/IP host name or internet address to which the controller will respond.

Note: This parameter is valid only when *HPRIP is specified for the Link type (LINKTYPE) parameter.

host-name

This is a valid host name or a domain qualified host name associated with an internet address. A name must be between 1 and 255 characters in length.

host-internet-address

The internet address can be specified in either IPv4, IPv6 or IPv4 mapped to IPv6 form.

An IPv4 internet address is specified in the form, nnn.nnn.nnn.nnn, where nnn is a decimal number ranging from 0 through 255. Leading zeros in each part of the dotted decimal internet address are invalid and will be removed. An IPv4 internet address is not valid if it has a value of all binary ones or zeros for the network identifier (ID) or host portion of the address.

An IPv6 internet address is specified in the form x:x:x:x:x:x:x:x, where x is a hexadecimal number ranging from 0 through X'FFFF'. "::" may be used once in the IPv6 address to indicate one or more groups of 16 bits of zeros. The "::" may be used to compress leading, imbedded, or trailing zeros in the address.

An IPv4-mapped IPv6 address is specified in the form ::FFFF:nnn.nnn.nnn.nnn, where nnn is decimal number ranging from 0 through 255.

If the internet address is entered from the command line, the address must be enclosed in apostrophes.

Local internet address (LCLINTNETA)

Specifies the TCP/IP interface to be used to communicate with the remote system.

Note: This parameter is valid only when *HPRIP is specified for the Link type (LINKTYPE) parameter.

*SYS

The system will select the local internet address to use.

internet-address

The internet address can be specified in either IPv4, IPv6 or IPv4 mapped to IPv6 form.

An IPv4 internet address is specified in the form, nnn.nnn.nnn.nnn, where nnn is a decimal number ranging from 0 through 255. Leading zeros in each part of the dotted decimal internet address are invalid and will be removed. An IPv4 internet address is not valid if it has a value of all binary ones or zeros for the network identifier (ID) or host portion of the address.

An IPv6 internet address is specified in the form x:x:x:x:x:x:x:x, where x is a hexadecimal number ranging from 0 through X'FFFF'. "::" may be used once in the IPv6 address to indicate one or more groups of 16 bits of zeros. The "::" may be used to compress leading, imbedded, or trailing zeros in the address.

An IPv4-mapped IPv6 address is specified in the form ::FFFF:nnn.nnn.nnn.nnn, where nnn is decimal number ranging from 0 through 255.

If the internet address is entered from the command line, the address must be enclosed in apostrophes.

Alias-name

The alias name is the same value that is specified on the ADDTCPIFC and CHGTCPIFC commands Alias name (ALIASNAME) parameter.

LDLC timers (LDLCTMR)

Specifies LDLC (Logical Data Link Control) timers and retry count. The LDLC retry count and LDLC retry timer are used in conjunction. The LDLC retry count and LDLC retry timer are initialized when a command or request is first transmitted over the link. If the LDLC retry timer expires before a response is received, the command or request is retransmitted, the LDLC retry count is decremented and the LDLC retry timer is restarted. If the timer expires with the LDLC retry count at zero, the link is assumed to be inoperative. The LDLC liveness timer is used to make sure that both the other endpoint of an RTP (rapid transport protocol) connection and the path between the endpoints are still operational after a period of inactivity.

See High Performance Routing Architecture Reference (SV40-1018) for more information.

http://publibz.boulder.ibm.com/cgi-bin/bookmgr_OS390/BOOKS/D50H6003/CCONTENTS

Note: This parameter is valid only when *HPRIP is specified for the Link type (LINKTYPE) parameter.

Element 1: LDLC retry count

3
The LDLC retry count is 3.
retry-count
Specify the LDLC retry counter. Valid values range from 0 to 255.

Element 2: LDLC retry timer

15
The LDLC retry timer is set to 15 seconds.
retry-timer
Specify the LDLC retry timer interval. Valid values range from 0 to 65535 seconds.

Element 3: LDLC liveness timer

10
The LDLC liveness timer is set to 10.
liveness-timer
Specify the LDLC liveness timer. Valid values range from 0 to 65535 seconds.

LDLC link speed (LDLCLNKSPD)

Specifies the LDLC (Logical Data Link Control) link speed in bits per second.

See High Performance Routing Architecture Reference (SV40-1018) for more information.

http://publibz.boulder.ibm.com/cgi-bin/bookmgr_OS390/BOOKS/D50H6003/CCONTENTS

Note: This parameter is valid only when *HPRIP is specified for the Link type (LINKTYPE) parameter.

*CAMPUS

Specifies a set of default APPN link characteristics for a campus environment be used.

*WAN

Specifies a set of default APPN link characteristics for a wide-area network environment be used.

4M

The link speed is 4 million bits per second.

10M

The link speed is 10 million bits per second.

16M

The link speed is 16 million bits per second.

100M

The link speed is 100 million bits per second.

*MIN

A link speed of less than 1200 bits per second is used.

*MAX

A link speed greater than 100 million bits per second is used.

LDLC-link-speed

Specify the LDLC link speed.

Valid values range from 1200 to 603979776000.

LDLC transmission group (LDLCTMSGRP)

Specifies the LDLC (Logical Data Link Control) transmission group characteristics of Cost/connect time, Cost/byte, Security and Propagation delay.

See High Performance Routing Architecture Reference (SV40-1018) for more information.

http://publibz.boulder.ibm.com/cgi-bin/bookmgr_OS390/BOOKS/D50H6003/CCONTENTS

Note: This parameter is valid only when *HPRIP is specified for the Link type (LINKTYPE) parameter.

Element 1: Cost/connect time

Cost per connect time specifies the relative cost of being connected over the link.

0
Cost per connect time is zero.
cost-connection-time
Specify the cost per connect time. Valid values range from 0 to 255.

Element 2: Cost/byte

Cost per byte specifies the relative cost of sending and receiving data over the link.

0
Cost per byte is zero.
cost-byte
Specify the cost per byte. Valid values range from 0 to 255.

Element 3: Security

Security specifies the security over the link.

*NONSECURE
There is no security over the link.
*PKTSWTNET
This is a packet-switched network, so the link is secure in the sense that the data does not always use the same path through the network.
*UNDGRDCBL
This is an underground cable secure conduit.
*SECURECND
This is a secured conduit but not guarded.
*GUARDCND
The link is a guarded conduit and protected against physical tapping.
*ENCRYPTED
Data flow is to be encrypted.
*MAX
This is a guarded conduit, protected against physical and radiation tapping.

Element 4: Propagation delay

Propagation delay specifies the time required for a signal to travel from one end of a link to the other end.

*LAN
Specifies a local area network delay (less than 0.48 milliseconds).
*MIN
Specifies the minimum delay.
*TELEPHONE
Specifies a telephone network with a delay from .48 milliseconds through 49.152 milliseconds.
*PKTSWTNET
Specifies a packet-switched network with the delay from 49.152 through 245.76 milliseconds.
*SATELLITE
Specifies satellite delay (greater than 245.76 milliseconds).
*MAX
Specifies the maximum delay.

Controller type (TYPE)

Specifies the type of controller for this description. This parameter is valid only when *NO is specified on the APPN parameter.

*BLANK

No T2.0 controller is specified.

*FBSS

This description represents a Financial Branch System Services (FBSS) controller.

3174

This description represents a 3174 controller.

3274

This description represents a 3274 controller.

3651

This description represents a 3651 controller.

3684

This description represents a 3684 controller.

3694

This description represents a 3694 check processor.

4680

This description represents a 4680 controller.

4684

This description represents a 4684 controller.

4701

This description represents a 4701 finance controller.

4702

This description represents a 4702 finance controller.

4730

This description represents a 4730 personal banking machine.

4731

This description represents a 4731 personal banking machine.

4732

This description represents a 4732 personal banking machine.

4736

This description represents a 4736 self-service transaction machine.

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.

Maximum frame size (MAXFRAME)

Specifies the maximum frame (path information unit (PIU)) size the controller can send or receive. This value is used to calculate the request unit (RU) sizes. Since the maximum PIU size that the controller can send or receive is negotiated at exchange identifier time, the maximum PIU size used at run time may be different. This value matches the corresponding value on the host system.

*LINKTYPE

The following values are used for the various types:

maximum-frame-size

Specify the frame size for the controller. The frame size that can be used depends on the type of line being used. Valid frame sizes for each line type are:

Note: The numeric values listed for *LINKTYPE are valid only if TYPE(*BLANK) is specified when the controller is created.

Remote network identifier (RMTNETID)

Specifies the NAME of the remote network in which the adjacent control point resides.

*NETATR

The LCLNETID value specified in the system network attributes is used.

*NONE
No remote network identifier (ID) is used.
*ANY

The system determines which remote network identifier is used.

remote-network-identifier

Specify the remote network identifier.

Remote control point (RMTCPNAME)

Specifies the control point name of the remote system.

*ANY

The system determines the name of the remote control point used.

remote-control-point-name

Specify the remote control point NAME.

Remote system name (RMTSYSNAME)

Specifies the NAME of the remote system to which there is an OptiConnect bus connection. The current system NAME of the remote system can be found by using the DSPNETA command on that system.

Note: This parameter is valid only when LINKTYPE(*OPC) is specified.

Exchange identifier (EXCHID)

Specifies the remote exchange identifier of this controller. The controller sends (exchanges) its identifier to another location when a connection is established. The 8-digit hexadecimal identifier contains 3 digits for the block number and 5 digits for the identifier of the specific controller.

Note: This parameter is required for both SDLC switched lines and SNBU lines when either of the following occurs:

The block number of the exchange identifier is related to the controller:

Controller
Block Number
3174, 3274
001 to 0FE
3601 *
016 (* 3601 is configured as 4701)
3651, 3684
005
3694
02F
4680
04D
4684
005
4702, 4702
057
5251
020
5294
045
5394
05F
5494
073
System i5
056
Displaywriter
03A
System/36
03E
System/38
022

For the 5251, 5394, and 5294 controllers, the last five digits must begin with 000. For 5494 controllers, the last five digits are either 000nn where nn is the station address of the 5494 controller, or the last five digits of the 5494 serial number when the serial number starts with XI.

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.

Dial initiation (DIALINIT)

Specifies the method used to make the initial dial on a switched line between the system and the remote controller.

*LINKTYPE

The type of dial connection initiated is specified on the LINKTYPE parameter. For LAN or SDLC short-hold mode connections, the default is to dial the connection as soon as the controller description is varied on. For all other link types, the default is to delay dialing.

*IMMED

The dial connection is initiated as soon as the controller description is varied on.

*DELAY

The dial connection is delayed until a job is initiated that requests the use of the remote controller resources.

Connection number (CNNNBR)

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

*DC

Direct call is being used in an X.21 circuit switched network.

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

Note: This parameter is no longer supported. It exists solely for compatibility with releases earlier than Version 5 Release 3 Modification 0 of operating system.

Outgoing connection list (CNNLSTOUT)

Specifies, for ISDN switched connections, the name of a connection list object that contains the ISDN assigned numbers for a dial out operation to the ISDN.

list-object

Specify the name of a connection list object.

Note: This parameter is no longer supported. It exists solely for compatibility with releases earlier than Version 5 Release 3 Modification 0 of operating system.

Connection list entry (CNNLSTOUTE)

Specifies, for ISDN switched connections, the entry name from the connection list that is used to make a call to the ISDN. The connection list must have been identified on the Outgoing connection list (CNNLSTOUT) parameter.

entry-name

Specify an entry name.

Data link role (ROLE)

Specifies the data link role which the remote controller has on this connection. The primary station is the controlling station and the secondary station is the responding station. The primary station controls the data link by sending commands to the secondary station, and the secondary station responds to the commands.

*NEG

The local system and the remote system negotiate which computer is primary.

*PRI

The remote system is the primary station on this communications line.

*SEC

The remote system is a secondary station on this communications line.

SHM disconnect limit (SHMDSCLMT)

Specifies the number of consecutive nonproductive responses that are required from the remote station before the connection can be suspended for this X.21 short hold mode connection. This parameter is used only if *YES is specified for the Short hold mode (SHM) parameter, and *NEG or *SEC is specified for the Data link role (ROLE) parameter.

10

10 consecutive nonproductive responses must be received before the connection can be suspended.

*NOMAX

There is no disconnect limit.

SHM-disconnect-limit

Specify a number from 1 to 254, indicating the number of consecutive nonproductive responses that must be received before the connection can be suspended.

SHM disconnect timer (SHMDSCTMR)

Specifies, in tenths of a second, the minimum length of time that the primary system maintains the connection to the remote system for this X.21 short hold mode controller. This parameter is valid only if *YES is specified for the Short hold mode (SHM) parameter, and *NEG or *SEC is specified for the Data link role (ROLE) parameter.

50

The primary maintains the connection to the remote system for a minimum of 5 seconds.

SHM-disconnect-timer

Specify a value from 2 to 3000 in 0.1 second intervals.

Station address (STNADR)

Specifies the station address used when communicating with the controller.

Valid values range from 00 to FE.

Note: 00 can be specified only for APPC controllers when *TDLC is specified for the Link type (LINKTYPE) parameter.

Note: If *SEC is specified on the ROLE parameter, this is the station address of the remote controller. If *PRI or *NEG is specified on the ROLE parameter, this is the local station address.

LAN remote adapter address (ADPTADR)

Specifies the 12-character adapter address of the remote controller. This is the address to which the system sends data when it communicates with the remote controller. This value can be obtained from the remote controller's configuration record. Valid values range from hex 000000000001 through hex FFFFFFFFFFFF.

adapter-address

Specify the adapter address of the remote controller.

LAN DSAP (DSAP)

Specifies the destination service access point (DSAP). This is the logical address this system will send to when it communicates with the remote controller. This address allows the controller to properly route the data that comes from this system. The default value for the destination service access point is 04.

The value must match the value specified on the source service access point (SSAP) parameter in the remote controller's configuration record.

Note: The *OPC controller uses the value above for this field. The combination of RMTSYSNAME and DSAP defines a unique controller. This allows multiple controllers to exist between two systems.

04

The destination service access point is the default 04.

destination-service-access-point

Specify a hexadecimal value ranging from 04 through 9C, in increments of 4 (for example, 04, 08, 0C, 10) to represent the destination service access point.

LAN SSAP (SSAP)

Specifies the source service access point (SSAP). This is the logical address the local system uses when it sends data to the remote controller. This address allows the controller to properly route the data that comes from the local system. The default value for the source service access point is 04.

It must match the value assigned to the destination service access point (DSAP) in the remote controller's configuration record.

04

The system uses the logical address of 04.

source-service-access-point

Specify a hexadecimal value ranging from 04 through 9C, in increments of 4 (for example, 04, 08, 0C, 10) to represent the source service access point.

X.25 network level (NETLVL)

Specifies the level of the X.25 network used to access this controller. The level is specified by giving the year of the standard used by the X.25 network.

Note: Use of the lower value of the remote DTE or the network level is suggested; for example, if the remote DTE is using the CCITT standard of 1980 and the network 1984, specify 1980 for this parameter.

1980

The 1980 Standard is used.

1984

The 1984 Standard is used.

1988

The 1988 Standard is used.

X.25 link level protocol (LINKPCL)

Specifies the link level protocol used on the X.25 network to communicate with this controller.

*QLLC

The Qualified Logical Link Control (QLLC) protocol is used.

*ELLC

The Enhanced Logical Link Control (ELLC) protocol is used.

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.25 connection password (CNNPWD)

Specifies the X.25 network password used for password exchange with the X.24 Call Request and Incoming Call packets (Call User Data field). This parameter is not valid for permanent virtual circuit (PVC) connections.

If you want to use a connection password that consists of characters whose hexadecimal value is less than 40, you must specify the password as a hexadecimal value. When less than 8 bytes are specified, the end of the password field is padded with blanks. A password of all blank is valid. All incoming call requests must match this password to establish a connection.

To specify a hexadecimal password, the digits must be specified in multiples of two, be no more than 16 digits long, be enclosed in apostrophes, and be preceded by an X. For example, X'0102030405' is a valid hexadecimal password.

Note: This connection password is highly recommended for controllers that operate with the Enhanced Logical Link Control (ELLC) protocol LINKPCL(*ELLC) on switched virtual circuit (SVC) connections. This enhanced protocol supports reconnection of virtual circuits after network errors which disconnect the line with a clear signal; however, this reconnection is not allowed to proceed without the password validation procedure being used as a unique identifier for the controller.

X.25-connection-password

Specify the connection password. The password for each controller can consist of any alphanumeric characters represented by the hexadecimal values ranging from 40 through FF.

APPN CP session support (CPSSN)

Specifies whether this controller supports sessions between control points.

*YES

This controller supports sessions between control points.

*NO

This controller does not support sessions between control points.

Remote APPN node type (NODETYPE)

Specifies the type of APPN node which this controller represents.

*ENDNODE

This node is an end node in an APPN network.

*LENNODE

This node is a low-entry networking node in an APPN network.

*NETNODE

This node is a network node in an APPN network.

*CALC

The system determines the type of node this controller represents.

Branch extender role (BEXROLE)

Specifies the role of the local system in an APPN network for the remote controller being configured. This parameter is only used when the local system has enabled the branch extender function via the NODETYPE parameter in the network attributes being set to *BEXNODE.

*NETNODE

The local system takes the role of a network node for the remote controller.

*ENDNODE

The local system takes the role of an end node for the remote controller.

APPN/HPR capable (HPR)

Specifies whether the local system can use APPN high-performance routing (HPR) when communicating with this controller. The controller description must specify APPN(*YES) to enable HPR. If HPR(*YES) is specified, the value of the MAXFRAME parameter of the line specified by the switched line list must be greater than or equal to 768, otherwise HPR will not be enabled over this connection.

*YES

The local system can use HPR, and HPR flows can proceed over the link defined by this controller.

*NO

The local system cannot use HPR, and HPR flows cannot proceed over the link defined by this controller.

HPR path switching (HPRPTHSWT)

Specifies whether an attempt is made to switch paths of HPR connections associated with this controller at the time the controller is varied off. If a path switch is not attempted or if there are no other available paths, jobs associated with the HPR connections will be ended.

See the APPN information in the Networking category in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/ for more information.

*NO

When this controller is varied off path switching will not be done for HPR connections associated with this controller. Jobs associated with HPR connections will be ended.

*YES

When this controller is varied off an attempt to switch paths of HPR connections associated with this controller will be made.

APPN transmission group number (TMSGRPNBR)

Specifies the transmission group number for this controller.

1

The default transmission group is one.

*CALC

The system specifies the value for the transmission group number.

transmission-group-number

Specify a value from 1 to 20 for the transmission group number.

APPN minimum switched status (MINSWTSTS)

Specifies the minimum status of the switched connection so that APPN will consider it as a controller that is available for routing.

*VRYONPND

APPN will consider the controller available for routing if the status is vary on pending, varied on, or active.

*VRYON

APPN will consider the controller available for routing only if the status is varied on or active.

Autocreate device (AUTOCRTDEV)

Specifies whether device descriptions can be automatically created for this controller description.

Note: This parameter does not apply to the automatic creation of APPC devices. This parameter only applies to dependent devices on this controller.

*ALL

All dependent devices than can be automatically created for this controller, except APPC devices, are automatically created.

*NONE

Dependent devices on this controller are not automatically created.

Autodelete device (AUTODLTDEV)

Specifies the number of minutes an automatically created device can remain in an idle state (when there are no active conversations on that device). When the time expires, the system automatically varies off and deletes the device description.

31680

The system will automatically vary off and delete the automatically-configured idle device descriptions after 31680 minutes (22 days).

*NO

The system will not automatically vary off and delete the automatically-configured idle device descriptions.

1-31680
Specify the number of minutes to wait before deleting the automatically-configured idle device descriptions for this controller. Valid values range from 1 to 31680 minutes (22 days).

User-defined 1 (USRDFN)

This field is used to describe unique characteristics of the line that you want to control. This parameter is valid only if advanced peer-to-peer networking (APPN) is used on the system.

*LIND

The user-defined value specified in the line description is used.

user-defined

Specify a value ranging from 0 through 255.

User-defined 2 (USRDFN)

This field is used to describe unique characteristics of the line that you want to control. This parameter is valid only if advanced peer-to-peer networking (APPN) is used on the system.

*LIND

The user-defined value specified in the line description is used.

user-defined

Specify a value ranging from 0 through 255.

User-defined 3 (USRDFN)

This field is used to describe unique characteristics of the line that you want to control. This parameter is valid only if advanced peer-to-peer networking (APPN) is used on the system.

*LIND

The user-defined value specified in the line description is used.

user-defined

Specify a value ranging from 0 through 255.

Model controller description (MDLCTL)

Indicates whether or not this controller is a 'Model' for automatically created controller descriptions. Values on the model description, such as timer delays, retry limits, and frame size, are used for new controller descriptions that are automatically created and configured when communications with a remote system is started. The new controller must be attached to one of the SINGLE line descriptions in the switched line list (SWTLINLST parameter) of the model controller.

A model controller description is not attached to any devices, and only one controller description can be varied on for each line description.

For more information on model controllers, see the APPN information in the Networking category in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/.

Note: This parameter is only valid if the parameter LINKTYPE is *LAN.

*NO

This controller is not a model controller.

*YES

This controller is a model controller.

Connection network ID (CNNNETID)

Specifies the connection network identifier of this controller description. If a value is specified for this parameter (other than none), this controller description represents this connection to the connection network.

*NETATR

The LCLNETID value specified in the system network attributes is used.

*NONE

There is no connection network identifier.

connection-network-netid

Specify the connection network identifier that represents this controller description to the network.

Connection network CP (CNNCPNAME)

Specifies the name of the connection network control point.

A connection network is defined to allow controller descriptions to be automatically created for incoming or outgoing connections. This parameter is valid only if MDLCTL(*YES) is specified; it is required if CNNNETID is specified.

connection-control-point-name

Specify the connection control point name.

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.

Up to 254 devices can be attached to this controller.

Character code (CODE)

Specifies whether the extended binary-coded decimal interchange code (*EBCDIC) or the American National Standard Code for Information Interchange (*ASCII) character code is used on the line.

*EBCDIC

The extended binary-coded decimal interchange code (EBCDIC) character code is used.

*ASCII
The ASCII character code is used.

SSCP identifier (SSCPID)

Specifies the system service control point identifier of the host system.

system-service-control-point-identifier

Specify the system service control point identifier as a 12-digit hexadecimal value.

Note: This parameter is no longer supported. It exists solely for compatibility with releases earlier than Version 5 Release 3 Modification 0 of operating system.

IDLC window size (IDLCWDWSIZ)

Specifies the window size for transmission to and reception controllers attached to the IDLC line.

*LIND

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

window-size

Specify the window size. Valid values range from 1 through 31.

Note: This parameter is no longer supported. It exists solely for compatibility with releases earlier than Version 5 Release 3 Modification 0 of operating system.

IDLC frame retry (IDLCFRMRTY)

Specifies the maximum number of attempts to transmit a frame before reporting an error.

*LIND

The number of attempts specified in the line description is used.

IDLC-frame-retry

Specify a number of attempts. Valid values range from 0 through 100.

Note: This parameter is no longer supported. It exists solely for compatibility with releases earlier than Version 5 Release 3 Modification 0 of operating system.

IDLC response timer (IDLCRSPTMR)

Specifies the amount of time, in tenths of a second, to wait before retransmitting a frame if acknowledgement has not been received.

*LIND

The time specified in the line description is used.

IDLC-response-timer

Specify an amount of time. Valid values range from 10 through 100 tenths of a second. For example, 100 tenths of a second equals 10 seconds.

Note: This parameter is no longer supported. It exists solely for compatibility with releases earlier than Version 5 Release 3 Modification 0 of operating system.

IDLC connect retry (IDLCCNNRTY)

Specifies the number of times to attempt retransmission at connection time.

*LIND

The number of attempts specified in the line description is used.

*NOMAX
Indicates to continue until a successful transmission has been made.
connect-retry

Specify a number of attempts. Valid values range from 1 through 100.

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 *YES is specified on either the SWITCHED or SNBU parameter, and LINKTYPE(*SDLC) and SHM(*NO) are both specified.

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 *YES is specified on either the SWITCHED or SNBU parameter, and LINKTYPE(*SDLC) and SHM(*NO) are both specified.

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 *YES is specified on either the SWITCHED or SNBU parameter, and LINKTYPE(*SDLC) and SHM(*NO) are both specified.

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.

Disconnect timer (DSCTMR)

Specifies options for controlling the time (in seconds) before a connection without activity is dropped, or the amount of time to delay the automatic disconnection. If the user does not want the line to drop, specify *NO for the SWTDSC parameter.

Element 1: Minimum Connect Timer

170

A connection is dropped when it has been inactive for 170 seconds.

disconnect-timer

Specify a time to wait before disconnecting. Valid values range from 0 through 65535 seconds.

Element 2: Disconnect Delay Timer

30

The disconnection is delayed for 30 seconds.

disconnect-delay-timer

Specify a value to delay link take down after the last session on the controller is stopped. Valid values range from 0 through 65535 seconds.

SDLC poll priority (POLLPTY)

Specifies whether this controller has priority when polled. This parameter can be specified only if SHM is *NO.

*NO

This controller does not have polling priority.

*YES

This controller does have polling priority.

SDLC poll limit (POLLLMT)

Specifies, for an SDLC secondary or negotiable controller, the number of consecutive polls issued to the same controller when the poll results in receiving frames. This parameter can be specified only if SHM is *NO.

0

The default number of polls is zero.

poll limit

Specify a number of polls. Valid values range from 0 through 4.

SDLC out limit (OUTLMT)

Specifies the number of consecutive times SDLC allows the transmission of the maximum number of frames to a station, before allowing transmission to another station.

*POLLLMT

The value is the same as the one specified for the SDLC poll limit (POLLLMT) parameter.

out-limit

Specify a value ranging from 0 through 4.

SDLC connect poll retry (CNNPOLLRTY)

Specifies the number of times to retry connecting to a controller before reporting an error.

*CALC

The number of retries is 7 if the controller is switched, and *NOMAX if the controller is nonswitched.

*NOMAX

The system will retry indefinitely.

connect-poll-retry

Specify a value ranging from 0 to 65534 for the number of retries.

SDLC NDM poll timer (NDMPOLLTMR)

Specifies the minimum interval at which a secondary station should be polled if a poll from the primary to the secondary (which is in normal disconnect mode (NDM)) does not result in receiving the appropriate response.

This parameter is valid only if the link type is *SDLC and the controller role is secondary or negotiable and *NO is specified on the SHM parameter.

*CALC

The poll interval is calculated by the system.

NDM-poll-timer

Specify a value ranging from 1 to 3000 units. Each unit represents 0.1 second. To indicate no timer, specify 0.

LAN frame retry (LANFRMRTY)

Specifies the number of times to retry a transmission when there is no acknowledgment from the remote controller in the time period specified by the LANRSPTMR parameter. This value is only used after a successful connection has been made.

*CALC

The system determines the timer value.

LAN-frame-retry

Specify a value ranging from 0 through 254 for the number of times a frame is transmitted before an acknowledgement is received.

LAN connection retry (LANCNNRTY)

Specifies the number of times a transmission is attempted before an acknowledgement is received. This value is used at connection time (unlike LANFRMRTY which is used after a connection has been made).

*CALC

The system determines the timer value.

LAN-connection-retry

Specify a value ranging from 0 through 254 for the number of times the transmission is attempted before an acknowledgement is received.

LAN response timer (LANRSPTMR)

Specifies the time period used to determine an inoperative condition on the link when connected.

*CALC

The system determines the timer value.

LAN-response-timer

Specify a value from 1 to 254 units. Each unit represents 0.1 second. To indicate no timer, specify 0.

LAN connection timer (LANCNNTMR)

Specifies the time period used to determine an inoperative condition on the link at connection time.

*CALC

The system determines the timer value.

LAN-connection-timer

Specify a value ranging from 1 through 254 in 0.1-second intervals for the amount of time the system waits before an inoperative condition occurs. To indicate no timer, specify 0.

LAN acknowledgement timer (LANACKTMR)

Specifies the time interval to delay sending acknowledgements for received frames.

*CALC

The system determines the timer value.

LAN-acknowledgement-timer

Specify a value ranging from 1 to 254 units. Each unit represents 0.1 second. To indicate no timer, specify 0. If 0 is specified for the LAN acknowledgement frequency (LANACKFRQ) parameter, 0 must also be specified for this parameter. If a non-zero number is specified for the LANACKFRQ parameter, a non-zero number must also be specified for this parameter.

LAN inactivity timer (LANINACTMR)

Specifies the time period used to determine an inactive condition for the controller.

*CALC

The system determines the timer value.

LAN-inactivity-timer

Specify a value ranging from 1 through 255 in 0.1-second intervals for the length of time used to determine an inactive condition for the controller. To indicate no timer, specify 0.

LAN acknowledgement frequency (LANACKFRQ)

Specifies the maximum number of frames received before sending an acknowledgement to the controller.

*CALC

The system determines the LAN acknowledgement frequency value.

LAN-acknowledge-frequency

Specify a value from 0 to 127 for the number of frames received. If 0 is specified for the LAN acknowledgement timer (LANACKTMR) parameter, 0 must also be specified for this parameter. If a non-zero number is specified for the LANACKTMR parameter, a non-zero number must also be specified for this parameter.

LAN max outstanding frames (LANMAXOUT)

Specifies the maximum number of frames that can be sent before an acknowledgement is received from the remote system.

*CALC

The system determines the LAN maximum outstanding frames value.

LAN-maximum-outstanding-frames

Specify a value ranging from 1 through 127 for the number of frames that can be sent before an acknowledgement is received.

LAN access priority (LANACCPTY)

Specifies the priority used for accessing the remote controller. The larger the number the higher the priority for this controller. This parameter is only used when the controller attaches to TRLAN.

*CALC

The system determines the LAN access priority value.

LAN-access-priority

Specify a value from 0 to 3 for the access priority for this controller on a local area network (LAN).

LAN window step (LANWDWSTP)

Specifies whether to reduce to 1 the maximum number of frames outstanding to the remote system during network congestion. This parameter (LAN Window Step) indicates the number of frames that must be successfully received by the remote system before the number of maximum outstanding frames can be increased by 1. The increase continues this way until the maximum number of outstanding frames reaches the value specified by the LAN maximum outstanding frames (LANMAXOUT) parameter.

*NONE

The number of outstanding frames is not reduced during network congestion.

LAN-window-step

Specify a value from 1 to 127 for the number of frames that must be successfully received by the remote system before the maximum number of outstanding frames can be increased by 1.

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.

X.25 frame retry (X25FRMRTY)

Specifies the maximum number of times a frame is sent after the response timer ends when connected to this controller. The value for this parameter depends on the quality of service provided by the network and the connection to that network; that is, the frequency of lost link protocol data units.

7

The default for the maximum number of transmissions is 7.

X.25 frame retry

Specify a value ranging from 0 through 21 for the number of times a frame is sent.

X.25 connection retry (X25CNNRTY)

Specifies the maximum number of times that a logical link control (LLC) protocol data unit is sent after the connect response timer expires when connecting to this controller.

7

The default for the maximum number of transmissions is 7.

X.25 connection retry

Specify a value ranging from 0 through 21 for the number times a frame is sent.

X.25 response timer (X25RSPTMR)

Specifies the time period allowed to return an acknowledgement when an LLC protocol data unit is sent while connected to this controller.

300

The time allowed to return an acknowledgment is 30 seconds.

X.25 response-timer

Specify an amount of time in tenths of a second. Valid values range from 1 through 2550 in 0.1-second intervals.

X.25 connection timer (X25CNNTMR)

Specifies the time period allowed to return an acknowledgement when an LLC protocol data unit is sent while connecting to this controller.

300

The default amount of time is 30 seconds.

connection-timer

Specify an amount of time in tenths of a second. Valid values range from 1 through 2550 in 0.1 second intervals.

X.25 delayed connection timer (X25DLYTMR)

Specifies the time interval between attempts to establish a connection to the controller.

*CALC

Use the values specified for the X.25 connection timer (X25CNNTMR) parameter and the X.25 connection retry (X25CNNRTY) parameter to determine how often and how many times to try establishing the connection.

X.25-delay-timer

Specify a value ranging from 1 to 32767 units. Each unit represents 0.1 second. Connection attempts are repeated indefinitely at this time interval.

X.25 acknowledgement timer (X25ACKTMR)

Specifies the amount of time to delay sending acknowledgements for received frames.

20

The time allowed to delay sending an acknowledgment is 2 seconds.

X.25-acknowledgment-timer

Valid values range from 1 to 2550 in 0.1 second intervals, or 0 to indicate no delay.

X.25 inactivity timer (X25INACTMR)

Specifies the time period used to determine an inactive condition for the controller. Valid values range from 1 to 2550 in 0.1 second intervals.

1050

The time period used to determine an inactive condition for the controller is 10.5 seconds.

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.

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

Example 1: Creating an APPC controller with link type *SDLC 

CRTCTLAPPC   CTLD(OUTLAND)  LINKTYPE(*SDLC)
             APPN(*NO)  LINE(OUTLINE)
             RMTNETID(*NONE)  STNADR(C1)

This command configures an APPC controller description attached to a nonswitched SDLC line with a station address of C1.

Example 2: Creating an APPC controller with link type *HRPIP 

CRTCTLAPPC  CTLD(GRIFFIN) LINKTYPE(*HPRIP)
            RMTINTNETA('9.5.5.1') RMTCPNAME(CJP)

This command configures an APPC controller description named GRIFFIN with a link type of *HPRIP, a remote internet address of 9.5.5.1 and a remote control point of CJP.

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.