| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Change Controller Description (APPC) (CHGCTLAPPC) command changes a controller description for an advanced program-to-program communications (APPC) controller.
If the controller was created with LINKTYPE(*LOCAL), the following restrictions apply:
More information is in the Communications Configuration book, SC41-5401 book.
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| CTLD | Controller description | Name | Required, Key, Positional 1 |
| ONLINE | Online at IPL | *SAME, *YES, *NO | Optional |
| ACTSNBU | Activate swt network backup | *SAME, *YES, *NO | Optional |
| APPN | APPN-capable | *SAME, *YES, *NO | Optional |
| RMTINTNETA | Remote internet address | Character value, *SAME | Optional |
| LCLINTNETA | Local internet address | Character value, *SYS, *SAME | Optional |
| LDLCTMR | LDLC timers | Element list | Optional |
| Element 1: LDLC retry count | 0-255, *SAME | ||
| Element 2: LDLC retry timer | 0-65535, *SAME | ||
| Element 3: LDLC liveness timer | 0-65535, *SAME | ||
| LDLCLNKSPD | LDLC link speed | 1200-603979776000, *SAME, *CAMPUS, *WAN, 4M, 10M, 16M, 100M, *MIN, *MAX | Optional |
| LDLCTMSGRP | LDLC transmission group | Element list | Optional |
| Element 1: Cost/connect time | 0-255, *SAME | ||
| Element 2: Cost/byte | 0-255, *SAME | ||
| Element 3: Security | *SAME, *NONSECURE, *PKTSWTNET, *UNDGRDCBL, *SECURECND, *GUARDCND, *ENCRYPTED, *MAX | ||
| Element 4: Propagation delay | *SAME, *LAN, *MIN, *TELEPHONE, *PKTSWTNET, *SATELLITE, *MAX | ||
| SWTLINLST | Switched line list | Single values: *SAME Other values (up to 64 repetitions): Name |
Optional |
| CODE | Character code | *SAME, *EBCDIC, *ASCII | Optional |
| MAXFRAME | Maximum frame size | 265-16393, 256, 265, 512, 521, 1024, 1033, 1994, 2048, 2057, 4060, 4096, 8156, 16393, *SAME, *LINKTYPE | Optional |
| RMTNETID | Remote network identifier | Communications name, *SAME, *NETATR, *NONE, *ANY | Optional |
| RMTCPNAME | Remote control point | Communications name, *SAME, *NONE, *ANY | Optional |
| RMTSYSNAME | Remote system name | Character value, *SAME | Optional |
| SSCPID | SSCP identifier | Character value, *SAME, *NONE | Optional |
| INLCNN | Initial connection | *SAME, *ANS, *DIAL | Optional |
| DIALINIT | Dial initiation | *SAME, *LINKTYPE, *IMMED, *DELAY | Optional |
| CNNNBR | Connection number | Character value, *SAME, *DC, *ANY | Optional |
| ANSNBR | Answer number | *SAME, *CNNNBR, *ANY | Optional |
| CNNLSTOUT | Outgoing connection list | Name, *SAME | Optional |
| CNNLSTOUTE | Connection list entry | Name, *SAME | Optional |
| IDLCWDWSIZ | IDLC window size | 1-31, *SAME, *LIND | Optional |
| IDLCFRMRTY | IDLC frame retry | 0-100, *SAME, *LIND | Optional |
| IDLCRSPTMR | IDLC response timer | 10-100, *SAME, *LIND | Optional |
| IDLCCNNRTY | IDLC connect retry | 1-100, *SAME, *LIND, *NOMAX | Optional |
| PREDIALDLY | Predial delay | 0-254, *SAME | Optional |
| REDIALDLY | Redial delay | 0-254, *SAME | Optional |
| DIALRTY | Dial retry | 0-254, *SAME | Optional |
| SWTDSC | Switched disconnect | *SAME, *YES, *NO | Optional |
| DSCTMR | Disconnect timer | Single values: *SAME Other values: Element list |
Optional |
| Element 1: Minimum connect timer | 0-65535 | ||
| Element 2: Disconnection delay timer | 0-65535, *SAME | ||
| SHMDSCLMT | SHM disconnect limit | 1-254, *SAME, *NOMAX | Optional |
| SHMDSCTMR | SHM disconnect timer | 2-3000, *SAME | Optional |
| STNADR | Station address | 00-FE, *SAME | Optional |
| POLLPTY | SDLC poll priority | *SAME, *YES, *NO | Optional |
| POLLLMT | SDLC poll limit | 0-4, *SAME | Optional |
| OUTLMT | SDLC out limit | *SAME, *POLLLMT, 0, 1, 2, 3, 4 | Optional |
| CNNPOLLRTY | SDLC connect poll retry | 0-65534, *SAME, *CALC, *NOMAX | Optional |
| NDMPOLLTMR | SDLC NDM poll timer | 0-3000, *SAME, *CALC | Optional |
| ADPTADR | LAN remote adapter address | 000000000001-FFFFFFFFFFFF, *SAME | Optional |
| DSAP | LAN DSAP | *SAME, 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 | *SAME, 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 |
| LANFRMRTY | LAN frame retry | 0-254, *SAME, *CALC | Optional |
| LANCNNRTY | LAN connection retry | 0-254, *SAME, *CALC | Optional |
| LANRSPTMR | LAN response timer | 0-254, *SAME, *CALC | Optional |
| LANCNNTMR | LAN connection timer | 0-254, *SAME, *CALC | Optional |
| LANACKTMR | LAN acknowledgement timer | 0-254, *SAME, *CALC | Optional |
| LANINACTMR | LAN inactivity timer | 0-255, *SAME, *CALC | Optional |
| LANACKFRQ | LAN acknowledgement frequency | 0-127, *SAME, *CALC | Optional |
| LANMAXOUT | LAN max outstanding frames | 1-127, *SAME, *CALC | Optional |
| LANACCPTY | LAN access priority | 0-3, *SAME, *CALC | Optional |
| LANWDWSTP | LAN window step | 1-127, *NONE, *SAME | Optional |
| NETLVL | X.25 network level | *SAME, 1980, 1984, 1988 | Optional |
| LINKPCL | X.25 link level protocol | Character value, *SAME, *QLLC, *ELLC, *LLC2 | Optional |
| CNNPWD | X.25 connection password | Character value, *SAME, *NONE | Optional |
| SWTLINSLCT | X.25 switched line selection | *FIRST, *CALC, *SAME | Optional |
| DFTPKTSIZE | X.25 default packet size | Element list | Optional |
| Element 1: Transmit value | *SAME, *LIND, 64, 128, 256, 512, 1024, 2048, 4096 | ||
| Element 2: Receive value | *SAME, *LIND, *TRANSMIT, 64, 128, 256, 512, 1024, 2048, 4096 | ||
| DFTWDWSIZE | X.25 default window size | Element list | Optional |
| Element 1: Transmit value | 1-15, *SAME, *LIND | ||
| Element 2: Receive value | 1-15, *SAME, *LIND, *TRANSMIT | ||
| USRGRPID | X.25 user group identifier | Character value, *SAME, *NONE | Optional |
| RVSCRG | X.25 reverse charging | *SAME, *NONE, *REQUEST, *ACCEPT, *BOTH | Optional |
| X25FRMRTY | X.25 frame retry | 0-21, *SAME | Optional |
| X25CNNRTY | X.25 connection retry | 0-21, *SAME | Optional |
| X25RSPTMR | X.25 response timer | 1-2550, *SAME | Optional |
| X25CNNTMR | X.25 connection timer | 1-2550, *SAME | Optional |
| X25DLYTMR | X.25 delayed connection timer | 1-32767, *SAME, *CALC | Optional |
| X25ACKTMR | X.25 acknowledgement timer | 0-2550, *SAME | Optional |
| X25INACTMR | X.25 inactivity timer | 1-2550, *SAME | Optional |
| USRFCL | User facilities | Character value, *SAME, *NONE | Optional |
| CPSSN | APPN CP session support | *SAME, *YES, *NO | Optional |
| NODETYPE | Remote APPN node type | *SAME, *CALC, *NETNODE, *ENDNODE, *LENNODE | Optional |
| BEXROLE | Branch extender role | *SAME, *NETNODE, *ENDNODE | Optional |
| HPR | APPN/HPR capable | *SAME, *YES, *NO | Optional |
| HPRPTHSWT | HPR path switching | *SAME, *NO, *YES | Optional |
| TMSGRPNBR | APPN transmission group number | 1-20, *SAME, *CALC | Optional |
| MINSWTSTS | APPN minimum switched status | *SAME, *VRYONPND, *VRYON | Optional |
| AUTOCRTDEV | Autocreate device | *SAME, *ALL, *NONE | Optional |
| AUTODLTDEV | Autodelete device | 1-10000, *NO, *SAME | Optional |
| USRDFN1 | User-defined 1 | 0-255, *LIND, *SAME | Optional |
| USRDFN2 | User-defined 2 | 0-255, *LIND, *SAME | Optional |
| USRDFN3 | User-defined 3 | 0-255, *LIND, *SAME | Optional |
| CMNRCYLMT | Recovery limits | Single values: *SAME, *SYSVAL Other values: Element list |
Optional |
| Element 1: Count limit | 0-99 | ||
| Element 2: Time interval | 0-120 | ||
| MSGQ | Message queue | Single values: *SAME, *SYSVAL, *SYSOPR Other values: Qualified object name |
Optional |
| Qualifier 1: Message queue | Name | ||
| Qualifier 2: Library | Name | ||
| MDLCTL | Model controller description | *SAME, *YES, *NO | Optional |
| CNNNETID | Connection network ID | Communications name, *SAME, *NETATR, *NONE | Optional |
| CNNCPNAME | Connection network CP | Communications name, *SAME, *NONE | Optional |
| CTLOWN | Control owner | *SAME, *USER | Optional |
| TEXT | Text 'description' | Character value, *SAME, *BLANK | Optional |
| Top |
This is a required parameter.
Specifies the name of the controller description.
| Top |
Specifies whether this object is automatically varied on at initial program load (IPL).
This value does not change.
The controller is automatically varied on at IPL.
The controller is not automatically varied on at IPL.
| Top |
Specifies, for modems that support the switched network backup (SNBU) feature and that are not IBM 386x, 586x, or 786x models, whether the SNBU feature is activated or deactivated. The local modem and remote modem must both support the SNBU to activate it. IBM 386x, 586x, and 786x models are activated with a hardware switch only. This feature lets you bypass a broken nonswitched connection (nonswitched line) by establishing a switched connection.
This value does not change.
The SNBU feature is not used.
The SNBU feature is activated. You must also specify a value of *YES for the Activate swt network backup (ACTSNBU) parameter for the line.
| Top |
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.
This value does not change.
This controller is for APPN.
This controller is not for APPN.
| Top |
Specifies the remote internet address to which the controller will respond.
This value does not change.
The 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 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. If the internet address is entered from the command line, the address must be enclosed in apostrophes.
| Top |
Specifies the TCP/IP interface to be used to communicate with the remote system.
This value does not change.
The system will select the local internet address to use.
The 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 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. If the internet address is entered from the command line, the address must be enclosed in apostrophes.
The alias name is the same value that is specified on the ADDTCPIFC and CHGTCPIFC commands (ALIASNAME parameter).
| Top |
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
Element 1: LDLC retry count
Element 2: LDLC retry timer
Element 3: LDLC liveness timer
| Top |
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
This value does not change.
Specifies a set of default APPN link characteristics for a campus environment be used.
Specifies a set of default APPN link characteristics for a wide-area network environment be used.
The link speed is 4 million bits per second.
The link speed is 10 million bits per second.
The link speed is 16 million bits per second.
The link speed is 100 million bits per second.
A link speed of less than 1200 bits per second is used.
A link speed greater than 100 million bits per second is used.
Specify the LDLC link speed. Specify a value from 1200 to 603979776000 bits per second.
| Top |
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
Element 1: Cost/connect time
Cost per connect time specifies the relative cost of being connected over the link.
Element 2: Cost/byte
Cost per byte specifies the relative cost of sending and receiving data over the link.
Element 3: Security
Security specifies the security over the link.
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.
| Top |
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.
This value does not change.
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.
| Top |
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.
This value does not change.
The extended binary-coded decimal interchange code (EBCDIC) character code is used.
| Top |
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.
This value does not change.
The following values are used for the various types: *LAN - 16393, *SDLC - 521, *TDLC - 4105, *IDLC - 2048, *X25 - 1024, *FR - 1590, or *HPRIP - 1461.
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: For *FR, specify a value from 265 through 8182. For *IDLC, specify a value ranging from 265 through 8196. For *LAN, specify a value from 265 through 16393 (265 through 4444 for DDI LANs). For *SDLC, specify 265, 521, 1033, or 2057. For *X25, specify 256, 265, 512, 521, 1024, 1033, 2048, or 4096.
Note: The numeric values listed for *LINKTYPE are valid only if TYPE(*BLANK) is specified when the controller is created.
| Top |
Specifies the NAME of the remote network in which the adjacent control point resides.
This value does not change.
The LCLNETID value specified in the system network attributes is used.
Calls are accepted from any X.25 network address.
Specify the remote network identifier.
| Top |
Specifies the control point name of the remote system.
This value does not change.
Specifies no remote control point name is used.
The system determines the name of the remote control point used.
Specify the remote control point NAME.
| Top |
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.
This value does not change.
| Top |
Specifies the system service control point identifier of the host system.
This value does not change.
No system service control point identifier is specified.
Specify the system service control point identifier as a 12-digit hexadecimal value.
| Top |
Specifies the method used to establish a connection with this controller.
This value does not change.
The system initiates outgoing calls and answers incoming calls.
The connection is made by the iSeries system 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.
| Top |
Specifies the method used to make the initial dial on a switched line between the system and the remote controller.
This value does not change.
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.
The dial connection is initiated as soon as the controller description is varied on.
The dial connection is delayed until a job is initiated that requests the use of the remote controller resources.
| Top |
Specifies the telephone number to dial to connect to this controller.
This value does not change.
Direct call is being used in an X.21 circuit switched network.
Specify the connection number.
| Top |
Specifies the X.25 network address from which calls are accepted.
This value does not change.
Calls from the X.25 network address specified on the CNNNBR parameter are accepted.
Calls are accepted from any X.25 network address.
| Top |
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.
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.
This value does not change.
Specify the name of a connection list object.
| Top |
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.
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.
This value does not change.
Specify an entry name.
| Top |
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.
Specifies the window size for transmission to and reception controllers attached to the IDLC line.
This value does not change.
The value specified in the line description is used as the default window size.
Specify the window size. Valid values range from 1 through 31.
| Top |
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.
Specifies the maximum number of attempts to transmit a frame before reporting an error.
This value does not change.
The number of attempts specified in the line description is used.
Specify a number of attempts. Valid values range from 0 through 100.
| Top |
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.
Specifies the amount of time, in tenths of a second, to wait before retransmitting a frame if acknowledgement has not been received.
This value does not change.
The time specified in the line description is used.
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.
| Top |
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.
Specifies the number of times to attempt retransmission at connection time.
This value does not change.
The number of attempts specified in the line description is used.
Specify a number of attempts. Valid values range from 1 through 100.
| Top |
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.
This value does not change.
| Top |
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.
This value does not change.
| Top |
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.
This value does not change.
| Top |
Specifies whether the switched connection to this controller is dropped when the last device is varied off.
This value does not change.
The switched connection is not dropped when the last device is varied off.
The switched connection is varied off when the last device is varied off.
| Top |
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
This value does not change.
Specify a time to wait before disconnecting. Valid values range from 0 through 65535 seconds.
Element 2: Disconnect Delay Timer
This value does not change.
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.
Note: For objects migrated from V2R1M1 or previous systems, the disconnect delay timer has a value of zero. This value is interpreted by the system as 30 seconds.
| Top |
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.
This value does not change.
There is no 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.
| Top |
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.
This value does not change.
Specify a value from 2 to 3000 in 0.1 second intervals.
| Top |
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.
This value does not change.
| Top |
Specifies whether this controller has priority when polled. This parameter can be specified only if SHM is *NO.
This value does not change.
This controller does not have polling priority.
This controller does have polling priority.
| Top |
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.
This value does not change.
The default number of polls is zero.
Specify a number of polls. Valid values range from 0 through 4.
| Top |
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.
This value does not change.
The value is the same as the one specified for the SDLC poll limit (POLLLMT) parameter.
Specify a value ranging from 0 through 4.
| Top |
Specifies the number of times to retry connecting to a controller before reporting an error.
This value does not change.
The number of retries is 7 if the controller is switched, and *NOMAX if the controller is nonswitched.
The system will retry indefinitely.
Specify a value ranging from 0 to 65534 for the number of retries.
| Top |
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.
This value does not change.
The poll interval is calculated by the system.
Specify a value ranging from 1 to 3000 units. Each unit represents 0.1 second. To indicate no timer, specify 0.
| Top |
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.
This value does not change.
Specify the adapter address of the remote controller.
| Top |
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.
This value does not change.
Specify a hexidecimal value ranging from 04 through 9C, in increments of 4 (for example, 04, 08, 0C, 10) to represent the destination service access point.
| Top |
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.
This value does not change.
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.
| Top |
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.
This value does not change.
The system determines the LAN frame retry value based on the type of line that is lined to the controller.
Specify a value ranging from 0 through 254 for the number of times a frame is transmitted before an acknowledgement is received.
| Top |
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).
This value does not change.
The system determines the LAN connection retry value.
Specify a value ranging from 0 through 254 for the number of times the transmission is attempted before an acknowledgement is received.
| Top |
Specifies the time period used to determine an inoperative condition on the link when connected.
This value does not change.
The system determines the LAN response timer value.
Specify a value from 1 to 254 units. Each unit represents 0.1 second. To indicate no timer, specify 0.
| Top |
Specifies the time period used to determine an inoperative condition on the link at connection time.
This value does not change.
The system determines the LAN connection timer value.
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.
| Top |
Specifies the time interval to delay sending acknowledgements for received frames.
This value does not change.
The system determines the LAN acknowledgement timer value.
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.
| Top |
Specifies the time period used to determine an inactive condition for the controller.
This value does not change.
The system determines the LAN inactivity timer value.
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.
| Top |
Specifies the maximum number of frames received before sending an acknowledgement to the controller.
This value does not change.
The system determines the LAN acknowledgement frequency value.
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.
| Top |
Specifies the maximum number of frames that can be sent before an acknowledgement is received from the remote system.
This value does not change.
The system determines the LAN maximum outstanding frames value.
Specify a value ranging from 1 through 127 for the number of frames that can be sent before an acknowledgement is received.
| Top |
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.
This value does not change.
The system determines the LAN access priority value.
Specify a value from 0 to 3 for the access priority for this controller on a local area network (LAN).
| Top |
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.
This value does not change.
The number of outstanding frames is not reduced during network congestion.
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.
| Top |
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.
This value does not change.
The 1980 Standard is used.
The 1984 Standard is used.
The 1988 Standard is used.
| Top |
Specifies the link level protocol used on the X.25 network to communicate with this controller.
This value does not change.
The Qualified Logical Link Control (QLLC) protocol is used.
The Enhanced Logical Link Control (ELLC) protocol is used.
| Top |
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.
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.
This value does not change.
. No connection password is used.
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.
| Top |
Specifies the method that is used to select lines from an X.25 switched line list.
This value does not change.
Lines are selected beginning with the first line in the switched line list.
The system determines which line in the switched line list will be selected.
| Top |
Specifies the default packet size used by the X.25 network for transmission and reception.
The possible transmission values are:
This value does not change.
The value specified in the line description is the default value.
Specify a default packet size for transmission. The valid values for the packet size are 64, 128, 256, 512, 1024, 2048, and 4096.
The possible reception values are:
This value does not change.
The value specified as the default packet size for transmission is used as the default for reception.
Specify a default packet size for reception. The valid values for the packet size are 64, 128, 256, 512, 1024, 2048, and 4096.
| Top |
Specifies the default window size for transmission and reception.
Element 1: Transmit Window Size
This value does not change.
The value specified in the line description is used as the default 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
This value does not change.
The value specified in the line description is used as the default window size.
The value specified as the default window size for transmission is used as the default for reception.
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.
| Top |
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.
This value does not change.
A value is not specified for the user group identifier.
| Top |
Specifies whether reverse charges are accepted or requested when contacting this controller.
This value does not change.
No reverse charging for network tariff billing is accepted.
Charges are requested on outgoing call request packets.
Reverse charging for network tariff billing is accepted on incoming requests.
Both incoming and outgoing requests are accepted.
| Top |
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.
This value does not change.
Specify a value ranging from 0 through 21 for the number of times a frame is sent.
| Top |
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.
This value does not change.
Specify a value ranging from 0 through 21 for the number times a frame is sent.
| Top |
Specifies the time period allowed to return an acknowledgement when an LLC protocol data unit is sent while connected to this controller.
This value does not change.
Specify an amount of time in tenths of a second. Valid values range from 1 through 2550 in 0.1-second intervals.
| Top |
Specifies the time period allowed to return an acknowledgement when an LLC protocol data unit is sent while connecting to this controller.
This value does not change.
Specify an amount of time in tenths of a second. Valid values range from 1 through 2550 in 0.1 second intervals.
| Top |
Specifies the time interval between attempts to establish a connection to the controller.
This value does not change.
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.
Specify a value ranging from 1 to 32767 units. Each unit represents 0.1 second. Connection attempts are repeated indefinitely at this time interval.
| Top |
Specifies the amount of time to delay sending acknowledgements for received frames.
This value does not change.
Valid values range from 1 to 2550 in 0.1 second intervals, or 0 to indicate no delay.
| Top |
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.
This value does not change.
| Top |
Specifies a string of hexadecimal characters sent to the X.25 network to request additional services. The system allows up to 218 hexadecimal characters.
A value is not specified for the user facilities.
This value does not change.
| Top |
Specifies whether this controller supports sessions between control points.
This value does not change.
This controller supports sessions between control points.
This controller does not support sessions between control points.
| Top |
Specifies the type of APPN node which this controller represents.
This value does not change.
This node is an end node in an APPN network.
This node is a network node in an APPN network.
This node is a low-entry networking node in an APPN network.
The system determines the type of node this controller represents.
| Top |
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.
This value does not change.
The local system takes the role of a network node for the remote controller.
The local system takes the role of an end node for the remote controller.
| Top |
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.
This value does not change.
The local system can use HPR, and HPR flows can proceed over the link defined by this controller.
The local system cannot use HPR, and HPR flows cannot proceed over the link defined by this controller.
| Top |
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 Support information in the iSeries Information Center at http://www.iseries.ibm.com/infocenter for more information.
This value does not change.
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.
When this controller is varied off an attempt to switch paths of HPR connections associated with this controller will be made.
| Top |
Specifies the transmission group number for this controller.
This value does not change.
The system specifies the value for the transmission group number.
Specify a value from 1 to 20 for the transmission group number.
| Top |
Specifies the minimum status of the switched connection so that APPN will consider it as a controller that is available for routing.
This value does not change.
APPN will consider the controller available for routing if the status is vary on pending, varied on, or active.
APPN will consider the controller available for routing only if the status is varied on or active.
| Top |
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.
This value does not change.
All dependent devices than can be automatically created for this controller, except APPC devices, are automatically created.
Dependent devices on this controller are not automatically created.
| Top |
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.
This value does not change.
The system will not automatically vary off and delete the automatically-configured idle device descriptions.
Specify the number of minutes to wait before deleting the automatically-configured idle device descriptions for this controller. Valid values range from 1 to 10,000.
| Top |
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.
This value does not change.
The user-defined value specified in the line description is used.
Specify a value ranging from 0 through 255.
| Top |
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.
This value does not change.
The user-defined value specified in the line description is used.
Specify a value ranging from 0 through 255.
| Top |
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.
This value does not change.
The user-defined value specified in the line description is used.
Specify a value ranging from 0 through 255.
| Top |
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
This value does not change.
Specify the number of second-level recovery attempts to be made. Valid values range from 0 through 99.
Element 2: Recovery 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.
| Top |
Specifies the message queue to which operational messages are sent.
This value does not change.
Qualifier 1: Message queue
Qualifier 2: Library
| Top |
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 Support information in the iSeries Information Center at http://www.iseries.ibm.com/infocenter.
Note: This parameter is only valid if the parameter LINKTYPE is *LAN.
This value does not change.
This controller is not a model controller.
This controller is a model controller.
| Top |
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.
Note: The LCLNETID value specified in the system network attributes is used.
This value does not change.
The LCLNETID value specified in the system network attributes is used.
There is no connection network identifier.
Specify the connection network identifier that represents this controller description to the network.
| Top |
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.
This value does not change.
No connection network control point name is specified.
Specify the connection control point name.
| Top |
Specifies whether the user is allowed to change the controller description. If the user is the current owner, ownership cannot be transferred back to the system.
This value does not change.
The user can make changes to the controller description.
| Top |
Specifies the text that briefly describes the object.
This value does not change.
No text is specified.
Specify no more than 50 characters of text, enclosed in apostrophes.
| Top |
Example 1: Changing APPC Controller CHICAGO Configuration
CHGCTLAPPC CTLD(CHICAGO) ONLINE(*YES)
TEXT('Controller in Chicago')
This command changes the APPC controller named CHICAGO to be varied on at IPL and a new text description is specified.
Example 2: Changing the APPC Controller CJG Configuration
CHGCTLAPPC CTLD(CJG) LCLINTNETA('9.5.5.1')
LDLCLNKSPD(*WAN)
This command changes the APPC controller named CJG to local internet address 9.5.5.1 and LDLC (Logical Data Link Control) link speed to *WAN.
| Top |
| Top |