Change Ctl Desc (SNA Host) (CHGCTLHOST)

The Change Controller Description (SNA Host) (CHGCTLHOST) command changes a controller description for a Systems Network Architecture (SNA) Host controller.

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

Parameters

Controller description (CTLD)

This is a required parameter.

Specifies the name of the controller description.

Online at IPL (ONLINE)

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

*SAME

This value does not change.

*YES

The controller is automatically varied on at IPL.

*NO

The controller is not automatically varied on at IPL.

Activate swt network backup (ACTSNBU)

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.

*SAME

This value does not change.

*NO

The SNBU feature is not used.

*YES

The SNBU feature is activated. You must also specify a value of *YES for the Activate swt network backup (ACTSNBU) parameter for the line.

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.

*SAME

This value does not change.

*YES

This controller is for APPN.

*NO

This controller is not for APPN.

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.

*SAME

This value does not change.

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.

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.

*SAME

This value does not change.

*EBCDIC

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

*ASCII

The ASCII character code is used.

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.

*SAME

This value does not change.

*LINKTYPE

The following values are used for the various types:

• *FR - 1590
• *IDLC - 2048
• *LAN - 16393
• *SDLC - 521
• *X25 - 1024

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:

• 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.
• For *HPRIP, specify a value equal to or larger than 768.

Remote network identifier (RMTNETID)

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

*SAME

This value does not change.

*NETATR

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

*NONE

No remote network identifier (ID) is used.

*ANY

Calls are accepted from any X.25 network address.

remote-network-identifier

Specify the remote network identifier.

Remote control point (RMTCPNAME)

Specifies the control point name of the remote system.

*SAME

This value does not change.

*NONE

Specifies no remote control point name is used.

*ANY

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

remote-control-point-name

Specify the remote control point NAME.

Adjacent link station (ADJLNKSTN)

Specifies the NAME of the adjacent link station. This name is used by the operating system to identify which switched controller description on the IBM System i5 is used to establish a link to a host system. The adjacent link station name for the IBM System i5 must match the name provided by the host system during link activation.

*SAME

This value does not change.

*NONE

No adjacent link station NAME is specified.

*ANY

The system determines which adjacent link station is used.

adjacent-link-station-name

Specify the adjacent link station name.

SSCP identifier (SSCPID)

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

*SAME

This value does not change.

*NONE

No system service control point identifier is specified.

system-service-control-point-identifier

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

Initial connection (INLCNN)

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

*SAME

This value does not change.

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

*SAME

This value does not change.

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

*SAME

This value does not change.

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

*SAME

This value does not change.

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

*SAME

This value does not change.

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.

*SAME

This value does not change.

entry-name

Specify an entry name.

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.

*SAME

This value does not change.

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

*SAME

This value does not change.

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

*SAME

This value does not change.

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

*SAME

This value does not change.

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

*SAME

This value does not change.

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.

*SAME

This value does not change.

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.

*SAME

This value does not change.

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.

*SAME

This value does not change.

*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

*SAME

This value does not change.

disconnect-timer

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

Element 2: Disconnect Delay Timer

*SAME

This value does not change.

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.

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.

*SAME

This value does not change.

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.

*SAME

This value does not change.

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.

*SAME

This value does not change.

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.

*SAME

This value does not change.

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.

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.

*SAME

This value does not change.

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

*SAME

This value does not change.

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

*SAME

This value does not change.

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

*SAME

This value does not change.

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

*SAME

This value does not change.

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

*SAME

This value does not change.

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

*SAME

This value does not change.

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

*SAME

This value does not change.

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

*SAME

This value does not change.

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

*SAME

This value does not change.

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

*SAME

This value does not change.

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.

*SAME

This value does not change.

*QLLC

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

*ELLC

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

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.

*SAME

This value does not change.

*NONE

No connection password is used.

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.

X.25 switched line selection (SWTLINSLCT)

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

*SAME

This value does not change.

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

The possible transmission values are:

*SAME

This value does not change.

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

The possible reception values are:

*SAME

This value does not change.

*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

*SAME

This value does not change.

*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

*SAME

This value does not change.

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

*SAME

This value does not change.

*NONE

A value is not specified for the user group identifier.

X.25 reverse charging (RVSCRG)

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

*SAME

This value does not change.

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

*SAME

This value does not change.

X.25 frame retry

Specify a value ranging from 0 through 21 for the number of 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.

*SAME

This value does not change.

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 acknowledgement timer (X25ACKTMR)

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

*SAME

This value does not change.

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.

*SAME

This value does not change.

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.

*NONE

A value is not specified for the user facilities.

*SAME

This value does not change.

APPN CP session support (CPSSN)

Specifies whether this controller supports sessions between control points.

*SAME

This value does not change.

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

*SAME

This value does not change.

*ENDNODE

This node is an end node in an APPN network.

*NETNODE

This node is a network node in an APPN network.

*LENNODE

This node is a low-entry networking 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.

*SAME

This value does not change.

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

*SAME

This value does not change.

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

*SAME

This value does not change.

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

*SAME

This value does not change.

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

*SAME

This value does not change.

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

*SAME

This value does not change.

*ALL

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

*DEVINIT

Only session printer and display devices started by the SNA host controller (device-initiated) 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.

