CHGCTLHOST (Change Controller Description (SNA Host)) Command Description

CHGCTLHOST Command syntax diagram

 

Purpose

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

 

Required Parameters

CTLD

Specifies the name of the controller description being changed.

 

Optional Parameters

ONLINE

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

*SAME: The value does not change.

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

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

ACTSNBU

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

*SAME: The value does not change.

*NO: The switched network backup (SNBU) feature is not activated.

*YES: The switched network backup feature (SNBU) is activated. To start the feature when the nonswitched connection is broken, specify ACTSNBU(*YES) on the line description command.

APPN

Specifies whether the local system uses advanced peer-to-peer networking (APPN) functions when communicating with this controller. If APPN functions are used, specify a remote control point name and a remote network identifier.

*SAME: The value does not change.

*YES: The local system uses APPN functions.

*NO: The local system does not use APPN functions.

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.

Note:

The same line name can be used more than once.

*SAME: The value does not change.

switched-line-name: Specify the name of a line for which a line description already exists. The maximum number of lines that can be connected to this controller is 64.

CODE

Specifies the character code used. The code can be either extended binary-coded decimal interchange code (*EBCDIC) or the American National Standard Code for Information Interchange (*ASCII).

*SAME: The value does not change.

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

*ASCII: The ASCII character set code is used.

MAXFRAME

Specifies the maximum frame (path information unit (PIU)) size that the controller can send or receive. This value is used to calculate 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: The value does not change.

*LINKTYPE: The following values are used when *LINKTYPE is specified:

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

maximum-frame: Specify the maximum 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 shown below.

Table 1. Valid Frame Sizes (in bytes)

Link Type	Frame Size (in bytes)
*FR	265 - 8182
*LAN	265 - 16393 (265 - 4444 for DDI LANs)
*IDLC	265 - 8196
*SDLC	265, 521, 1033, 2057
*X25	256, 265, 512, 521, 1024, 1033, 2048, 4096

RMTNETID

Specifies the identifier (ID) of the remote network.

*SAME: The value does not change.

*NETATR: The RMTNETID 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-ID: Specify the remote network ID.

RMTCPNAME

Specifies the name of the remote control point.

*SAME: The value does not change.

*NONE: No remote control point name is used.

*ANY: The system determines the name of the remote control point to use.

remote-control-point-name: Specify the remote control point name.

ADJLNKSTN

Specifies the name of the adjacent link station. This name is used by the system to identify which switched controller description on the iSeries 400 is used to establish a link to a host S/370 system. The adjacent link station name for the iSeries 400 must match the name provided by the host system during link activation.

*SAME: The 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.

SSCPID

Specifies the system service control point (SSCP) of the host system.

*SAME: The value does not change.

*NONE: No SSCP identifier is specified.

system-service-control-point-identifier: The SSCP identifier is a 12-digit hexadecimal value, with the first 2 digits being hexadecimal 05.

INLCNN

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

*SAME: The value does not change.

*ANS: The connection is made by the local system answering an incoming call from this controller.

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

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

DIALINIT

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

*SAME: The 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 immediately upon vary on of the controller description. For all other link types, the default is to defer the dial.

*IMMED: The dial connection is initiated immediately upon vary on of the controller description.

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

CNNNBR

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

*SAME: The value does not change.

*DC: For X.21 circuit switched connections, a direct call is used to connect to the controller.

*ANY: Calls are accepted from any network address.

connection-number: Specify the connection number used to call this controller.

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

ANSNBR

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

*SAME: The value does not change.

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

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

CNNLSTOUT

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

*SAME: The value does not change.

connection-list: Specify the name of a connection list object.

CNNLSTOUTE

Specifies, for IDLC switched connections, the entry name from the connection list that is used to make a call to the Public Switched Data Network. The connection list must be specified on the CNNLSTOUT parameter.

*SAME: The value does not change.

connection-list-entry: Specify an entry name.

IDLCWDWSIZ

Specifies the window size used by the line description.

*SAME: The value does not change.

*LIND: The window size specified in the line description is used.

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

IDLCFRMRTY

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

*SAME: The value does not change.

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

IDLC-frame-retry: Specify the number of attempts. Valid values range from 0 through 100.

IDLCRSPTMR

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

*SAME: The value does not change.

*LIND: The time specified in the line description is used.

IDLC-response-timer: Specify the amount of time to wait. Valid values range from 10 through 100 tenths of a second. For example, 10 seconds equals 100 tenths of a second.

IDCCNNRTY

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

*SAME: The value does not change.

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

*NOMAX: There is no disconnect limit.

IDLC-connect-retry: Specify the number of attempts. Valid values range from 1 through 100.

PREDIALDLY

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

*SAME: The value does not change.

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

REDIALDLY

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

*SAME: The value does not change.

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

DIALRTY

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

*SAME: The value does not change.

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

SWTDSC

Specifies whether the switched connection to this controller is disconnected when the last device in the host controller description becomes inactive.

*SAME: The value does not change.

*YES: The switched connection is disconnected when the last device is varied off.

*NO: This connection remains active even if the above conditions were met, or if the host system is configured to disconnect the switched connection.

Switched disconnect is valid only if *YES is specified for the SWITCHED parameter, for the SNBU parameter, or if the LINKTYPE is *LAN.

Note:

The DISCNT parameter of the GROUP macro instruction in the Network Control Program/Virtual Telecommunications Access Method (NCP/VTAM) definition may be used if the host system is to determine the disconnect characteristics.

DSCTMR

Specifies options for controlling the time (in seconds) before an inactive connection is dropped (Element 1), or the amount of time to delay the automatic disconnection (Element 2).

Note:

The DISCNT parameter of the GROUP macro instruction in the NCP/VTAM definition may be used if the host system is to determine the disconnect characteristics.

Element 1: Minimum Connect Timer

*SAME: The 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: The value does not change.

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

STNADR

Specifies the station address used when communicating with the controller.

Note:

This is the station address of the local system.

*SAME: The value does not change.

station-address: Specify the station address as a hexadecimal value ranging from 01 through FE.

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: The value does not change.

adapter-address: Specify the adapter address of the remote controller.

DSAP

Specifies the logical address of the SNA destination service access point (DSAP) to which this system sends data when it communicates with the remote controller. This address allows the controller and the system to route the data that comes from this system. The value must match the value specified on the source service access point (SSAP) parameter in the remote controller's configuration record.

*SAME: The 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.

SSAP

Specifies the source service access point. This is the logical address this system uses when it sends data to the remote controller. This address allows the remote controller and the system to route the data that comes from this system. It must match the value assigned to the destination service access point (DSAP) prompt in the remote controller's configuration record.

*SAME: The 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.

LANFRMRTY

Specifies the number of times a frame is transmitted if there is no acknowledgement 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: The value does not change.

*CALC: The system calculates the value based on the type of line that is linked to the controller.

LAN-frame-retry: Specify a value ranging from 0 through 254 for the number of times a frame is transmitted before and acknowledgement is received.

LANCNNRTY

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

*SAME: The value does not change.

*CALC: The system calculates the value based on the type of line that is linked to the controller.

LAN-connection-retry: Specify a value ranging from 0 through 254 for the number of times the transmission is attempted before and acknowledgement is received.

LANRSPTMR

Specifies the length of time the system waits before an inoperative condition occurs on a link after a connection is made.

*SAME: The value does not change.

*CALC: The system calculates the value based on the type of line that is linked to the controller.

LAN-response-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.

LANCNNTMR

Specifies the length of time the system waits before an inoperative condition occurs on a link at connection time.

*SAME: The value does not change.

*CALC: The system calculates the value based on the type of line that is linked to the controller.

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.

LANACKTMR

Specifies the length of time the system waits before sending an acknowledgement for received frames.

*SAME: The value does not change.

*CALC: The system calculates the value based on the type of line that is linked to the controller.

LAN-acknowledgement-timer: Specify a value ranging from 1 through 254 in 0.1-second intervals, or specify 0 to indicate no delay. If 0 is specified for this parameter, 0 must also be specified for the LANACKFRQ parameter; if a non zero value is specified for this parameter, a non zero value must also be specified for the LANACKFRQ parameter.

LANINACTMR

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

*SAME: The value does not change.

*CALC: The system calculates the value based on the type of line that is linked to the controller.

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.

LANACKFRQ

Specifies the maximum number of frames that are received before an acknowledgement is sent to the controller.

*SAME: The value does not change.

*CALC: The system calculates the value based on the type of line that is linked to the controller.

LAN-acknowledgement-frequency: Specify a value ranging from 0 through 127 for the number of frames received. If 0 is specified for this parameter, 0 must also be specified for the LANACKTMR parameter; if a non zero value is specified for this parameter, a non zero value must also be specified for the LANACKTMR parameter.

LANMAXOUT

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

*SAME: The value does not change.

*CALC: The system calculates the value based on the type of line that is linked to the controller.

LAN-maximum-outstanding-frames: Specify a value ranging from 1 through 127 for the number of frames that can be sent before and acknowledgement is received.

LANACCPTY