*SAME

This value does not change.

*NO

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

wait-time

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.

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.

*SAME

This value does not change.

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

*SAME

This value does not change.

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

*SAME

This value does not change.

*LIND

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

user-defined

Specify a value ranging from 0 through 255.

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

*SAME

This value does not change.

*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

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.

*SAME

This value does not change.

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

Recontact on vary off (RECONTACT)

Specifies whether a request for re-contact is sent to the host system when a normal vary off of the controller description is done.

Note: This parameter is valid only for X.25 and SDLC leased lines (if *X.25 or *SDLC is specified on the LINKTYPE parameter and *NO is specified on the SWITCHED parameter).

*SAME

This value does not change.

*YES

A request for re-contact to the remote system is sent.

*NO

A request for re-contact to the remote system is not sent. When this value is specified, a status of inactive is shown for the remote system.

Text 'description' (TEXT)

Specifies the text that briefly describes the object.

*SAME

This value does not change.

*BLANK

No text is specified.

character-value

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

Primary DLUS name (PRIDLUS)

Specifies the primary Dependent LU Server (DLUS) NAME and network identifier.

The name is in the format of XXXXXXXX YYYYYYYY the prefix being the CP name and the suffix being the network identifier of the APPN network (subnet) that the remote DLUS resides in. If the DLUS is in the same network as the IBM System i5, then the user only needs to define the CP name; the default network identifier that is used is the local network identifier specified in the network attributes.

The network qualified CP name of the remote DLUS system services control point (SSCP) with which the DLUR host controller prefers to communicate. If this parameter is filled in and the DLUR controller is configured as Initial Connection *DIAL, the IBM System i5 sends an activation request to this DLUS first.

The default is *NONE, but if Initial Connection is *DIAL INLCNN(*DIAL), then this parameter becomes a required parameter.

Element 1: Primary DLUS name

*SAME

This value does not change.

*NONE

No primary CP name is given.

primary-DLUS-name

Specify the name of the primary Dependent LU Server.

Element 2: Network ID

*SAME

This value does not change.

*NETATR

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

network-ID

Specify the network identifier of the Dependent LU Server.

Backup DLUS name (BKUDLUS)

Specifies the backup Dependent LU Server (DLUS) name and network identifier.

The name is in the format of XXXXXXXX YYYYYYYY the prefix being the CP name and the suffix being the network identifier of the APPN network (subnet) that the remote DLUS resides in. If the DLUS is in the same network as the IBM System i5, then the user only needs to define the CP name; the default network identifier that is used is the local network identifier specified in the network attributes.

The network qualified CP name of the remote DLUS system services control point (SSCP) with which the DLUR host controller prefers to communicate. If this parameter is filled in and the DLUR controller is configured as Initial Connection *DIAL, the IBM System i5 sends an activation request to this DLUS first.

The default is *NONE, but if Initial Connection is *DIAL INLCNN(*DIAL), then this parameter becomes a required parameter.

Element 1: Backup DLUS Name

*SAME

This value does not change.

*NONE

No backup CP name is given.

backup-DLUS-name

Specify the NAME of the backup Dependent LU Server.

Element 2: Network ID

*SAME

This value does not change.

*NETATR

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

network-ID

Specify the network identifier of the backup Dependent LU Server.

30-2550 (seconds) (ACTTMR)

This timer is used when system attempts to activate a session to the remote DLUS node (initial connection *DIAL). It is the amount of time the system will wait for an answer from the remote DLUS.

This parameter is used in conjunction with recovery limits (CMNRCYLMT) count limit and timer interval. For each attempt (up to count limit), an activation request (timed by the activation timer) is requested. Between attempts, the system waits for the timer interval before a new activation is attempted (assuming the system times out before receiving a retry error message).

The three parameters on the attempts to the primary DLUS are used and, once the count limit is exceeded, the system resets and tries the same retry limit count to the backup DLUS (if configured). Once the retry limit count is exhausted to all configured DLUS nodes, an error message is issued to the QSYSOPR message log with options to retry the whole activation sequence again.

*SAME

This value does not change.

activation-timer-value

Specify, in seconds, a value ranging from 30 through 2550.

Dsc/reconnect timer (T309) (RECNNTMR)

This timer is used when a session outage occurs to the remote DLUS node. It is the amount of time the host system DLUR support waits for the DLUS node to send an activation request back to the host system. Once the timer expires, host system does the following:

• If the DLUR host controller is configured to INLCNN(*DIAL):
  1. The DLUR support makes a one time attempt to activate a session to the DLUS node the system was connected to at the time of session outage.
  2. If that attempt fails, an error message is displayed in the QSYSOPR message log with retry option. If retry is taken, then the activation request is sent through the configured primary/backup DLUS again.
• If the DLUR host controller is configured to INLCNN(*ANS):
  1. The DLUR controller waits for an activation attempt from any DLUS node.

*SAME

This value does not change.

reconnect-timer-value

Specify, in seconds, a value ranging from 30 through 2550.

Examples

CHGCTLHOST   CTLD(BOSTON)  SSCPID(050000000011)

This command changes the host controller named BOSTON to have 050000000011 as its SSCPID.

Error messages

*ESCAPE Messages

CPF2652

Controller description &1 not changed.