Specifies the priority granted to the sending system for sending frames. The larger the number, the higher the priority. This parameter is valid only when the controller is attached to an Ethernet line.

*SAME: The value does not change.

*CALC: The system calculates the value based on the type of line that is linked to the controller.

LAN-access-priority: Specify a value ranging from 0 through 3 to indicate how soon a frame may be sent on a local area network.

LANWDWSTP

Specifies whether to reduce the number of outstanding frames that may be sent before an acknowledgement is received from the remote system during network congestion. This parameter (LAN Window Step) also indicates the number of frames that must be successfully received before the number of outstanding frames can be increased to the maximum allowable value.

*SAME: The value does not change.

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

LAN-number-of-frames: Specify the number of outstanding frames to be reduced before an acknowledgement is received from the remote system.

NETLVL

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

*SAME: The value does not change.

1980: The 1980 standard is used.

1984: The 1984 standard is used.

1988: The 1988 standard is used.

LINKPCL

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

*SAME: The value does not change.

*QLLC: The QLLC protocol is used.

*ELLC: The ELLC protocol is used.

CNNPWD

Specifies, for X.25 switched virtual circuit (SVC) controllers, the password used when connecting to this controller.

*SAME: The value does not change.

*NONE: No password is used.

X.25-connection-password: Specify the connection password. This password for each controller can consist of any alphanumeric characters represented by the hexadecimal range from 40 through FF.

SWTLINSLCT

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

*SAME: The value does not change.

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

*CALC: The system determines the value to use.

DFTPKTSIZE

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

Element 1: Transmit Packet Size

*SAME: The value does not change.

*LIND: The value specified in the line description is used as the default packet size.

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

*SAME: The value does not change.

*LIND: The value specified in the line description is used as the default packet size.

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

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

DFTWDWSIZE

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

Element 1: Transmit Window Size

*SAME: The value does not change.

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

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

Element 2: Receive Window Size

*SAME: The 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.

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

USRGRPID

Specifies the closed user-group ID for contacting this X.25 switched virtual circuit (SVC) controller. Specify a value ranging from 0 through 99, as provided by the network subscription. This parameter is not valid for permanent virtual circuit (PVC) connections. It is valid only for SVC circuit outgoing call operations and is ignored for SVC incoming call connections.

*SAME: The value does not change.

*NONE: No user group ID is specified.

X.25-user-group-ID: Specify a value, ranging from 0 through 99, as provided by the network subscription.

RVSCRG

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

*SAME: The 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.

X25FRMRTY

Specifies the maximum number of times a frame is sent after the response timer ends when connected to this controller.

*SAME: The 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.

X25RSPTMR

Specifies the time allowed to return an acknowledgement when a frame is sent while connected to this controller.

*SAME: The value does not change.

X.25-response-timer: Specify a value ranging from 1 through 2550 in 0.1-second intervals.

X25ACKTMR

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

*SAME: The value does not change.

X.25-acknowledgement-timer: Specify a value ranging from 1 through 2550 in 0.1-second intervals.

X25INACTMR

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

*SAME: The value does not change.

X.25-inactivity-timer: Specify a value ranging from 1 through 2550 in 0.1-second intervals, or specify 0 to indicate no timer.

USRFCL

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

*SAME: The value does not change.

*NONE: No additional services are needed.

user-facilities: Specify a string of hexadecimal digits sent to the network to request additional services. The iSeries 400 allows up to 218 hexadecimal characters.

CPSSN

Specifies whether this advanced peer-to-peer networking (APPN) controller supports control-point to control-point (CP to CP) sessions.

*SAME: The value does not change.

*YES: This controller supports CP to CP sessions.

*NO: This controller does not support CP to CP sessions.

NODETYPE

Specifies the type of APPN node this controller represents.

*SAME: The value does not change.

*CALC: The iSeries 400 determines the type of node this controller represents.

*NETNODE: This node is a network node in an APPN network.

*ENDNODE: This node is an end node in an APPN network.

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

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: The 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.

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. See APPC, APPN, and HPR topic in the Information Center for more information on HPR.

*SAME: The 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.

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 APPC, APPN, and HPR topic in the Information Center for more information.

*SAME: The 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.

TMSGRPNBR

Specifies the APPN transmission group number for this controller.

*SAME: The value does not change.

*CALC: The system determines the value to use.

APPN-transmission-group-number: Specify a value ranging from 1 through 20 for the transmission group number for this controller.

MINSWTSTS

Specifies, for the switched connection, the minimum status that APPN requires for a controller to be considered available for routing.

*SAME: The 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: Indicates that APPN will consider the controller available for routing only if the status is varied on or active.

AUTOCRTDEV

Specifies which devices are automatically created.

*SAME: The value does not change.

*ALL: All devices that 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: No devices are automatically created.

AUTODLTDEV

Specifies the number of minutes an automatically created device can remain idle when the last session is unbound before the device description is varied off and deleted.

*SAME: The value does not change.

1440: The system will automatically vary off and delete the automatically-configured idle device descriptions after 1440 minutes (24 hours).

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

USRDFN1

Specifies the first of the three user-defined fields. This field is used to describe unique characteristics of the line that is controlled. This parameter is valid only if APPN* support is used on the system.

*SAME: The value does not change.

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

user-defined-1: Specify a value ranging from 0 through 255.

USRDFN2

Specifies the second of the three user-defined fields. This field is used to describe unique characteristics of the line that is controlled. This parameter is valid only if APPN* support is used on the system.

*SAME: The value does not change.

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

user-defined-2: Specify a value ranging from 0 through 255.

USRDFN3

Specifies the third of the three user-defined fields. This field is used to describe unique characteristics of the line that is controlled. This parameter is valid only if APPN is used on the system.

*SAME: The value does not change.

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

user-defined-3: Specify a value ranging from 0 through 255.

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.

*SAME: The value does not change.

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

Element 1: Maximum Recovery Limit

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.

PRIDLUS

Specifies the primary Dependent LU Server (DLUS) name and network ID.

The name is in the format XXXXXXXX YYYYYYYY where X is the CP name and Y is the network ID of the APPN network (subnet) that the remote DLUS resides in. The end user can define only the CP name of a DLUS residing in the same network as the iSeries 400. The default is the local network ID specified in the network attributes.

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

*SAME: The value does not change.

*NONE: There is no primary dependent LU server.

Element 1: Primary DLUS name

primary-DLUS-name: Specify the name of the primary dependent LU server.

Element 2: Network ID

*NETATR: The network ID from the local network attributes is used.

Network-ID: Specify the network ID of the dependent LU server.

BKUDLUS

Specifies the backup dependent LU server (DLUS) name and network ID.

The name is in the format of XXXXXXXX YYYYYYYY where X is the control point (CP) name and Y is the network ID of the APPN network (subnet) that the remote DLUS resides in. The end user can define only the CP name of a DLUS residing in the same network as the iSeries 400. The default is the local network ID specified in the network attributes.

The network-qualified CP name of the remote DLUS system services control point (SSCP) and the iSeries 400 dependent LU requestor (DLUR) host controller will communicate with the absence of the primary DLUS node. If this parameter is filled in and the iSeries 400 DLUR controller is configured as INLCNN(*DIAL), the iSeries 400 sends an activation request to this DLUS only after trying the primary DLUS first.

*SAME: The value does not change.

*NONE: There is no backup dependent LU server.

Element 1: Backup DLUS name

backup-DLUS-name: Specify the name of the backup dependent LU server.

Element 2: Network ID

*NETATR: The network ID from the local network attributes is used.

network-ID: Specify the network ID of the backup dependent LU server.

ACTTMR

This timer is used when the iSeries 400 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 count and timer interval. For each count, 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 hearing back or 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: The value does not change.

170: The activate time of 170 seconds is used.

activation-timer: Specify, in seconds, a value ranging from 30 through 2550.

RECNNTMR

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

If the iSeries 400 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 iSeries 400 DLUR host controller is configured to INLCNN(*ANS):

1. The DLUR controller waits for an activation attempt from any DLUS node.

*SAME: The value does not change.

170: The default value of 170 is used.

reconnect-timer: Specify, in seconds, a value ranging from 1 through 2550.

RECONTACT

Specifies whether to send a recontact request to a remote system when the system is varied off.

Note:

This parameter is only valid for X.25 and SDLC leased lines (if LINKTYPE is *X25 or *SDLC and SWITCHED is *NO).

*SAME: The value does not change.

*YES: A request for recontact with the remote system is sent. If this value is specified, a status of pending is shown for the remote system.

*NO: A request for recontact with the remote system is not sent. If this value is specified, a status of inactive is shown for the remote system.

MSGQ

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

Single Values

*SAME: The value does not change.

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

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

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

TEXT

Specifies the text that briefly describes the program and its function. More information is in Commonly used parameters.

*SAME: The value does not change.

*BLANK: Text is not specified.

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

Example for CHGCTLHOST

CHGCTLHOST  CTLD(BOSTON)
  SSCPID(050000000011)

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

Error messages for CHGCTLHOST

*ESCAPE Messages

CPF2652

Controller description &1 not changed.